Max Occurs (Node Property of All Schemas)
Use the Max Occurs property to configure the maximum number of times that the element or elements corresponding to the selected node can occur in a given scope in an instance message.
Note
If an ancestor node can occur multiple times, the total occurrences of the selected node can be greater than the occurrence range specified by the values of the Min Occurs property and this property.
Applies to Nodes of Type
Record, Field Element, Sequence Group, Choice Group, All Group, Any Element
Category
General
Allowed Values
Edit box value | Description |
---|---|
Non-negative integer | Any value greater than one (1) will enable the corresponding element(s) in an instance message to occur up to that many times. To prohibit multiple occurrences, set the value of this property to one (1) or leave it blank. To prevent all occurrences, set the value of this property to zero (0). The maximum value for Max Occurs is 4095. If you need a value greater than this, use "unbounded" as described below. |
"unbounded" "*" |
Use this value if you do not know how many loops you might have in an instance message and you do not want to lose any data. An asterisk (*) is a BizTalk Editor abbreviation for the literal string value "unbounded". |
No value | Use this property value to restore the behavior to the default value of one (1). |
Default Value
No value, indicating the default behavior associated with the value one (1).
XSD Persistence
As the value of the maxOccurs attribute of the element that corresponds to the selected node.
Note
The literal string "unbounded", and not an asterisk (*), is persisted in the XSD.
Remarks
You can examine and set this property in the Visual Studio Properties window when you select a node of an appropriate type in BizTalk Editor.
This property represents a standard XSD construct. For additional information about the corresponding XSD construct, see XSD Resources on the Web.
When you set this property to any value other than 1, BizTalk Mapper compiles the selected node as a looping record. If you configure this property with a value of 1, BizTalk Mapper will not compile the selected node as a looping record.
See Also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for