Using the choice element

The choice element in the XML schema gives the flexibility of listing a set of elements. The XML instance document using this schema can specify only one of the elements mentioned for choice. But when you generate an output XML document from BMC Remedy AR System forms, it is not obvious that you need to select only one of the choice elements. To resolve this, a choice node in the XML schema can be mapped to a character field. When an input XML document is received, the name of the element given for choice is stored in this character field. The value in this character field is used in generating the output XML document for choice.

In addition:

• Direct or indirect children of choice cannot be mapped to another form.
• Choice can have only elements. It cannot have immediate choice, sequence, group and so on.
• A choice can appear in a sequence or in a complex type.
• Recursion in choice is not allowed.
• "minOccurs" attribute of choice can be either 0 or 1. Any number greater than 1 or unbounded is not supported.
• "maxOccurs" attribute of choice must be 1. Any number greater than 1 or unbounded is not supported.
• Choice does not reset other items during a Set or Create operation. It sets only the item that is sent.