Attribute Composer

Czym jest i dlaczego powstał

Wiele atrybutów w projekcie wymagań nie zawiera nowych informacji: w ustalonej formie powtarzają to, co artefakt już ma. Krótka etykieta złożona z identyfikatora i priorytetu, tytuł powtarzający nagłówek, klucz zawierający typ artefaktu albo kopia treści wymagania jako zwykły tekst na potrzeby raportu lub eksportu. Dziś takie pola wypełnia się ręcznie, artefakt po artefakcie, albo zostają puste, bo nikt nie ma na to czasu.

Attribute Composer wypełnia je w jednym przebiegu. Raz budujesz regułę (części wartości i ich kolejność), a widżet zapisuje wynik w wybranym atrybucie: we wszystkich artefaktach modułu albo tylko w zaznaczonych, po wcześniejszym pokazaniu, co dokładnie otrzyma każdy artefakt.

Jakie problemy rozwiązuje

• Atrybuty, które mają trzymać się konwencji nazewnictwa („ID / Priorytet / Nazwa”), a przy ręcznym wpisywaniu szybko się rozjeżdżają.
• Pola pozostające puste w tysiącach artefaktów, bo wypełnianie ich pojedynczo jest nierealne.
• Treść wymagania potrzebna jako zwykły tekst w osobnym atrybucie, do eksportów, raportów lub narzędzi zewnętrznych.
• Wartości wpisywane dwa razy, przez co zmiana w atrybucie źródłowym nigdy nie trafia do kopii.
• Brak możliwości sprawdzenia przed zapisem, co masowa aktualizacja faktycznie zapisze.

Korzyści

• Jedna reguła, cały moduł: części w wybranej kolejności: atrybuty dowolnego typu, nazwa, identyfikator, typ artefaktu, treść wymagania jako zwykły tekst oraz własny tekst, na przykład separatory.
• Podgląd przed zapisem: każdy artefakt z obecną i nową wartością obok siebie.
• Bezpieczne ustawienia domyślne: wypełniane są tylko puste atrybuty, dopóki nie wybierzesz nadpisywania; pusty wynik nigdy nie jest zapisywany, a poprawna już wartość nie jest zapisywana ponownie.
• Czysty wynik: pusta część zabiera ze sobą swój separator, więc nigdy nie powstanie „ID / / Nazwa”.
• Do wielokrotnego użytku: reguły można zapisać pod nazwą i wczytać ponownie, gdy wróci to samo zadanie.
• Dowód wykonania: raport zmian w Excelu wymienia każdy artefakt z wartością przed i po.

Jak używać

1. Otworzyć moduł w DOORS Next. W sekcji Rule kliknąć Change i wybrać Target attribute: atrybut tekstowy, atrybut liczbowy, gdy wartość jest liczbą, atrybut wyliczeniowy, gdy wartość jest jedną z jego etykiet, atrybut tak/nie lub daty albo nazwę artefaktu.
2. Złożyć wartość w Parts, in order przyciskami Add attribute i Add text: każda część to atrybut, nazwa, identyfikator, typ artefaktu, treść wymagania jako zwykły tekst albo własny tekst, np. separator. Części przestawia się strzałkami; linia pod nimi pokazuje wynikową regułę.
3. Zostawić zaznaczone albo odznaczyć Skip empty parts i Only fill empty targets (po odznaczeniu istniejące wartości są nadpisywane), wybrać Artifact type, jeśli zmienić ma się tylko jeden typ, i kliknąć Done.
4. W sekcji Write wybrać Whole module albo Selection (artefakty zaznaczone w DOORS Next) i kliknąć Find. Lista pokazuje nową wartość każdego artefaktu, który by się zmienił; po rozwinięciu wiersza widać atrybut, obecną i nową wartość oraz Show in module.
5. Kliknąć Write, przeczytać potwierdzenie i kliknąć Write N values. Po zakończeniu blok wyniku pokazuje, ile wartości zapisano, ile już było poprawnych, ile pominięto, a ile się nie udało; Log pobiera raport zmian w Excelu, a nieudane artefakty można ponowić z tego samego bloku.
6. Aby pominąć wyszukiwanie dla całego modułu, kliknąć Write bez wcześniejszego Find: po potwierdzeniu reguła zostaje zastosowana do każdego artefaktu modułu w jednym przebiegu, a liczby pojawiają się na końcu.

Warto wiedzieć

• Zawsze warto pracować w zestawie zmian (change set): jego odrzucenie to jedyny sposób na przywrócenie poprzednich wartości.
• Wyliczenia zapisywane są etykietami (wiele wartości rozdzielanych przecinkami), użytkownicy nazwiskami, a daty w formacie rok-miesiąc-dzień (YYYY-MM-DD).
• Treść wymagania zapisywana jest jako zwykły tekst: akapity, elementy list i wiersze tabel stają się liniami, a formatowanie znika.
• Zapisane reguły są osobiste: pozostają w przeglądarce użytkownika, nie są udostępniane współpracownikom ani przechowywane na serwerze.
• Bardzo długa wartość nie jest zapisywana; limit można zmienić w ustawieniach widżetu.
• W bardzo dużych modułach przebieg można zatrzymać, przeładować stronę i kontynuować od miejsca zatrzymania z tą samą regułą.