Skip to content
SmarterWidgets 2.0Documentation
SmarterProcess - https://doorsnext.com
Split and Join icon: white connected rectangles on a dark red square

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.

Supported products: RM = IBM Engineering Requirements Management DOORS Next (Requirements Management)Module structureChanges dataVersion 2.34 · released 2026-10-28

Works in
IBM DOORS Next module
Supported products
  • RM IBM Engineering Requirements Management DOORS Next (Requirements Management)
Version
2.34
Released

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

  1. You1Select artifacts in a module
  2. Widget2Shows the parts or the joined text
  3. You3Click Split or Join and confirm
  4. DOORS Next4New artifacts after the original, or one joined
  5. Result5Change report in Excel
  1. Open a module and select artifacts in it.
  2. One artifact selected: Split lists the parts and what happens to each. Click the Split tile and confirm with Split into N.
  3. 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.
  4. The result shows what was done, with its numbers; Log saves the change report if needed.

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

All changes to this widget

  • IBM Champion 2026 badge: purple square with the IBM logo and the text IBM Champion 2026, awarded through the IBM Champion program
  • IBM Champion 2025 badge: purple square with the IBM logo and the text IBM Champion 2025, awarded through the IBM Champion program
  • IBM Champion 2024 badge: purple square with the IBM logo and the text IBM Champion 2024, awarded through the IBM Champion program
  • IBM Champion 2023 badge: purple square with the IBM logo and the text IBM Champion 2023, awarded through the IBM Champion program
  • IBM Champion 2022 badge: purple square with the IBM logo and the text IBM Champion 2022, awarded through the IBM Champion program
  • IBM Champion 2021 badge: purple square with the IBM logo and the text IBM Champion 2021, awarded through the IBM Champion program
  • IBM Champion 2020 badge: purple square with the IBM logo and the text IBM Champion 2020, awarded through the IBM Champion program
  • IBM Champion 2019 badge: purple square with the IBM logo and the text IBM Champion 2019, awarded through the IBM Champion program