Module Fill

Czym jest i dlaczego powstał

Po migracji z innego narzędzia, reorganizacji projektu lub gdy dokument trzeba złożyć z istniejących wymagań, artefakty istnieją już w DOORS Next, ale moduł, który powinien je zawierać, jest pusty. Ręczne umieszczanie setek artefaktów w module, we właściwej kolejności i na właściwym poziomie, jest powolne i podatne na błędy.

Module Fill zajmuje się tym krokiem. Strukturę przekazuje się jako prostą listę par, np. [231,1][3513,1.1][67452,1.1.1], którą można przygotować w Excelu lub wyeksportować z narzędzia źródłowego, a widżet buduje moduł.

Jakie problemy rozwiązuje

• Puste moduły, które trzeba wypełnić setkami istniejących artefaktów w ściśle określonej kolejności i hierarchii.
• Migracje, w których struktura dokumentu jest znana w narzędziu źródłowym, ale musi zostać odtworzona w DOORS Next.
• Ręczne przeciąganie i upuszczanie z wysokim ryzykiem błędnej kolejności lub niewłaściwych poziomów.
• Częściowo zbudowane moduły po przerwanej pracy ręcznej.

Korzyści

• Minuty zamiast dni w przypadku dużych struktur dokumentów.
• Kontrola przed uruchomieniem: lista jest walidowana w trakcie wpisywania, każdy identyfikator jest wyszukiwany, a planowany moduł jest pokazywany w tabeli.
• Wszystko albo nic: struktura powstaje w ramach jednej zmiany, więc moduł nigdy nie zostaje wypełniony tylko w połowie.
• Powtarzalność: tę samą listę można użyć ponownie, na przykład najpierw w projekcie testowym.
• Nagłówki rozpoznawane automatycznie po wskazanych typach artefaktów, na przykład Heading.
• Także dla modułów z zawartością: struktura jest dodawana na końcu modułu, a to, co już w nim jest, zostaje.

Jak używać

1. Otworzyć moduł do wypełnienia, zwykle pusty.
2. W sekcji List wkleić pary [ID,level] w kolejności modułu w pole Artifact IDs and levels. Poziomy zapisuje się jako 1, 1.1, 1.1.1 itd. Błędy pojawiają się w trakcie wpisywania.
3. W polu Artifact types added as headings wskazać typy artefaktów, które stają się nagłówkami (domyślnie Heading).
4. Kliknąć Find artifacts. Widżet odnajduje każdy artefakt i wyświetla, z przyczyną, identyfikatory, które nie istnieją w bieżącej konfiguracji.
5. Sprawdzić planowaną strukturę w sekcji Structure.
6. Kliknąć Fill module i potwierdzić przyciskiem Add N artifacts. Po zakończeniu odświeżyć moduł lub przeładować stronę, aby zobaczyć wynik; Log zapisuje raport zmian.

Warto wiedzieć

• W module, który ma już zawartość, struktura jest dodawana na końcu, a istniejąca zawartość zostaje; potwierdzenie informuje, który przypadek zachodzi.
• Artefakty muszą już istnieć w projekcie i konfiguracji, w której odbywa się praca.
• Typy artefaktów dodawanych jako nagłówki są zapamiętywane w tej przeglądarce.
• Wypełnienie jest wysyłane w jednej zmianie i po wysłaniu nie można go zatrzymać. Aby sprawdzić je przed dostarczeniem, warto pracować w zestawie zmian.