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: absent_c

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: absent_r

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_c mandatory_r

Mandatory

1

Include.

Only match if present.

prohibited_c prohibited_r

Prohibited

0

Do not include.

Only match if not present.

optional_c optional_r

Optional

0..1

Do not include.

Match if present; otherwise ignore.

(x..y)

Non-standard COUNT

Warning May be valid, but usually causes a validation error in the scenario.
Note For an accurate description of the usage semantics of the COUNT attribute in different circumstances, see the Scenario Simulator documentation.

absent_c absent_r

Absent

Empty icons represent fields which are not present in the scenario definition at all.

Note Mandatory is the default state for new fields.
Tip 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: absent_a

Note Usually a translatable field has an 'encoded' form and one or more 'structured' forms.
Tip The selected translatable field for a scenario definition has a filled icon​: mandatory_a
Previous page Next page