Composition Mapping

The composition mapping table contains the regulations for mapping compositions in the set of rules to value assignment types of the category composition in EH&S.

Table Fields in the Composition Mapping Table

Table Field	Meaning
Internal_Id	Name of the composition in the set of rules. This field uniquely identifies the composition in the set of rules.
External_Id	Name of the assigned value assignment type of the category composition in EH&S
Description	Description text for the composition
Options	Options that govern access to the data in EH&S more closely

Options for Compositions

Caution Caution

In the following syntax description, optional parts are shown in square brackets [ ] . The square brackets themselves do NOT belong to the syntax.

Three periods ... indicate a random number of repetitions of the previous syntax element.

End of the caution.

Option	Meaning
/USAGE=<Rating>,<Validity area>. [ ,Exclude indicator [ Active indicator [ Relevancy indicator ]]] [ ,... ]	The composition is read or written with the specified list of ratings and validity areas. As an option, you can set the exclude indicator with X or – . You can still set or deactivate the active indicator and the relevancy indicator either with X or – . If not specified, the exclude indicator is not set, the active indicator is set, and the relevancy indicator is not set. For compositions that are read from EH&S, specifying the active and relevancy indicators has no effect. Only active value assignments are read. For more information on using the /USAGE option as a selection criterion, see Data Selection by Usage .
/BASE /USEREXIT /PARAM	A recursive composition is read down to the lowest level of its ingredients. Any ingredients that are present in a number of components are totaled proportionally. If you do not specify this option, the direct components are read, or in other words, the first recursion level. This option has no effect when writing a composition. From EH&S 2.7A and EH&S 2.5B SP4, a user exit can be specified in the SAP system together with the /BASE option using the options /USEREXIT= name and /PARAM= value . In this user exit you can restrict the depth of the level of expansion of the composition tree. This means, for example, that a composition could be expanded down to the first occurrence of a particular value assignment. For this expansion restriction to function, you must have specified a user exit of the category SUB_EX_GCT in the SAP system. This user exit must reference the function module C1F2_EXIT_GET_COMP_TREE or a copy with the same interface. The value following the /PARAM option is passed on directly to the function module. In the example C1F2_EXIT_GET_COMP_TREE, the key of a value assignment type is expected as the parameter. The composition tree is then only read down to the first occurrence of a value assignment of this value assignment type.

Option

Meaning

/USAGE=<Rating>,<Validity area>. [ ,Exclude indicator [ Active indicator [ Relevancy indicator ]]] [ ,... ]

The composition is read or written with the specified list of ratings and validity areas. As an option, you can set the exclude indicator with X or – .

You can still set or deactivate the active indicator and the relevancy indicator either with X or – .

If not specified, the exclude indicator is not set, the active indicator is set, and the relevancy indicator is not set.

For compositions that are read from EH&S, specifying the active and relevancy indicators has no effect. Only active value assignments are read.

For more information on using the /USAGE option as a selection criterion, see Data Selection by Usage .

/BASE

/USEREXIT

/PARAM

A recursive composition is read down to the lowest level of its ingredients. Any ingredients that are present in a number of components are totaled proportionally. If you do not specify this option, the direct components are read, or in other words, the first recursion level. This option has no effect when writing a composition.

From EH&S 2.7A and EH&S 2.5B SP4, a user exit can be specified in the SAP system together with the /BASE option using the options /USEREXIT= name and /PARAM= value . In this user exit you can restrict the depth of the level of expansion of the composition tree. This means, for example, that a composition could be expanded down to the first occurrence of a particular value assignment.

For this expansion restriction to function, you must have specified a user exit of the category SUB_EX_GCT in the SAP system. This user exit must reference the function module C1F2_EXIT_GET_COMP_TREE or a copy with the same interface.

The value following the /PARAM option is passed on directly to the function module. In the example C1F2_EXIT_GET_COMP_TREE, the key of a value assignment type is expected as the parameter. The composition tree is then only read down to the first occurrence of a value assignment of this value assignment type.