Message Sets: Local group logical properties

The logical properties of a local group include properties that specify the number of occurrences of the local group.

Valid children in a local group that depend on both Composition and Content Validation are shown in MRM content validation.

Property Type Meaning
Composition Enumerated type

Define the order, and the number of occurrences, of the elements and groups in your messages. Composition does not affect the attributes in a complex type.

Select from the following options:

  • Empty
  • sequence. If you select this option, you can define members that are elements or groups. These members, if present, must appear in the specified order in the message. They can repeat, and the same element or group can appear more than once.
  • choice. If you select this option, you can define members that are elements or groups. Exactly one of the defined members must be present in the message, and can repeat.

    Use this option if you want to model C unions and COBOL REDEFINES in a Custom Wire Format, or an XML DTD element that uses choice in an XML Wire Format, or a SWIFT field that has more than one option.

  • all. If you select this option, you can define members that are elements; groups are not allowed. The elements in an all group can appear in any order. Each element can appear once, or not at all. An all group can be used only at the top level of a complex type; it cannot be a member of another group within a type.
  • unorderedSet.

    This option is supported only by the MRM domain.

    If you select this option, you can define members that are elements. The elements can repeat, but the same element cannot appear twice in the list of members. The elements can appear in any order in the message.
  • orderedSet.

    This option is supported only by the MRM domain.

    If you select this option, you can define members that are elements. The elements can repeat, but the same element cannot appear twice in the list of members. The elements must appear in the specified order in the message.
  • message.

    This option is supported only by the MRM domain.

    If you select this option, you can define only messages as members. Each member can repeat, but the same message cannot appear twice in the list of members. Like choice, only one of the defined members can be present in a message.

    Unlike choice, when writing a message, if the complex type or group has more than one member, the bit stream is not padded to the length of the longest member.

    Use this option to model multipart messages, which are used in some industry standards; for example, SWIFT. For more information, see the section on multipart messages in Message Sets: Multipart messages.

Content Validation Enumerated type

Content Validation is used only by the MRM domain. If validation is enabled in your message flow, Content Validation specifies the strictness of the MRM validation for members of a complex type or group. See MRM content validation for further details.

Select from the following options:
  • Closed. The complex type can only contain the child elements that you have added to it.
  • Open Defined. The complex type can contain any valid element defined within the message set.
  • Open. The complex type can contain any valid element, not just those that you have added to this complex type.

See Message Sets: Combinations of Composition and Content Validation for further details of these options.

Occurrences

Property Type Meaning
Min Occurs Integer Specify the minimum number of times that the object can repeat. The default value is 1.

If the value is set to 0, the object is optional.

With the exception of Max Occurs being set to -1, if a value is set for Min Occurs, it must be less than or equal to the value in Max Occurs.

Max Occurs Integer Specify the maximum number of times that the object can repeat. The default value is 1.

If this property is not set, the object cannot occur more than once.

If this property is set to 0, it is interpreted as if the object does not exist in the message.

It can also be set to -1, to indicate that the limit is unbounded and there is no maximum to the number of occurrences.