IBM Integration Bus, Version 10.0.0.9 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Message Sets: Element reference logical properties

The logical properties of an element reference include properties that specify the number of occurrences of the element reference.

Property Type Meaning
Reference Name Enumerated type The Reference Name is the name of the object that this object is referring to. The objects available to reference can be selected from the list.

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.

The Min Occurs and Max Occurs properties are used in conjunction with an element's Value properties. The following table summarizes how an element reference can be constrained.

Min Occurs Max Occurs Fixed Default Notes
1 1     The element must appear once, and can have any value.
1 1 Delta   The element must appear once, and it must match the data that has been entered in the Value property. In this example, the element must contain the text Delta.
2 -1 Delta   The element must appear twice or more, and it must match the data that has been entered in the Value property. In this example, at least two elements must contain the text Delta.
0 1     The element is optional, can appear once, and can have any value.
0 1 Delta   The element is optional, and can appear once. If it does appear, its value must match the data that has been entered in the Value property. If it does not appear, its value is the data that has been entered in the Value property.
0 1   Delta The element is optional, and can appear once. If it does not appear, its value is the data that has been entered in the Value property. If it does appear, it must be the value given in the element.
0 2   Delta The element is optional and can appear once, twice, or not at all. If the element does not appear, it is not provided. If the element appears and it is empty, it set to the data held in the Value property, else it is the value given in the element.
0 0     The element is prohibited, and must not appear.

ad06110_.htm | Last updated 2017-07-17 12:45:05