Repeating Groups

Use

Repeating groups iterate over data objects stored in the specification database. If a symbol refers to several data records, you can use the repeating group to control which data records are to be output.

Features

Assignment of Object

You use the following types of repeating groups to assign the object whose data records are to be read in a loop.

Repeating Group Type	Identification Code for Object in Symbol
Master group (value assignments of a value assignment type)	(M)
Master group with instance control	(MIC)(see Example 1: MIC Repeating Group in Example: Repeating Group with Instance Control )
Repeating group – instance control items	(MIC:POS)(See Example 2: MIC:POS Repeating Group in Example: Repeating Group with Instance Control )
Slave groups
Components of a value assignment	(S:POS, S:POSD)
User-defined text of value assignment	(S:FREI)
Usage of a value assignment	(S:VERW)
Transport classification data	(S:CLASS)(see Example: Repeating Group S:CLASS )
Validity area and language	(G)(see Example: Repeating Group of Type G )
Discrete expansion of multiple values	(D)
Sources	(Q)(See Example: Creating a List of Sources )
Parameter hierarchy	(P)
User exit	(Exit)(see Example: User Exit Repeating Groups )
Recipe Management	See Repeating Groups for Formulas

This graphic is explained in the accompanying text.

A slave group always references the data for a characteristic value assignment. In order for the system to assign the appropriate value assignment type, a slave group must nest within a master group.

Data Output Restriction

You use the following identification codes to define a data output restriction if not all of the symbol’s data records are to be read in a loop.

Identification Code in Symbol	Meaning
N	The system selects the data record with the number n.
*	This wildcard selects all data records it finds.
n-m	The system selects the data records from number n to number m.
n-*	The system selects all data records starting from number n.

You can select some frequently used shortcuts in the Mult. Val. Asst field. You can edit other variants directly in the template.

The range is always separated from the other parameters of the symbol by a semicolon.

This graphic is explained in the accompanying text.

<11BRG001(M,SAP_EHS_1015_003;1-3)>

<01G1015003AD(P;1)>

<11ERG001>

The system expands the first three value assignment records of value assignment typeSAP_EHS_1015_003, that is, the first phrase of the characteristic G1015003AD. For more information about the syntax of repeating groups, see Example: Repeating Groups .

Nesting Check

You can define nesting structures for repeating groups. The system checks the permitted nesting. The syntax diagram below illustrates the nesting structures that are valid for repeating groups.

You can determine all valid structures by following the arrows.

This graphic is explained in the accompanying text.

If a repeating group of type G lies within a repeating group of type M, MIC, or MIC:POS, only the language is taken into account. For the validity area also to be taken into account, the type G repeating group must be nested outside the repeating group of type M, MIC, or MIC:POS.

Expansion Time

For the repeating groups of the following types, the expansion time 10( Symbol value is specification-dependent ) always applies because these repeating groups expand specification-dependent data:

Master group value assignments of a value assignment type(M, MIC, MIC:POS)

Slave group components of a value assignment(S:POS, S:POSD)

Slave group user-defined texts of a value assignment(S:FREI)

Slave group usage of a value assignment(S:VERW)

Slave group transport data(S:CLASS)

If one of these repeating groups contains symbols with a different expansion time, such as20( Symbol value is application-dependent ), the expansion time of the symbol applies for these symbols.

Activities

Inserting Repeating Groups