Configuring Replication of Event Reasons

Objective

After completing this lesson, you will be able to configure replication of event reasons from Employee Central.

Replication of Event Reasons from Employee Central to SAP S/4HANA

Find out how the SAP S∕4HANA system regularly replicates employee master data including employee organizational assignments from Employee Central.

Configuring SAP S∕4HANA for Replication of Event Reasons from Employee Central

These are generic settings for personnel actions in SAP S∕4HANA. Therefore, they probably already exist in your system. However, check whether the settings have been made in detail as described here.

SAP S∕4HANA uses two infotypes to log personnel actions performed for an employee:

  • Actions (0000)

    SAP S∕4HANA only stores one personnel action per day for an employee in the Actions infotype.

  • Additional Actions (0302)

    The Additional Actions infotype enables you to log all of the personnel actions that are performed for an employee on a specific date.

Procedure

  1. Go to Customizing for Personnel Administration and choose Customizing ProceduresActions.
  2. Specify whether you want to use the Additional Actions (0302) infotype.
    1. Choose ActionsSet Up Personnel ActionsActivation 'Additional Actions' and set the ADMIN EVSUP switch in the T77S0 table to 1.
    2. Choose ActionsSet Up Personnel ActionsPersonnel Action Types and select the Update IT 0302 checkbox for the action types that you use in data replication from Employee Central.
  3. Choose ActionsSet Up Personnel ActionsPersonnel Action Types and select the Update IT 0000 checkbox for the action types that are to create a new record of the Actions (0000) infotype.

    Selecting Update IT 0000 requires that you also select the Update IT 0302 checkbox.

  4. Choose ActionsSet Up Personnel ActionsPersonnel Action Types and set the status indicators for Customer-Defined (STAT1), Employment (STAT2), and Special Payment (STAT3) according to your requirements.

    Setting one of the status indicators requires that you’ve selected the Update IT 0000 checkbox.

  5. Choose ActionsSet Up Personnel ActionsPriority List for Personnel Action Types and enter sequence numbers in the Priority (ORDNR) field to define a priority for action types that don't change the status of an employee, but for which the Update IT 0000 checkbox is selected.

    If multiple non-status-changing events are replicated on the same day, the priority determines which action is to be stored in the Actions infotype. The smaller the sequence number, the higher the priority of the personnel action type.

  6. Choose ActionsCreate Reasons for Personnel Actions and define action reasons for all action types that you want map to Employee Central event reasons from Employee Central.

    Note

    For technical reasons, at least one action reason must be defined for the action types that you want to use in data replication from Employee Central. If you don't want to use action reasons from a business point of view, add an entry for each action type and leave it empty.

Event Reasons Mapping from Employee Central to Action Types in SAP S∕4HANA

Map event reasons that you replicate from Employee Central to personnel action types so that it is possible to track in SAP S∕4HANA why which change was made for an employee.

Context

If you perform one or more events for an employee on a specific day in Employee Central, using event reasons that aren't mapped, the SAP S∕4HANA system applies the changes you made for the employee. However, it doesn't log the unmapped event reason itself in the form of a personnel action type in the Actions or Additional Actions infotype. Instead, it extends the validity of the previous infotype record (created for an event reason that is mapped to a personnel action type) to fill the gap.

We recommend that you use the sample content we provide for replication of employee master data from Employee Central. The sample content version EE_WS_3 contains the mapping of event reason to personnel action type that we describe here, except for the value mapping entries. We don't provide sample content for the value mapping entries because they're customer-specific.

Procedure

  1. Go to Customizing for the Business Integration Builder and choose Data Replication from Employee CentralEmployee DataDefine Field Mapping for Employee Data .
  2. Select the transformation template for Job Information and map the eventReason field from Employee Central to the SAP S∕4HANA field Action Type (MASSN).
  3. Add the EVENT_REASON value mapping entity to the field mapping.
  4. Choose Define Value Mapping Entries and map all Employee Central event reasons that you replicate with the corresponding personnel action types in SAP S∕4HANA.

    Example

    If you've defined an event reason New Hire (HIRNEW) for the Hire event in Employee Central, map this event reason to the personnel action type Hire (01)

Note

More examples and details regarding replicating event reasons from SAP SuccessFactors Employee Central to SAP S/4HANA can be found in the SAP help documentation.

Organizational Assignment Replication from Employee Central

In Employee Central, organizational assignments are stored in the employees' employment information.

Employee Organizational Assignments in Employee Central Compared to SAP S∕4HANA.

The employee in this example has the following organizational assignments:

  • Position: Production Director

  • Business Unit: Products

  • Division: Manufacturing

  • Department: Production US

  • Cost Center: BestRun Research & Development

  • Supervisor: Mya Cooper

  • Job Classification: Management & Planning

Organizational assignments from Employee Central correspond to the following organizational assignments in SAP S∕4HANA:

Employee CentralSAP S∕4HANA
Business unit assignmentRelationship of employee position (object type S) to organizational unit (object type O)
Division assignment
Department assignment
Job classification assignmentRelationship of employee position (object type S) to job (object type C)
Position assignmentRelationship of employee's personnel number (object type P) to position (object type S)
Cost center assignmentRelationship of employee position (object type S) to cost center (object type K)
Supervisor assignmentRelationship of employee position (object type S) to manager position (object type S)

In the SAP S∕4HANA system, the position (object type S) is the central object. All assignments are related to the position of an employee. By default, the position is linked to the following objects in the Relationships (1001) infotype.

If necessary, you can also use other relationships. You can configure them either for the replication of organizational assignments or for the replication of organizational objects from Employee Central. If you create other relationships, the relationship names and IDs differ from the default names and IDs listed here.

Diagram chowing organizational assignments and relationships in SAP S∕4HANA.
ObjectObject TypeDefault Relationship NameDefault Relationship ID
Personnel numberPHolderA008
Organizational unitOBelongs toA003
JobCIs described byB007
Cost centerKCost center assignmentA011
Manager positionSReports (line) toA002

The default relationships are stored with the following group and subgroup entries in the T77S0 table.

GroupSubgroupValueValue Description
PPRELSPRELA008Holder
PPRELSORELA003Belongs to
PPRELCTRELB007Is described by
PPRELKOSTAA011Cost center assignment
PPRELSUPVAA002Reports (line) to

You can configure what data is replicated from SAP SuccessFactors Employee Central to reflect the organizational assignments of your employees in the SAP S∕4HANA system.

In the SFSF EC INTEGRATION (PA_SE_IN) add-on, the replication of organizational assignments wasn't configurable. The way position relationships were created in the SAP S∕4HANA system was based on the employee's job information and job relationships in Employee Central and was hard-coded. You were able to influence the behavior only by implementing a Business Add-In (BAdI).

In the SFSF EC S4 HCM INTEGRATION (ECS4HCM) add-on, you can make entries in the following customizing activities to configure how position relationships are created:

  • Select Position to Be Used for Relationship to Personnel Number

  • Define Relationship Mapping for Position

  • Define Job Relationship Mapping for Position

When the Select Position to Be Used for Relationship to Personnel Number customizing activity has entries, SAP S∕4HANA uses the configurable replication of organizational assignments. This has the following effects:

  • The SAP S∕4HANA system ignores the following constants in the customizing activity Maintain Constant Values for Data Replication from EC:

    • EC to ERP: Omit Position-Job Rel. in Non-Config. OrgAssignm

    • EC to ERP: Omit Pos.-Cost C. Rel. in Non-Config. OrgAssignm

    • EC to ERP: Omit Pos.-Org Unit Rel. in Non-Config. OrgAssignm

    • EC to ERP: Omit Pos.-Manager Rel. in Non-Config. Org Assignm

    To exclude position relationships from the replication of organizational assignments (in particular, if you've configured the replication of organizational objects to create the relationships), don't configure them in the customizing activities Define Relationship Mapping for Position or Define Job Relationship Mapping for Position.

  • The SAP S∕4HANA system doesn't call the BAdIs Enhancements for Adapting Employee Organizational Assignment (EX_SFIOM_ADAPT_EE_ORG_ASSGNMNT) and Enhancements for Adapting Employee Organizational Assignment Request (EX_SFIOM_ADAPT_EE_ORG_ASS_REQ).

Position Relationship Exclusion from Organizational Assignment Replication

Prevent relationships from being created in SAP S∕4HANA by organizational assignment replication from Employee Central if you replicate organizational objects together with their associations from Employee Central.

Prerequisites

Enable synchronization of Job Information to Position Management in Employee Central. This synchronization ensures that whenever a relationship is changed in Job Information in Employee Central, this change is passed on to Employee Central Position Management. It can then be transferred from there, using organizational object replication.

Context

You can configure position relationships in SAP S∕4HANA to be created by the replication of organizational assignments and by the replication of organizational objects from Employee Central. The settings you make for organizational assignment and for organizational object replication can complement each other, but must not duplicate each other. Ensure that your configuration doesn't result in the same relationship being created by both replications.

Example

An example of how to avoid duplicated settings: You don't configure the position to job relationship in the Define Relationship Mapping for Position customizing activity if you've configured the replication of organizational objects to create this relationship in the SAP S∕4HANA system.

An example of settings that complement each other: You configure the matrix manager relationship in the Define Job Relationship Mapping for Position customizing activity. You don't make any entries in the Define Relationship Mapping for Position customizing activity. Instead, you configure the position to organizational unit (S-O), position to job (S-C), position to cost center (S-K), and position to position (S-S) relationships to be created by the replication of organizational objects.

If you replicate position relationships with organizational objects from Employee Central, disable replication of the corresponding position relationship with employee organizational assignments. There are different ways to do this:

  • If you use configurable replication of organizational assignments, don't configure the position relationships that you want to exclude from organizational assignment replication in the customizing activities Define Relationship Mapping for Position or Define Job Relationship Mapping for Position.

  • If you use the nonconfigurable approach to replicate organizational assignments, add the relevant constants in the Maintain Constant Values for Data Replication from EC customizing activity.

Procedure

  1. If you use the configurable approach to replicate organizational assignments, go to Customizing of the Business Integration Builder and choose Data Replication from Employee CentralEmployee DataEmployee Organizational AssignmentConfigurable Organizational AssignmentDefine Relationship Mapping for Position and Define Job Relationship Mapping for Position.
  2. Ensure that no entries exist for the position relationship that you want to exclude from organizational assignment replication.
  3. If you use the non-configurable approach to replicate organizational assignments, go to Customizing of the Business Integration Builder and choose Data Replication from Employee CentralBasic SettingsMaintain Constant Values for Data Replication from EC.
  4. Add the following constants as applicable:
    Relationship Included in Replication of Organizational ObjectsConstant to Exclude Relationship from Replication of Organizational Assignments
    Position to Organizational UnitEC to ERP: Omit Pos.-Org Unit Rel. in Non-Config. OrgAssignm
    Position to JobEC to ERP: Omit Position-Job Rel. in Non-Config. Org Assignm
    Position to Manager PositionEC to ERP: Omit Pos.-Manager Rel. in Non-Config. Org Assignm
    Position to Cost CenterEC to ERP: Omit Pos.-Cost C. Rel. in Non-Config. Org Assignm
  5. Enter X in the Constant Value field for each constant that you add.
  6. Save and transport your entries.

Position Definition That SAP S∕4HANA Is to Use for the Employee Relationship

You can configure what position relationships are to be created in the Relationships (1001) infotype in the SAP S∕4HANA system based on the data that is stored for the employee in the Job Information and Job Relationships blocks in SAP SuccessFactors Employee Central.

Example

You can specify which position field the system should use to create the relationship to the employee.

You create a position to organizational unit relationship in SAP S∕4HANA to reflect the department assignments of your employees in Employee Central.

You create a position to matrix manager position relationship in SAP S∕4HANA to reflect the matrix manager assignments of your employees in Employee Central.

Here is an overview of some standard relationships that a position can have in the SAP S∕4HANA system:

Standard Position Relationships in SAP S/4HANA

You have the following configuration options:

  • You can configure which Position field from the Job Information entity in Employee Central is used to create the employee position relationship in SAP S∕4HANA.

    Note

    You can use only one Position field from Employee Central in the configuration. Either the standard Position field or a custom field. You can't configure multiple Position fields.

  • You can map the desired Employee Central fields to appropriate position relationships in SAP S∕4HANA:

    • position to organizational unit (S-O)

    • position to job (S-C)

    • position to cost center (S-K)

    • position to position (S-S)

  • You can fill the fields Weighting Percentage (PROZT) and Priority (PRIOX) of the corresponding relationship in SAP S∕4HANA from the desired Employee Central fields.

  • You can define priorities in case multiple Employee Central fields are mapped to the same relationship.

    Example

    You map the Employee Central fields Department, Division, and Business Unit to the SAP S∕4HANA relationship of the position to the organizational unit, to reflect the organizational hierarchy from Employee Central in the SAP S∕4HANA system. When Employee Central transfers all three assignments for an employee, you want to create the position to organizational unit relationship in the SAP S∕4HANA system based on the assigned department. If no department assignment is transferred, you want to create the position to organizational unit relationship based on the assigned division, and so on.

  • You can map Employee Central fields to any other SAP S∕4HANA relationships that have the source field Position.

Note

For more information on defining the position relationship when replicating Replicating Organizational Assignments from SAP SuccessFactors Employee Central to SAP S/4HANA see the SAP help documentation.

Summary

  • SAP S/4HANA uses infotypes 0000 and 0302 to record personnel actions, requiring configuration and mapping of Employee Central event reasons to SAP action types for correct data replication.
  • Organizational assignments in Employee Central, like position and cost center, are mapped to SAP S/4HANA relationships primarily via the position object, using customizable settings to avoid duplication.
  • Replication settings in SAP S/4HANA can be configured to include or exclude specific position relationships, supporting flexible integration and preventing redundant data from Employee Central.
  • Employee Central fields and event reasons are mapped to SAP S/4HANA fields through transformation templates and value mapping, enabling accurate transfer and tracking of HR events and assignments.
  • To maintain data consistency, avoid overlapping relationship mappings between organizational assignment and object replication; use prioritization and SAP sample content for reliable, streamlined integration.