Optional fields
Message fields may be optional, which means they can be present or absent in a sent or received message. Standard optional fields have a square checkbox icon to the left of their field name:
Choice fields
Some optional fields, known as choice fields, allow at most one mandatory choice from any set of choices. These fields have round (instead of square) icons:
Field states
The state of an optional field determines its COUNT in the scenario definition, whether to include it when sending messages, and how it affects whether to match a scenario in received messages. The following table shows icon settings and their field’s corresponding COUNT in the scenario definition, whether the Simulator will include the field in that state when sending messages, and whether the Simulator will match the scenario for the field in that state when receiving messages.
Icons | Setting | Count | Send | Receive | ||||
---|---|---|---|---|---|---|---|---|
|
Mandatory |
1 |
Include. |
Only match if present. |
||||
|
Prohibited |
0 |
Do not include. |
Only match if not present. |
||||
|
Optional |
0..1 |
Do not include. |
Match if present; otherwise ignore. |
||||
(x..y) |
Non-standard COUNT |
|
||||||
|
Absent |
Empty icons represent fields which are not present in the scenario definition at all. |
Mandatory is the default state for new fields. |
Click the icon to change between states. |
Translatable fields
Translatable fields provide different views of the same raw data. Selecting them will translate the data into the selected view. For a scenario to be valid, one (and one only) of the available translatable fields must be selected, by clicking the diamond icon to the left of the field name:
Usually a translatable field has an 'encoded' form and one or more 'structured' forms. |
The selected translatable field for a scenario definition has a filled icon: |