Praca w zespole

Kilku modelarzy może jednocześnie pracować na tej samej wersji modułu. Platforma chroni ich przed nadpisywaniem sobie nawzajem pracy jedną prostą zasadą: element może mieć w danej chwili tylko jeden draft. Nie ma scalania ani rozwiązywania konfliktów, bo konflikty po prostu nie mogą wystąpić.

Jeden element, jeden edytujący

• Gdy zaczynasz edytować element, trzymasz jego draft, dopóki go nie zatwierdzisz (commit) albo nie odrzucisz (discard).
• W tym czasie inni modelarze widzą na elemencie pomarańczowy znacznik U, z podpowiedzią Element is currently edited by ….
• Nadal mogą otworzyć element, ale widzą jego ostatnią zatwierdzoną wersję, tylko do odczytu. Twoja praca w toku jest dla nich niewidoczna.
• Każdy może swobodnie edytować dowolny element, którego nikt inny nie edytuje.
• Etykiety w słowniku etykiet są blokowane pojedynczo, więc kilku modelarzy może pracować w tym samym słowniku.

Znaczniki w drzewie Module elements:

Znacznik	Znaczenie
M (czerwony)	Masz draft tego elementu.
U (pomarańczowy)	Inny użytkownik ma draft tego elementu.
R (szary)	Tylko do odczytu: element jest zaimportowany z innego modułu albo nie możesz edytować tego modułu.

Powiadomienia

Inni modelarze pracujący w tym samym module dostają powiadomienia, gdy:

• zaczynasz edytować element („User … started editing the element: …”);
• zatwierdzasz go („User … finished editing the element: …”);
• tworzysz, zmieniasz nazwę, przenosisz albo usuwasz element lub folder albo przywracasz elementy z kosza. Te zmiany omijają drafty, więc działają od razu.

Gdy właściciel draftu zatwierdzi zmiany, U znika, a otwarty na tym elemencie edytor przeładowuje się z nową wersją.

Kto może edytować

Aby zmieniać moduł, użytkownik potrzebuje:

• roli Modeler writer na platformie oraz
• roli Writer w tym module.

Wszyscy pozostali widzą moduł tylko do odczytu, ze znacznikiem R i podpowiedzią This module is read-only. Zaimportowane elementy są zawsze tylko do odczytu: należą do swojego modułu źródłowego.

Zwalnianie zapomnianego draftu

Jeśli modelarz wyjdzie, zostawiając otwarty draft, nikt inny nie może edytować tego elementu. Administrator może go zwolnić w Administration Panel, w sekcji Locked model elements dla danego modułu. Lista pokazuje każdy element z otwartym draftem i osobę, która go trzyma (Locked by). Dostępne są dwie akcje:

• Discard element changes: wyrzuca draft. Element wraca do swojej zatwierdzonej wersji.
• Transfer changes: przekazuje draft innemu użytkownikowi, który może go dokończyć i zatwierdzić.

Obie akcje są zapisywane w dzienniku audytu.

Historia zmian

Każdy commit jest zapisywany w historii zmian modułu. Aby ją otworzyć, przejdź do menedżera Modules i kliknij View model change history przy wersji modułu. Okno Model history changes pokazuje dla każdego commita:

• datę;
• użytkownika;
• opis commita;
• zmienione elementy i rodzaj każdej zmiany.

Możesz filtrować po opisie, użytkowniku albo elemencie. Historia to zapis tego, co się wydarzyło: nie pokazuje różnic (diff) i nie pozwala przywrócić wcześniejszej wersji.

Dobre nawyki w zespole

• Zatwierdzaj często małe, kompletne zmiany. Draft, który trzymasz, to element, którego nikt inny nie może zmienić.
• Pisz sensowne opisy commitów. To je twoi koledzy z zespołu zobaczą w historii zmian.
• Uzgadniaj zmiany struktury. Zmiany nazw, przeniesienia i usunięcia działają od razu dla wszystkich.
• Odrzuć albo zatwierdź zmiany, zanim wyjdziesz. Inaczej administrator będzie musiał zwolnić twoje drafty.

Podsumowanie

• Element ma w danej chwili jeden draft, więc nie ma czego scalać.
• U pokazuje, kto edytuje. Wszyscy pozostali widzą wersję zatwierdzoną.
• Powiadomienia informują o rozpoczętych i zakończonych edycjach oraz o zmianach działających od razu.
• Edycja wymaga roli Modeler writer i roli Writer w module.
• Administrator może odrzucić albo przekazać zapomniany draft.
• Historia zmian pokazuje każdy commit z autorem, opisem i elementami.