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
- Open a module in DOORS Next.
- Open the ELM Mini Dashboard on the right side of the page (Show Mini Dashboard).
- 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.
- 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.