# Attribute Composer

> Wypełnia atrybut wartością, którą składasz z danych samego artefaktu, w całym module naraz i z pokazaniem każdej nowej wartości, zanim cokolwiek zostanie zapisane.

Source: https://widgets.doorsnext.com/pl/widgets/attribute-composer/

- Dyscyplina: Jakość treści
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: automatyczne wypełnianie atrybutu, łączenie atrybutów, sklejanie wartości atrybutów, kopiowanie treści wymagania do atrybutu, masowa aktualizacja atrybutów, konwencja nazewnictwa, etykieta z atrybutów
- Wersja: 1.15 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Wybierz atrybut docelowy i części → 2. Znajduje artefakty i składa nowe wartości → 3. Sprawdź obecne i nowe wartości (W razie potrzeby: Popraw regułę i szukaj ponownie) → 4. Zapisz wartości po potwierdzeniu → 5. Raport zmian w Excelu

## 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łą.