Composite field mapping

Composite field mapping maps a message element to a OvHD field depending upon the value of a sub-element (key) of the element ExtHDKeyField (OvHD and ExtHD are old terms; in this document, OvHD correspond to Service Manager and ExtHD correspond to SAP Solution Manager). A different value for the key defines mapping to a different Service Manager field. The following is a composite field mapping example.

<CompositeFieldMapping ExtHDField="IctIncidentStatement"
ExtHDKeyField="IctIncidentStatement/TextType">
<!-- For exchanging information log -->
<FieldMapping ExtHDField="IctIncidentStatement/Text" >
	<InDataType>InformationLog</InDataType>
	<OutDataType>InformationLog</OutDataType>
	<KeyFieldOutVal>SU99</KeyFieldOutVal>
	<KeyFieldInVal>SU99</KeyFieldInVal>
</FieldMapping>
<!-- for exchanging Solution Provided -->
<FieldMapping ExtHDField="IctIncidentStatement/Text">
	<OutOvHDField>Solution</OutOvHDField>
	<InOvHDField>Solution</InOvHDField>
	<KeyFieldOutVal>SU99</KeyFieldOutVal>
	<KeyFieldInVal>SU01</KeyFieldInVal>
</FieldMapping>
<!-- for exchanging CustomText01 (as example) -->
<FieldMapping ExtHDField="IctIncidentStatement/Text" >
	<InOvHDField>CustomText01</InOvHDField>
	<OutOvHDField>CustomText01</OutOvHDField>
	<KeyFieldOutVal>SU99</KeyFieldOutVal>
	<KeyFieldInVal>SU77</KeyFieldInVal>
</FieldMapping>
<!-- For sending custom fields from OVHD to external HD create an entry as
the example below. Replace the place holder strings as per your
configuration -->
<!--
<FieldMapping ExtHDField="IctIncidentStatement/Text" >
	<OutOvHDField>USER_VISIBLE_FIELDNAME_FOR_THAT_CUSTOM_FIELD
	</OutOvHDField>
	<KeyFieldOutVal>TEXT_TYPE_AS_DEFINED_BY_USER_FOR_THIS_FIELD
	</KeyFieldOutVal>
</FieldMapping>
-->
</CompositeFieldMapping>

Element IctIncidentStatement/Text is mapped to the information log if the key element IctIncidentStatement/TextType is SU99 or to Resolution field if the key element is SU01 (for an incoming message).

This is used when a message has multiple occurrences of the same element that have different sub-element values. The sub-element is referred to as the key field. In the example above the IctIncidentStatement/TextType element is the key field. For a composite field mapping, every instance of FieldMapping has a unique KeyFieldInVal.