Restricted List of Values
- Last UpdatedJan 24, 2022
- 2 minute read
Two attributes with lists of values can be configured so that the selection of a value in one (the primary) controls which values are available in the other (the secondary).
For example, a list of Load Types, say MO1, MO2 and MO3, and a list of Typical Arrangements M200, M201, M202, … M210, then the available values for Typical Arrangement can be restricted according to the selection of the value for Load Type, as illustrated in the following table.
|
Load Type (primary) |
Restricted list of Typical Arrangement (secondary) |
|---|---|
|
MO1 |
M200, M201 |
|
MO2 |
M201, M202 |
|
MO3 |
M201, M209, M210 |
The two attributes can be on the same object or can be on different objects provided a reference attribute is available from the dependent object to the controlling object. In this example the reference attribute can be Electrical Load.
To set up, the UDAs needs to be configured as follows:
Primary UDA :LoadType, has UVALIDs with following data:
|
UVVAL |
UCVAL |
|---|---|
|
MO1 |
|
|
MO2 |
|
|
MO3 |
Secondary UDA :TypicalArrangement, has the attribute to follow UVVFER :ElectricalLoad, has UVALIDs with following data:
|
UVVAL |
UCVAL (reference array to controlling UVALIDs) |
|---|---|
|
M200 |
MO1 |
|
M201 |
MO1, MO2, MO3 |
|
M202 |
MO2 |
|
M205 |
|
|
M206 |
|
|
M209 |
MO3 |
|
M210 |
MO3 |
To complete this example two UDETs are needed, say :Load and :Arrangement, then the element and reference lists would be setup according to the following table:
|
UDA |
EELIST |
REFLIST |
|---|---|---|
|
:LoadType |
:Load |
|
|
:TypicalArrangement |
:Arrangement |
|
|
:ElectrcialLoad |
:Arrangement |
:Load |
When the data instances are created, the instance of Arrangement needs its Electrical Load reference set to point the instance of Load. The available values for Typical Arrangement will now be controlled by the selection of Load Type.
Note:
There is special treatment of secondary values that are not secondary for any primary
value. Such a secondary value is always be available, so in the above example, the
available values includes M205 and M206. This allows any new value added to the secondary
list to be immediately available to all selections, unless it is set to secondary
for at least one of the primary values.