# Split and Join 2.0

> Dzieli artefakt na osobne artefakty dla każdego akapitu lub scala kilka artefaktów w jeden, z podglądem, zanim cokolwiek zostanie zmienione.

Source: https://widgets.doorsnext.com/pl/widgets/split-join/

- 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: dzielenie wymagań, łączenie wymagań, scalanie artefaktów, wymagania atomowe, podział na akapity, dekompozycja wymagań, jakość wymagań, split requirements, join requirements, IBM DOORS Next
- Wersja: 2.33 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Film: https://www.youtube.com/watch?v=r2wf8FlJIDk
- Przebieg pracy: 1. Zaznacz artefakty w module → 2. Pokazuje części lub połączony tekst → 3. Kliknij Split albo Join i potwierdź → 4. Nowe artefakty za oryginałem lub jeden połączony → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Dobre wymagania są atomowe: jedno wymaganie, jeden artefakt. Po imporcie z Worda pojedynczy artefakt często zawiera jednak całą sekcję z wieloma akapitami, listami lub tabelami. Zdarza się też odwrotnie: jedno stwierdzenie jest rozproszone po kilku artefaktach, które powinny stanowić całość.

Ręczne dzielenie lub scalanie artefaktów oznacza kopiowanie tekstu, tworzenie artefaktów, umieszczanie ich we właściwym miejscu i usuwanie pozostałości. Split and Join 2.0, nowa wersja przykładowego widżetu Split and Join firmy IBM opracowana przez SmarterProcess, wykonuje to w jednym kroku i najpierw pokazuje wynik.

## Jakie problemy rozwiązuje
- Artefakty zawierające kilka wymagań, co utrudnia ich śledzenie, testowanie i przegląd.
- Stwierdzenia rozproszone po kilku artefaktach, które powinny być jednym.
- Ręczne kopiowanie tekstu między artefaktami, w którym łatwo o błąd.
- Utrata struktury przy ręcznym dzieleniu artefaktów.

## Korzyści
- **Atomowe, testowalne wymagania,** które można indywidualnie linkować i weryfikować.
- **Podgląd:** widżet pokazuje części lub scalony tekst, zanim cokolwiek zostanie zmienione.
- **Właściwe rozmieszczenie:** nowe artefakty pojawiają się bezpośrednio po oryginale, na właściwym poziomie; w przypadku nagłówków pod nagłówkiem.
- **Bezpieczeństwo:** jeśli podział się nie powiedzie lub zostanie zatrzymany, moduł jest przywracany do poprzedniego stanu.
- **Raport zmian** z tekstami przed zmianą i po niej.

## Jak używać
1. Otworzyć moduł i zaznaczyć w nim artefakty.
2. **Zaznaczony jeden artefakt:** **Split** pokazuje części i to, co stanie się z każdą. Kliknąć kafel **Split** i potwierdzić przyciskiem **Split into N**.
3. **Zaznaczone dwa lub więcej:** **Join** pokazuje je w kolejności modułu; **Show joined text** pokazuje wynik. Kliknąć kafel **Join** i potwierdzić przyciskiem **Join N artifacts**.
4. Wynik pokazuje, co zostało zrobione, wraz z liczbami; **Log** w razie potrzeby zapisuje raport zmian.

## Warto wiedzieć
- Część to akapit, nagłówek, lista, tabela lub cytat w tekście; formatowanie wewnątrz części jest zachowywane.
- Linki, wartości atrybutów i komentarze nie są kopiowane do nowych artefaktów ani przenoszone z usuwanych.
- Scalenie jest blokowane, gdy artefakt przeznaczony do usunięcia ma niezaznaczone elementy podrzędne, dzięki czemu żaden artefakt nie traci swojego miejsca.
- **Also delete removed artifacts when this module was their only use** (domyślnie włączone): artefakt usunięty z modułu przez połączenie jest też usuwany z projektu, jeśli nie używa go żaden inny moduł. Po wyłączeniu zostaje tylko usunięty z tego modułu.