Create a User Defined List Of Values
- Last UpdatedApr 09, 2024
- 4 minute read
A User Defined List Of Values (UDLOV) element must be created below a UDLOV Group element. To create a UDLOV element, on the Home tab in the Create group, select Create, from the displayed drop-down list, select UDLOV: User defined List Of Value. A UDLOV element is created and displays in the Dictionary Explorer.
When a new element is created in the dictionary hierarchy using the Dictionary Explorer and if the Current Element Editor window is open, it automatically updates to display the default attributes for that element.
Note:
If the Current Element Editor window is not open, right-click in any Explorer window and select Current Element Editor.
After the creation of a new UDLOV element, use the Current Element Editor window to populate the attributes in the Current Element Editor.
Note:
Dependent upon the attribute, other related attributes are enabled or disabled accordingly.
|
Name |
Input a valid name for the UDLOV element in the text box, special characters are not allowed. |
|
Description |
Input a brief description of the UDLOV element to be created. |
|
Valid values |
Depending on the type of element selected, input a valid numeric value, value range or text strings. For numeric ranges separate minimum from maximum value with a single dash (-). Multi-word strings must be enclosed in either single quotes (') or apostrophes (`) or vertical bars (|). Single-word strings do not have to be enclosed. All items must be separated by commas or white space. |
|
Value type |
Input the value type, for example: text or integer. |
The Dictionary Explorer automatically updates to display the specified name for the element.
Edit Valid Values
The Edit Valid Values window is opened via the Valid Values field of a UDLOV in the Current Element Editor. The Edit valid values window provides a large input area to allow multiple valid values to be input.
If a valid value has already been set, it displays in the input area allowing the user to edit the value, alternatively input a new set of values. Values can be removed by deleting the text.
Click OK to close the Edit valid values window and populate the Valid Values field of the Current Element Editor window or click Cancel to discard any inputs and close the Edit valid values window.
After the creation of a new UDLOV, it can be referenced to an element, for example a Status Value (STAVAL) element.
In the Dictionary Explorer, select a status value element, the Current Element Editor is automatically updated to display the attributes for the status element, these are initially empty.
Use the Current Element Editor window to populate the attributes in the Current Element Editor.
Note:
Dependent upon the attribute, other related attributes are enabled or disabled accordingly.
|
Name |
The name field is automatically populated with the STAVAL name. |
|
Description |
The description field is automatically populated with the STAVALs brief description. |
|
Numerical values |
A value associated with the status, for example: a percentage change. |
|
Reason values |
A reference to the list of valid reasons for transitions to this state (reference to the UDLOV element). |
|
Valid transitions |
Status values that are valid to transit to, refer to Select Valid Status Transitions for further information. |
|
Promote |
Select to promote through the workflow, from the drop-down list of available states. |
|
Demote |
Select to demote through the workflow, from the drop-down list of available states. |
|
Large icon |
Name a large icon to be associated with the state. |
|
Small icons |
Name a small icon to be associated with the state. |
Select Valid Status Transitions
To display the Select valid status transitions window, click the icon in the Valid transitions field of a STAVAL in the Current Element Editor.
Use the Select valid status transitions windows to select which status values are valid to transit to.
To select the status values to transit to, select the relevant check box to the left of the status value.
Click OK to close the window and return the values to the appropriate field in the Current Element Editor or Cancel to discard any inputs.