12 Group Detail Window

The name of the group. This name must comply with XML element naming conventions (see Section 9.6, "Valid Names" for more information).

Choose Optional if this is an optional group.

Choose Choice of Children if only one of the items in the group will be included in the message format.

Choose one of the following to indicate how often this group appears in the message format:

• Once — Indicates the group appears only once.

• Repeat Delimiter — Indicates the group will repeat until the specified delimiter is encountered.

• Repeat Field — Indicates that the value of the repeat field at run time is the number of times the field will repeat.

• Repeat Number — Indicates the group will repeat the specified number of times.

• Unlimited — Indicates the group will repeat an unlimited number of times.

Note: Unless a group is defined as Optional, all groups occur at least once.

Select this option if this is a tagged group. If tagged, a literal precedes the data, indicating that the data is present.

If you selected the Group is Tagged option, enter the tag in the text box to the right of the checkbox.

Select this option if the group has no delimiter.

Groups can have their termination point specified by a delimiter. A delimiter is a string of characters that marks the end of the group of fields. The group continues until the delimiter characters are encountered.

Select this option if the end of the group is marked with a delimiter.

Value — Enter the delimiter that marks the end of the group of fields.

Note: Normally, groups are not delimited. They are usually parsed by content (the group ends when all child objects have been parsed).

Indicates whether the binary data contains the delimiter even if the group is not present.

Groups can have their termination point specified by a field that contains a delimiter character string. A delimiter is a string of characters that mark the end of the group. The group continues until the delimiter character string contained in the specified field is encountered.

• Field — Select the field that contains the delimiter character string. A list of valid fields will be presented in a list.

• Default — Enter the default delimiter character that will be used if the above field is not present in the data. This value is required.

For more information on delimiters, see Section 19.12, "Character Delimiters."

Indicates that the delimiter marks both the end of the group of data, and the end of the last field of the group. The delimiter is shared among the group, and the last field of the group, to delimit the end of the data.

Saves your changes to the message format document.

Makes a copy of the group currently displayed. The duplicate group contains the same values as the original group. The name of the duplicate group is the same as the original group name, with the word "New" inserted before the original name. For example, duplicating a group called "Group1" results in a group with the name "NewGroup1".

When you duplicate an item with a numeric value in its name, the new item name contains the next sequential number. For example, duplicating "NewGroup1" results in a group named "NewGroup2".

Discards your changes to the detail window and resets all fields to the last saved values.

Displays online help information for this detail window.