Artifact Generator User Manual


 

Introduction

The Artifact Generator extension for Engineering Requirements DOORS NG developed by Softacus simplifies the selection of artifact content, making it easier for users to create new artifacts or update existing ones.

Deployment of the Widget

The widget is deployed as any other IBM DNG widget. Detailed manual for the deployment is attached to the deployment files, or is also available on Softacus webpage: Enable Widget Extensions in DNG | Softacus.

User Interface

Widget UI = artifact content, name, widget information, create, add, update button, fullstop, text field

1.) Widget UI

Based on the functionalities and use cases that this extension is helping you with, we kept the user interface as simple as possible. In the current version of the widget you can find:

● Widget information section - section with version, short description and other information about the extension
● Option Dropdown Selection - This selection enables swift choice of sentence components from predefined data types.
● Update Selection Button - Upon activation, this button synchronizes predefined data type values with the current content within the text field.
● Text Field - This text field is responsible for constructing sentences. It can be modified either by clicking the "Add" button to incorporate selected words from the "Option Dropdown Selection", or by directly inputting custom content.
● Add Button - By engaging this button, the "Text Field" is supplemented with words or sentence fragments from the "Option Dropdown Selection".
● Artifact Content - This non-editable text field visually presents the content of the artifact (Primary Text), derived from your prior selections.
● Artifact Name - Similar to the "Artifact Content," this field exclusively showcases the "Artifact Name," crafted from two text fields (Object, Process Word). It can be enabled for editing through the "Disable Automatic Title" checkbox.
● Disable Automatic Title - A checkbox providing the ability to toggle between an unmodifiable and editable text area for the "Artifact Name".
● Update Button - When activated, this button synchronizes the selected artifact's content (Primary Text) and name attributes with the content within the "Artifact Content" and "Artifact Name" fields.
● Create Button - This button facilitates the generation of an artifact, complete with Name and Contents (Primary Text) attributes based on your designated choices.
● Fullstop - Enabling this option appends a period at the end of the sentence.
● Location of New Artifact Selection - When modifying an existing artifact, three placement options become available:
    ○ Create an artifact before the selected one.
    ○ Create an artifact after the selected one.
    ○ Create an artifact below (as a child) of the selected artifact.

Preconditions

To create a function, the user must create SenetnceStructure_EN attributes within their project/component properties.

 

SentenceStructure_EN = interface

2.) SentenceStructure_EN

To create a function, the user must create Anforderung Artifact Type within their project/component properties.

Anforderung interface

3.) Anforderung

This script is designed to work exclusively within a designated module and selected view. If the user fails to meet these prerequisites, the widget will display an informative message.

How to Use the Widget

In this sample scenario you will see how the extension is working and how you should use it:

Create Artifact

1. Open the mini dashboard.

Open a mini dashboard on the left side of the screen

4.) Mini dashboard

2. Click the "Add Widget" button.

Click

5.) Add Widget button

3. Find Artifact Generator in your widget catalog.

Find AG in Widget Catalog through the searchbar

6.) AG in Widget Catalog

4. Add AG to your mini dashboard.

Add AG to a mini dashboard through the green button

7.) AG to mini dashboard

5. Choose the Condition from the dropdown or write it directly in the free field and click on the “Add” button

Select the Condition from dropdown menu

8.) Select the Condition

6. Choose the Subject from the dropdown or write it directly in the free field and click on the “Add” button

Select the Subject from dropdown menu

9.) Select the Subject

7. Choose the Commitment from the dropdown or write it directly in the free field and click on the “Add” button

Select the Commitment from the dropdown menu

10.) Select the Commitment

8. Choose the Activity from the dropdown or write it directly in the free field and click on the “Add” button

Select the Activity from the dropdown menu

11.) Select the Activity

9. Choose the ProcessWord from the dropdown or write it directly in the free field and click on the “Add” button

Select the ProcessWord from the dropdown menu

12.) Select the ProcessWord

10. Choose the Object from the dropdown or write it directly in the free field and click on the “Add” button

Select the Object from the dropdown menu

13.) Select the Object

11. Choose the Quality from the dropdown or write it directly in the free field and click on the “Add” button

Select the Quality from the dropdown menu

14.) Select the Quality

12. Uncheck the checkbox if you want to create an artifact without a fullstop at the end

Fullstop checkbox

15.) Fullstop 

13. If you select an artifact in the module, a dropdown will appear from which you can choose the location of the newly generated artifact. If you do not select any artifact in the module, a new artifact will be generated at the end of the module

Artifact location = has to be set

16.) Artifact location

Softacus Services

We, in Softacus, are experts when it comes to consulting and service delivery of IBM software products and solutions in your business. We help our clients to improve visibility and transparency when licensing and managing commercial software, providing measurable value while increasing efficiency and accountability and we are providing services in different areas (see Softacus Services).
The IBM ELM extensions developed by Softacus are free of charge for the customers who ordered IBM ELM licenses via Softacus or for the customers who ordered any of our services. If you are interested in any of our IBM ELM extensions, you found a bug or you have any enhancement request, please let us know at This email address is being protected from spambots. You need JavaScript enabled to view it..