Skip to content
SmarterWidgets 2.0Documentation
SmarterProcess - https://doorsnext.com

Getting started

Adding a widget takes less than a minute. This page explains where widgets live, how to add one and how to work with them safely.

Before you start

  • IBM Engineering Lifecycle Management 7.x with IBM DOORS Next (most widgets) or any ELM application (User Audit and Advanced Server Diagnostics).
  • A modern browser: Google Chrome, Microsoft Edge, Mozilla Firefox or Safari.
  • The SmarterWidgets files on a web server your users can reach, and the SmarterWidgets catalog registered on your ELM server. Your administrator sets this up once. Contact SmarterProcess to get access.
  • Your usual DOORS Next permissions. Widgets can only do what you are allowed to do yourself.

Add a widget to a DOORS Next module

  1. Open a module in DOORS Next.
  2. Open the ELM Mini Dashboard on the right side of the page (Show Mini Dashboard).
  3. Click Add Widget, choose the SmarterWidgets catalog and pick the widget you need. The catalog shows a short description and a preview of each widget.
  4. The widget appears in the ELM Mini Dashboard and is ready to use. It stays there for your next visit.

Without the catalog you can still add a single widget: choose Add OpenSocial Gadget in the Add Widget dialog and enter the address of the widget that your administrator gives you.

User Audit and Advanced Server Diagnostics do not need DOORS Next, so you can also add them in the same way to the ELM Mini Dashboard of the other ELM applications. Widgets that work on projects and configurations, such as Baseline Archiver, Compare Data Models or Change Set Monitor, do not need an open module. Widgets that clean or link artifacts also work outside a module, on the artifacts you select in a folder or collection view: Whole module is then locked.

Work in a change set

We recommend running every widget that changes data inside a DOORS Next change set. If a run makes changes you do not want, you discard the change set and nothing reaches the stream. Deliver the change set only after you have checked the result. The Excel change report of the run helps with that review. Click Log in the result block to download it.

How every widget is organized

All widgets share the same layout, so once you know one, you know them all:

  • Header with the widget name and, under it, what the widget works on, for example the open module or No module open. At the right, How it works explains the widget in a few steps: what it changes, what to know and how to undo it. Next to it are buttons to read the context again and to reset the widget.
  • Settings as grey blocks that show your current choices, such as the link types or the rule. Change opens a block and Done closes it.
  • Work section with a Whole module | Selection switch and action tiles. The blue tile usually finds and lists what the widget would work on and changes nothing. The tile that changes data first asks you to confirm and names how many artifacts or links it will change.
  • Progress card while a run goes, with a Stop button. When the run ends, a result block takes its place: the outcome with its numbers, anything that could not be done (with Retry all) and Log, which downloads the Excel change report. After Stop on a whole module, Continue from … goes on from where the run stopped. After a short while the result block folds into one line; click it to open it again.
  • Footer with the version and the release date.

Settings

Each widget has a few settings in the widget menu under Edit, for example the size of a batch or whether notifications appear over the DOORS Next page. Your settings are remembered in your browser. Most users never need to change them. The choices for the work itself, such as link types or rules, are made inside the widget, in the grey settings blocks.

Updates

When a newer version of a widget is available, a blue New Version Available label appears in the widget header. Hover over it to see what changed. The page of each widget in this documentation shows what changed in its latest version.

  • 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