Previous Topic: Special Date Property HandlingNext Topic: Example 1


Repeating Group Property Handling

Attributes that are in repeating groups have the same property names as non-repeating attributes, but with an index (a Long index parameter).

Two additional properties are defined for repeating groups. The first is a constant, Max, which represents the maximum number of rows in the repeating group. The second property, Count, is of Type Long and represents the current number of populated rows within the group.

The name for the Max property is formed by the combination of the procedure step name, group view name, and the word Max. The name for the Count property is formed by the combination of the group view name and Count. Thus, the read-only Max property is accessible via the name <ProcStepNameImportGroupViewName>Max. The Count property is accessed via the <ImportGroupViewName>Count property of the instantiated class object.

For repeating import groups, the Max property is considered read only, while the Count property is read/write.

Note: While it is possible for the user written application to set the Count property it will be incremented appropriately by the runtime API when attribute values are set via the instantiated class object as seen in the sample below. This count must be set if the server is to properly process the repeating group views. Undefined behavior will result of the Count value is set to a negative value or a value larger than Max.

For repeating export groups, the proxy application should consider both the Max and Count properties to be read only.