Excluding Position Relationships from Replication

You've created an Employee Central instance in SAP S∕4HANA.

You can create one template group if you want to replicate all object types together, or several template groups if you want to replicate the object types separately.

The transformation template group is the entity that you specify on the selection screen of the Create and Execute Organizational Object Replication Query (RH_SFIOM_ORG_OBJ_REPL_QUERY) program. From the template group, the program determines all information it must extract data from Employee Central fields and map it to SAP S∕4HANA fields.

The transformation template is the SAP S∕4HANA counterpart of the Employee Central entity. It groups fields from SAP S∕4HANA and mappings of these fields to Employee Central fields.

1. Go to Customizing for the Business Integration Builder and choose Data Replication from Employee Central→Organizational Objects→Field Mapping for Organizational Object Replication from Employee Central→Define Field Mapping for Organizational Data.
2. Select your transformation template group and choose Transformation Template.
3. Optional: If you want to have the transformation templates for the default Employee Central entities created automatically, choose Copy Sample Content.
4. Optional: To make the sample mappings show up in the Primary Mapping and Secondary Mapping views, choose Save.
5. Choose New Entries to create a transformation template manually.
6. Enter an ID and a name.

   Transformation templates aren't self-contained objects. They only exist within a transformation template group. We recommend that you use the same name for transformation templates created within different template groups if they refer to the same entity. For example, if you create two template groups that both have a transformation template for Department, use the same template ID (such as ERP_DEP) in both template groups.

7. To enable your transformation template, select Is Active.
8. Select the Employee Central entity that corresponds to the transformation template.

   Adding the Employee Central entity enables you to choose the Employee Central fields of the corresponding object type, which you've imported as metadata from Employee Central. You can map these fields to SAP S∕4HANA fields. If you create a transformation template for one of the default object types, assign the standard Employee Central entity provided for the corresponding object type. For all other transformation templates, use the custom Employee Central entity that you've created before.

   Use the same Employee Central entity (or rather the same transformation template to which you assigned the Employee Central entity) in only one transformation template group. If you use a transformation template and Employee Central entity in multiple template groups, queries of the Last Modified Query type run into an error. The error message is: "Query for EC instance <Employee Central instance>, EC entity <Employee Central entity> already sent for templ. grp <transformation template group>"

9. To populate the Communication Channel, Entity Name in EC, and Effective Dated fields, press Enter. These fields are automatically filled in with information that comes from the Employee Central entity you've selected.
10. Save your entries.
11. Choose New Entries again and repeat the same steps to create more transformation templates.

    Create a template for each object type that you want to include in the replication.

You've created the transformation template that you want to use for replication of a specific object type.

The SAP S∕4HANA system uses the field mappings that you define when processing the replicated data in the staging area and storing it in the infotypes.

We provide sample content that contains the most common mappings of organizational object fields. For example, a mapping of the department description from Employee Central to the Line With Length 79 (TLINE) field in the General Description (0001) subtype of the Description (1002) infotype of organizational units in SAP S∕4HANA.

1. Go to Customizing for the Business Integration Builder and choose Data Replication from Employee Central→Organizational Objects→Field Mapping for Organizational Object Replication from Employee Central→Define Field Mapping for Organizational Data.
2. Select your transformation template group and choose Transformation Template.
3. Select your transformation template and go to Primary Mapping.
4. Optional: If you want to use the sample content and haven't copied it yet when you created the transformation template, choose Copy Sample Content.
   Hint

   To check which mappings are available, choose Show Sample Primary Mapping first.

5. To create a field mapping manually, choose New Entries.
6. Select the Employee Central field that you want to map.

   You can choose from the fields provided by the Employee Central entity that's assigned to the transformation template.

7. Select the mapping mode Infotype Mapping.

   The other mapping modes aren't relevant for organizational object replication from Employee Central.

8. Select the SAP S∕4HANA infotype, the subtype if applicable, and the infotype field to be mapped.
9. If you want to use conditional mapping for a field, select the Employee Central field the conditional mapping is to be based on as the linking field. If you define a linking field, choose the Infotype Mapping mapping mode, but don't select any infotype, subtype, or infotype field.
10. Optional: Select a suitable value mapping entity.

    If you want to map the Employee Central field values to field values from SAP S∕4HANA, you need a value mapping entity. You also need a value mapping entity if you want to use the information stored in the key mapping table in SAP S∕4HANA for the mapping of relationships to other organizational objects.

As the next step, you can define a conditional mapping for your transformation template or format-specific Employee Central fields using value conversion. You can also define filters for your transformation template group.

When you've defined the field mapping and replicated organizational data based on this mapping, make sure that you trigger a full load each time you change the field mapping.