# Module Fill

> Buduje w jednym kroku całą strukturę modułu na podstawie prostej listy identyfikatorów artefaktów i poziomów.

Source: https://widgets.doorsnext.com/pl/widgets/module-fill/

- Dyscyplina: Struktura modułów
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: wypełnianie modułu, budowanie struktury modułu, lista identyfikatorów artefaktów, migracja, moduł z CSV, wstawianie artefaktów, hierarchia modułu, populate module, IBM DOORS Next
- Wersja: 2.29 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz moduł do wypełnienia → 2. Wklej listę par [ID,poziom] → 3. Sprawdza listę i odnajduje każdy artefakt (W razie potrzeby: Nie znaleziono ID: popraw listę i szukaj ponownie) → 4. Sprawdź planowaną strukturę → 5. Wypełnij moduł: wszystkie artefakty w jednej zmianie → 6. Raport zmian w Excelu

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