SAP HCM Employee Connector

Overview

SAP HCM employee connector is a reading and updating connector provided by  UNIFY Identity Broker for SAP HCM.

The employee connector achieves this by requesting InfoTypes and SubTypes.

The 0000 InfoType forms the basis for the SAP HCM employee connector, as each employee can be uniquely identified through this InfoType.

Other InfoTypes and their associated SubTypes are linked by the PERNR field. InfoTypes that have begin and end effective dates are processed by a state machine, ensuring the most recent and valid information is presented by the connecter.

Technical Requirements

In addition to the requirements listed on prerequisites, the administrator should have a solid understanding of InfoTypes and SubTypes (see below).

Usage

A SAP HCM employee connector encapsulates the employee data from the target SAP HCM instance.

Reading Yes
Writing Yes (Updates only)
Deleting No
Polling No

Schema

Fields in a SAP HCM employee connector refer to values from the InfoType or SubType values.

The schema provider for this connector will retrieve a standard collection of form fields. They can be changed or removed to suit different requirements.

Configuration

SAP HCM Employee connector maintains the following configuration:


Name Description
Local Whether to use the a local date time in calculations. I.e. when using Start Now or End Now it will use a local time instead of UTC.
Status Type Status type for an identity, active, inactive, etc. Default is 3.
Start Now Whether the start date should represent now, as opposed to a specific date specified by Start Date.
Start Date Start date for the identities. Items prior to this date are filtered out.
Start Offset The amount of time to shift the the Start Date.
End Now Whether the end date should represent now, as opposed to a specific date specified by End Date.
End Date End date for the identities. Items after this date are filtered out.
End Offset The amount of time to shift the the End Date.
Empty SubType Whether the request for employees uses an empty sub type. Allows for testing difficulties with IntoTypes configuration.
InfoTypes Configuration for the InfoTypes and SubTypes to be returned. Also allows the the data to be mapped to a different field.

InfoTypes and SubTypes

Within SAP ERP Human Capital Management, the data associated with employees is organised by InfoTypes and SubTypes.

InfoType

An InfoType is a defined table structure, with specific columns and data types associated with each column. The InfoType is known by a code.

An example of the fields in InfoType 0000 is as follows:

Field name Data type Description
PERNR C Personnel number.
BEGDA D Begin date of the record.
ENDDA D End date of the record.
STAT2 C Status of the employee.

For a more complete definition of InfoType 0000 or other InfoTypes please consult an SAP expert.

SubType

Some InfoTypes are further divided by SubTypes. All SubTypes of an InfoType have the same structure. They are identified by a code, which defines the usage of the record.

An example of the fields of the InfoType 0105, used for contact information, are as follows:

Field name Data type Description
PERNR C Personnel number.
USRID C Short description.
USRID_LONG C Long description.

Some of the SubTypes of InfoType 0105 are:

SubType Description
0001 Contact phone number.
CELL Mobile phone number.
0020 E-mail address.

For a more complete definition of the SubTypes of InfoType 0105 or other InfoTypes and SubTypes please consult an SAP expert.

Employees

Each employee has a Personnel Number. Each InfoType record is associated to the employee through the Personnel Number through the field PERNR. Identity Broker uses this to denormalise current information to provide a complete and current picture of an employee.

Data types

SAP HCM exposes three simple data types, which are described in the following table:

Data type Description
C Character or textual data.
N Numeric (integer) data.
D Date date.

Each of these types can have further restrictions, such as maximum length of a character field.

Is this article helpful for you?