Enumerates the possible values that a domain-based attribute or variable can take.
Generators: .NET, .NET Framework, Android, Angular, Apple, Java
Level: Domain
This property can be set for any domain defined in your Knowledge Base. It opens a dialog ("Values Editor") to enumerate the possible values that an attribute or variable based on the domain can take.
For each possible value, you must specify:
- A Name, to be used to make reference to the value at programming time.
- A Description, which will be shown as a possible value to be selected for an attribute/value based on this domain.
- A Value that will be stored in the attribute/variable when selecting the corresponding Description.
By default, the attribute/variable controls belonging to an enumerated domain are shown as a combo box, with the Description values.
All the attributes/variables whose definition is based on an enumerated domain take these domain characteristics automatically.
It is not possible to assign a value to an enumerated variable or attribute directly:
&var = value
In the same example, this syntax is wrong and a “type mismatch” error will be shown in the navigation:
&var = "M"
The correct assignment must be made through the value name:
&var = Domain.Name
In the example, the syntax should be:
&var = Gender.Female
or
&var = Gender.Male
If Name does not exist among the defined names, an error will occur at runtime. The valid characters to define the Name are the same as for attribute names; i.e.: only letters, numbers, and underscore (_) are valid, and it must start with a letter.
In some cases, you need to store a Null value and/or let the user select a value that isn't part of the domain. In that case, you don't need to add the Null or Empty value to the Domain. Just set the EmptyItem property to True and the Empty as null property to Yes.
Enumerated Domains Methods