Create a Status Definition
- Last UpdatedMar 10, 2023
- 4 minute read
Right-click on the new STAWLD element in the Dictionary Explorer and select STADEF: Status Definition. The User can also create Status Definition Groups to contain Status Definitions). Enter a Name and Description in the Current Element Editor.
Note:
These will typically be similar but the description can include spaces and will be
used in the Status Controller if it is set.

In the Current Element Editor, the User can define the Initial status for the selected Status Definition.

From the displayed drop-list in the Initial status field, select the initial status value for the Status Definition.
Note:
It will be set to the first status value by default, but the User can change this
if required.
In the Current Element Editor, the User can define the Controllable element type for the selected Status Definition.

In the Controllable element type field, click the selection button. The Select element types window is displayed.

From the Available element types part of the Select element types window, select an element type, then click Add to list, and then OK. Other types can be applied if the definition is to apply to multiple types of elements.
Note:
UDTGs can also be added as part of the controllable element types.
Or select Show Type Selections to define the status definition to a subset of types.
Right-click the Status Definition in the Dictionary Explorer and select STAVAL: Status Value. Enter a Name, Description and Numerical value in the Current Element Editor.
Note:
Numerical values are optional and may be used as a percentage or a simple value.

Note:
Status Value name uniqueness applies only within the owning Status Definition. So
names can be repeated, for example Preliminary and Released in different definitions.
Each Status Value can have Valid transitions, in the Valid transitions field, click the selection button.

The Select valid status transitions window is displayed populated with status values that are valid transitions.

Select the status values that will be valid transitions from this value and click OK.
Or click Cancel to discard any inputs and close the Select valid status transitions window.
Each status value can have a value to promote or demote to, the Promote/Demote fields, click the selection button. From the drop-down list, select the appropriate values.

Note:
Promote and demote are optional and simply denote a main route through the workflow - any valid transitions not marked as promote or demote
will still be available in the Status Controller.
Select the Status Definition again in the Explorer and note its Initial status.
If required, a status definition can have a reason value (for example: Release, Approve, and so on) associated with it, from the Current Element Editor, in the Reason values field, click the selection button.

From the drop-down list, select the appropriate reason, by default it is unset. The Status Definition is now complete and ready for use.
Right click the Status Definition in the Dictionary Explorer and select Graphical View to see a workflow diagram as shown below. Click on any status value in the graphical view to make it current in the Dictionary Explorer.

Save the work and exit Lexicon.