Split and Join 2.0
Splits an artifact into one artifact per paragraph, or joins several artifacts into one, with a preview before anything changes.
Video

The video opens from YouTube (youtube-nocookie.com) only after you click it.
What it is and why it exists
Good requirements are atomic: one requirement, one artifact. After imports from Word, however, a single artifact often holds a whole section with many paragraphs, lists or tables. The opposite also happens: one statement is spread over several artifacts that belong together.
Splitting or merging artifacts by hand means copying text, creating artifacts, placing them correctly and deleting the leftovers. Split and Join 2.0, SmarterProcess's new version of IBM's Split and Join sample, does it in one step and shows the result first.
Problems it solves
- Artifacts that contain several requirements, which makes them hard to trace, test and review.
- Statements spread over several artifacts that should be one.
- Copying text between artifacts by hand, where mistakes are easy.
- Lost structure when artifacts are split by hand.
Benefits
- Atomic, testable requirements that can be linked and verified individually.
- Preview: the widget shows the parts or the joined text before anything changes.
- Correct placement: new artifacts appear right after the original, at the right level; for headings, under the heading.
- Safe: if a split fails or is stopped, the module is restored to its previous state.
- Change report with the texts before and after.
How to use
- You1Select artifacts in a module
- You3Click Split or Join and confirm
- DOORS Next4New artifacts after the original, or one joined
- Result5Change report in Excel
- Open a module and select artifacts in it.
- One artifact selected: Split lists the parts and what happens to each. Click the Split tile and confirm with Split into N.
- Two or more selected: Join lists them in module order; Show joined text shows the result. Click the Join tile and confirm with Join N artifacts.
- The result shows what was done, with its numbers; Log saves the change report if needed.
Screenshots
1One artifact selected: the parts it is split into, before anything changes 2Split done: the original keeps part 1, the new artifacts follow it 3Several artifacts selected: what happens to each, and the joined text 4Confirmation before the text is joined into the first and the others are removed 5Joined: the text of three artifacts is now in one
Good to know
- A part is a paragraph, heading, list, table or quote of the text; formatting inside a part is kept.
- Links, attribute values and comments are not copied to new artifacts or moved from removed ones.
- A join is blocked when an artifact to be removed has children that are not selected, so no artifact loses its place.
- Also delete removed artifacts when this module was their only use (on by default): an artifact that a join removes from the module is also deleted from the project when no other module uses it. Switch it off to only remove it from this module.
What's new in version 2.34
· Change titles are published in English.
- Messages in the notifications