# Import Repair 2.0

> Odbudowuje hierarchię rozdziałów modułu zaimportowanego jako płaska lista, korzystając z poziomu zapisanego w atrybucie.

Source: https://widgets.doorsnext.com/pl/widgets/import-repair/

- 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: naprawa importu z Excela, import CSV, płaski moduł, odbudowa hierarchii modułu, poziomy rozdziałów, poziomy nagłówków, porządkowanie importu ReqIF, import wymagań, Import Repair, IBM DOORS Next
- Wersja: 1.30 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz zaimportowany moduł → 2. Wpisz atrybut poziomu i sprawdź poziomy → 3. Wypisuje planowane przeniesienia i problemy (W razie potrzeby: Problemy: popraw poziomy i sprawdź ponownie) → 4. Przenieś artefakty pod właściwych rodziców → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Import wymagań z Excela lub CSV jest szybki, ale jego wynikiem jest często płaski moduł: wszystkie artefakty na tym samym poziomie, a pierwotna hierarchia rozdziałów utracona. Zazwyczaj hierarchia nadal istnieje w danych jako numer poziomu lub numer konspektu (1, 1.2, 1.2.3) w jednym z zaimportowanych atrybutów.

Ręczna restrukturyzacja setek artefaktów oznacza przenoszenie ich jeden po drugim. Import Repair 2.0, nowa wersja przykładowego widżetu Import Repair firmy IBM opracowana przez SmarterProcess, odczytuje poziomy, sprawdza je i automatycznie odbudowuje hierarchię, bez zmiany kolejności w dokumencie.

## Jakie problemy rozwiązuje
- Płaskie moduły po imporcie z Excela, CSV lub innych narzędzi.
- Godziny ręcznego przenoszenia artefaktów w celu odtworzenia rozdziałów.
- Niespójne dane o poziomach, które niepostrzeżenie psują strukturę.
- Niepewność co do tego, co restrukturyzacja faktycznie zmieni.

## Korzyści
- **Struktura dokumentu odzyskana w kilka minut,** w pierwotnej kolejności.
- **Najpierw kontrola:** brakujące wartości, nieprawidłowe i pominięte poziomy są wyświetlane na liście, każdy z linkiem do artefaktu.
- **Podgląd każdego przeniesienia** (poziom obecny i docelowy), zanim cokolwiek zostanie zmienione.
- **Przenoszone jest tylko to, co błędne;** artefakty, które są już na właściwym miejscu, pozostają nietknięte, więc widżet można bezpiecznie uruchomić ponownie.
- **Raport zmian** obejmujący każde przeniesienie.

## Jak używać
1. Otworzyć zaimportowany moduł. Linia pod tytułem pokazuje jego nazwę i liczbę artefaktów.
2. W **Settings** kliknąć **Change**, wpisać **Level attribute** (atrybut przechowujący poziom każdego artefaktu), wybrać **How levels are written** i kliknąć **Done**.
3. W sekcji **Repair** kliknąć **Check levels**. Nic się jeszcze nie zmienia. Poprawić problemy wskazane przez widżet, a następnie kliknąć **Check again**.
4. Przejrzeć zaplanowane przeniesienia w **Artifacts** (poziom każdego artefaktu teraz i po naprawie), kliknąć **Move artifacts** i potwierdzić przyciskiem **Move N artifacts**.
5. Śledzić postęp (w każdej chwili można użyć **Stop**); na końcu kliknąć **Log** w wyniku, aby pobrać raport zmian.

## Warto wiedzieć
- Poziomy mogą być liczbami całkowitymi (1, 2, 3) lub numerami konspektu (1, 1.2, 1.2.3); widżet sam rozpoznaje używany format.
- Jeśli po sprawdzeniu moduł został zmieniony przez inną osobę, nic nie jest przenoszone, a widżet prosi o ponowne sprawdzenie.
- Jeśli przeniesienie się nie powiedzie, przebieg zostaje zatrzymany, aby żaden artefakt nie trafił w niewłaściwe miejsce; po usunięciu przyczyny wystarczy uruchomić go ponownie, aby kontynuować.