SF EC Data Obj Tbls Ref

Download as pdf or txt
Download as pdf or txt
You are on page 1of 154

Developer Guide | PUBLIC

Document Version: 2H 2022 – 2022-12-09

Data Model Field Information for Employee Central


© 2022 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN


Content

1 Change History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Foundation Object Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5


2.1 Organization Objects A-Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Business Unit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Corporate Address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Cost Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Department. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Division. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Geozone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Legal Entity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Location Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2 Job-Related Objects A-Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Job Classification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Job Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.3 Pay-Related Objects A-Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Frequency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Pay Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
Pay Component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Pay Component Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
Pay Grade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Pay Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Pay Range. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
2.4 Other Objects A-Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Dynamic Role Assignment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Dynamic Role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Event Reason. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
WfConfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
wfConfig Contributor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
wfConfig CC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
wf Step Approver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

3 Person Object Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51


3.1 Person Objects A- Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Addresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Biographical Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Data Model Field Information for Employee Central


2 PUBLIC Content
Dependents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Direct Deposit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Email. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Emergency Contact. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Global Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
National ID Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Personal Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Phone Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Social Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
Work Permit Info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

4 Employment Object Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96


4.1 Employment Objects A - Z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Compensation Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Employee Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Employment Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Global Assignment Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Job Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Job Relationships. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
PayComponentNonRecurring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
PayComponentRecurring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Payment Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Pension Payout Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Termination Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

5 Deprecated Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Data Model Field Information for Employee Central


Content PUBLIC 3
1 Change History

Learn about changes to the documentation for Data Model Field Information in Employee Central in recent
releases.

 Note

All configuration files for Employee Central, for example, master data models, master picklists, as well as
country/region-specific files, have moved from the SAP Help Portal to the Software Download Center .

2H 2022

Type of Change Description More Info

Changed We updated the descriptions for the pay PayComponentNonRecurring [page


component type field.
133]

PayComponentRecurring [page 140]

1H 2022

Type of Change Description More Info

Changed The <Domain> field in Social Accounts is Social Accounts [page 92]
required.

Changed We updated the information about the Biographical Information [page 57]
field <country-of-birth>. By default,
the list of field values come from the pre­
defined MDF object "Country/Region".

New You can now use five more fields for Addresses [page 51]
address lines (from <address21> to
<address25>), for address lines in alter­
nate language one (from <address21-
alt1> to <address25-alt1>), and
for address lines in alternate lan­
guage two (from <address21-alt2> to
<address25-alt2>).

Changed We add information about using the Job Information [page 110]
<employee-notice-period> field in
cascading picklists.

Data Model Field Information for Employee Central


4 PUBLIC Change History
2 Foundation Object Tables

The tables in the list give you the technical information about the foundation objects we deliver.

Most of the foundation objects include customer-specific fields, listed in the last rows of each table. These are
fields you can customize to use any way you want, if the foundation objects as delivered do not have all the fields
needed to satisfy your requirements even if, for example, you edit the field labels. You do not have to use the
customer-specific fields, but they are there if you need them.

 Note

Beware that hiding all fields in a block using a business rule is not supported and will potentially cause
unexpected behavior in the system. You must have at least one field on this object enabled to avoid inconsistent
behavior.

For information on how foundation objects are processed in the Corporate Data Model, including how to create
your own foundation objects, refer to the SAP SuccessFactors Data Model Reference guide.

For an explanation of what foundation objects are, and some links to more information about them, refer to the SAP
SuccessFactors Data Model Reference guide.

For information on MDF Foundation objects, refer to the Working with MDF Foundation Objects section of the
Implementing Employee Central Core guide.

Table Columns

Each of the tables has the following columns:

• Standard
If the field appears as part of the standard delivery for the relevant foundation object, “Yes” appears in this
column. “No” appears in the column if the field is not part of the standard delivery.
• Field ID
Each foundation object consists of one or more fields. This column lists the technical IDs of the fields. You
cannot change this ID.
• Field Label
This is the text that appears in the user interface (UI). You can change this to suit your own requirements.
• Data Type
HRIS Fields can handle data of various types (for fields of MDF FOs, see note below.). The options are:
• BIGDECIMAL and DECIMAL
Fields with these data types can handle mathematical operations.
• BOOLEAN
Fields like this can handle two options. On the UI, the most common options for such fields are “Yes” and
“No”.
• DATE
You can enter dates in fields of this type.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 5
• DOUBLE
Fields with this data type can handle decimal numbers.
• LONG
Fields with this data type can only contain integers.
• STRING
You can enter a string of characters in fields with this data type. Where there is a limit on the number
of characters in fields like this, the maximum number of characters allowed is shown in the Max.Length
column.
• Max.Length
Some fields with data type “String” have a limit on the number of characters you can enter in the string. Where
this is the case, this column shows the relevant maximum.
• Default Visibility
This determines whether the foundation object is visible on the UI and what you can do in it if it is visible. You
can change the default setting to suit your own requirements, choosing from the following options:
• BOTH: This means the field is visible on the UI for both display and editing purposes.
• VIEW: This means the field is displayed on the UI, but it cannot be edited there.
• NONE: The field does not appear on the UI.
• Is Required?
The answer “Yes” in this column indicates that the field is required. The answer “No” indicates that it is
optional.
• How To Use This Field
Here's some help on how to use the fields. For example, if a field needs additional configuration, you can find
the information here.

 Note

For MDF Foundation Objects (generic objects), custom fields are no longer restricted to set number of fields
per datatype. Instead, you can now assign any number of fields, subject to a maximum of 200 fields, depending
on your requirement to a datatype. Other points that apply to custom fields for MDF FOs:

• For each object, you can assign a maximum of 200 custom fields.
• There is no restriction on the name specified for the custom field. However, as a standard, all names
specified will automatically be prefixed with cust_ to indicate it is a custom field.
• For the different datatypes you can assign to a field, click the Data Type dropdown for the field in the
Configure Object Definition page.
• The enum data type cannot be assigned to a custom field. This is restricted for pre-delivered fields.
• Use the clob data type for fields that require a max length greater than 255. For example, Job Description.
• If you choose to assign one of these datatypes to a custom field (boolean, date, datetime, time,
autocomplete, picklist, Generic Object, Foundation Object, attachment and user), do not specify the max
length as the system will automatically take care of this.

Related Information

Corporate Data Model


MDF Foundation Objects

Data Model Field Information for Employee Central


6 PUBLIC Foundation Object Tables
2.1 Organization Objects A-Z

2.1.1 Business Unit

Here is a list of the fields available for this element.

BusinessUnit is an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: BusinessUnit

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description Translatable 128 As defined No If you need a more detailed
in the Con­
description of the business
figure Ob­
unit than the Name field
ject Defini-
tion page. can provide, enter it here.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the busi­
tartDate in the Con­ ness unit becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
veEndDate in the Con­ the business unit stops be­
figure Ob­ ing active.
ject Defini-
tion page.

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes external­ Code String 32 As defined Yes Define a unique code by


Code in the Con­ which the system can
figure Ob­ distinguish the different
ject Defini- business units from each
tion page. other.

Yes headOfUnit HeadOfUnit User — As defined No You can enter the identifier
in the Con­ of the person heading the
figure Ob­ business unit.
ject Defini-
tion page.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 7
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes name Name Translatable 90 As defined No You can enter a short


in the Con­
name for the business unit
figure Ob­
here.
ject Defini-
tion page.

2.1.2 Corporate Address

Here is a list of the fields available for this element.

hris-element id: corporateAddress

 Note

For a country/region-specific setup of corporateAddress, refer to the SAP SuccessFactors Employee Central
Country/Region Specifics Implementation Guide.

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

No start-date Start Date DATE — Both Yes Enter the date when
the corporate address be­
comes effective.

No end-date End Date DATE — None No This is the end date


the previous corporate ad­
dress stops being effec-
tive. The system calculates
the end date automatically
depending on the start
date entered.

Yes address1 Address 1 STRING 256 None No You can enter the first line
of address here.

Yes address2 Address 2 STRING 256 None No You can enter the second
line of address here.

Yes address3 Address 3 STRING 256 None No You can enter the third line
of address here.

Yes city City STRING 30 Both No This is where you enter the
city or town the company
is located in.

Data Model Field Information for Employee Central


8 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes county District STRING 256 None No This is where you enter the
county the company is lo­
cated in.

Yes state State STRING 256 None No This is where you enter
the state the company is
located in.

Yes province Province STRING 256 None No This is where you enter the
province the company is
located in.

Yes zip-code Zip Code STRING 256 None No This is where you enter the
ZIP code of the place the
company is located in.

Yes country Country STRING 256 Both Yes This is where you enter the
country the company is lo­
cated in.

No ad­ Custom STRING 256 Both No You can use these fields
dress21-25 Strings for data not covered by the
21-25 fields supplied as stand­
ard.
No custom- Custom STRING 256 None No
string1–20 Strings 1–
20

No custom- Custom DATE — None No


date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.1.3 Cost Center

Here is a list of the fields available for this element.

Cost Center is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: CostCenter

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 9
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes costCenter­ External Ob­ String 40 As defined No This field contains the
ExternalOb­
ject ID in the Con­ cost center ID in exter­
jectId
figure Ob­ nal format. If you have
ject Defini- multiple financial systems
tion page. from which you upload
cost centers into Em­
ployee Central, make sure
that the cost center IDs
are unique. Usually, down­
stream systems like pay­
roll do not understand this
unique ID and you have to
provide the cost center ID
in its external format.

Yes costCenter­ Costcenter­ User 255 As defined No Specify the cost center
Manager
Manager in the Con­ manager's identifier here.
figure Ob­
ject Defini-
tion page.

Yes description Description Translatable 128 As defined No Specify a description here


in the Con­ if you need a more de­
figure Ob­ tailed description of the
ject Defini- cost center than the one
tion page. the Name field provides.
This field is translated to
English (US) and the com­
pany's default language.

Yes effectiveS- Start Date Date 255 As defined Yes Specify the date on which
tartDate in the Con­ the cost center becomes
figure Ob­ active.
ject Defini-
tion page.

Yes effecti- End Date Date 255 As defined No Specify the date on which
veEndDate in the Con­ the cost center stops be­
figure Ob­ ing active.
ject Defini-
tion page.

Yes effectiveS- Status Enum 255 As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Data Model Field Information for Employee Central


10 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes external­ Code String 32 As defined Yes Specify a unique code by


Code in the Con­ which the system can dis­
figure Ob­ tinguish the different cost
ject Defini- centers from each other.
tion page.

Yes glState­ GLState­ String 32 As defined No This code is assigned


in the Con­
mentCode mentCode to account groups, such
figure Ob­
as customer receivables
ject Defini-
tion page. or vendor payables to re­
cord transactions, depend­
ing on financial accounts
involved in such transac­
tions. It ensures that total
account data includes all
sub-account transactions.

Yes legalEntity Legal Entity Generic Ob­ 38 As defined No Specify a legal entity to be
in the Con­ associated with the cost
ject
figure Ob­ center. By default, this
ject Defini- field is set to not visible.
tion page. That can be changed in the
object definition.

Yes Name Name Translatable 90 As defined No Specify a short name for


in the Con­
the cost center unit here.
figure Ob­
This field is translated to
ject Defini-
tion page. English (US) and the com­
pany's default language.

Yes parentCost­ Parent Generic Ob­ 255 As defined No Cost centers can be hier­
Center ject in the Con­ archical. If this is the case
figure Ob­ in your business, use this
ject Defini- field to specify a higher-
tion page. level cost center.

2.1.4 Department

Here is a list of the fields available for this element.

Department is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: Department

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 11
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes costCenter Cost Center Cost Center — As defined No You can assign the depart­
GO in the Con­ ment to a cost center by
figure Ob­ entering the cost center
ject Defini- details here.
tion page.

Yes description Description Translatable 128 As defined No If you need a more detailed
in the Con­ description of the depart­
figure Ob­ ment than the Name field
ject Defini- can provide, enter it here.
tion page.

Yes external­ Code String 32 As defined Yes Define a unique code by


Code in the Con­ which the system can
figure Ob­ distinguish the different
ject Defini- departments from each
tion page. other.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the depart­
tartDate in the Con­ ment becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
veEndDate in the Con­ the department stops be­
figure Ob­ ing active.
ject Defini-
tion page.

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes headOfUnit Head of De­ User — As defined No You can enter the de­
in the Con­
partment partment head's identifier
figure Ob­
here.
ject Defini-
tion page.

Yes name Name Translatable 90 As defined No You can enter a short


in the Con­ name for the department.
figure Ob­
ject Defini-
tion page.

Data Model Field Information for Employee Central


12 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes parentDe­ Department Department — As defined No You can enter the depart­
partment GO in the Con­ ment that is on the next
figure Ob­ level up in the cost center
ject Defini- hierarchy.
tion page.

2.1.5 Division

Here is a list of the fields available for this element.

Division is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: Division

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description Translatable 128 As defined No If you need a more detailed
in the Con­ description of the division
figure Ob­ than the Name field can
ject Defini- provide, enter it here.
tion page.

Yes external­ Code String 32 As defined Yes Define a unique code by


Code in the Con­ which the system can dis­
figure Ob­ tinguish the different divi­
ject Defini- sions from each other.
tion page.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the division
tartDate in the Con­ becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
veEndDate in the Con­ the division stops being
figure Ob­ active.
ject Defini-
tion page.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 13
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
in the Con­
tatus and Inactive. Do not con­
figure Ob­
figure this as a picklist.
ject Defini-
tion page.

Yes headOfUnit Head of Di­ User — As defined No You can enter the division
vision in the Con­ head's identifier here.
figure Ob­
ject Defini-
tion page.

Yes name Name Translatable 90 As defined No You can enter a short


in the Con­ name for the division here.
figure Ob­
ject Defini-
tion page.

Yes parentDivi­ Division Division GO — As defined No You can enter the division
sion in the Con­ that is on the next level up
figure Ob­ in the division hierarchy.
ject Defini-
tion page.

2.1.6 Geozone

Here is a list of the fields available for this element.

hris-element id: geozone

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes adjustment­ Adjustment STRING — Both No If the pay range for this ge­
Percentage Percentage ozone is to differ by a cer­
tain percentage from that
for another geozone, you
can specify the percentage
here.

This field is informational


only and is not used to
calculate compa ratio or
range penetration.

Data Model Field Information for Employee Central


14 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more detailed
description of the geozone
than the Name field can
provide, enter it here.

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different geo­
zones from each other.

Yes name Name STRING 90 Both No You can enter a short


name for the geozone
here.

Yes start-date Start Date DATE — Both Yes Enter the date the geozone
becomes active.

Yes end-date End Date DATE — None No You can also enter the date
the geozone stops being
active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.1.7 Legal Entity


Here is a list of the fields available for this element.

Legal Entity is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: LegalEntity

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 15
 Note

For information on country/region-specific fields that were earlier referenced through legalEntityLocal, refer to
the SAP SuccessFactors Employee Central Country/Region Specifics Implementation Guide.

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes countryO­ Country Country GO — As defined Yes Enter the country that
fRegistra­ in the Con­ makes up this geozone.
tion figure Ob­
ject Defini-
tion page.

Yes currency Currency Currency — As defined Yes Enter the currency that is
GO in the Con­ used for this legal entity.
figure Ob­
ject Defini-
tion page.

Yes defaultLoca­ Default Lo­ location FO — As defined No You can enter a location
tion cation in the Con­ that applies to all employ­
figure Ob­ ees in this legal entity.
ject Defini-
tion page.

Yes default­ Default Pay PayGroup — As defined No You can enter a pay group
GO
PayGroup Group in the Con­ that applies to all employ­
figure Ob­ ees in this legal entity.
ject Defini-
tion page.

Yes description Description Translatable 128 As defined No If you need a more detailed
in the Con­ description of the legal en­
figure Ob­ tity than the Name field
ject Defini- can provide, enter it here.
tion page.

Yes external­ Legal Entity String 32 As defined Yes Define a unique code by
Code ID in the Con­ which the system can dis­
figure Ob­ tinguish the different legal
ject Defini- entities from each other.
tion page.

Yes name Legal Entity Translatable 90 As defined No You can enter a short
Name in the Con­ name for the legal entity
figure Ob­ here.
ject Defini-
tion page.

Data Model Field Information for Employee Central


16 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the legal en­
tartDate in the Con­ tity becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
veEndDate
in the Con­ when the legal entity stops
figure Ob­ being active.
ject Defini-
tion page.

Yes standard­ Standard Decimal — As defined No In this field, you can en­
Weekly­ Weekly in the Con­ ter the number of hours
Hours Hours figure Ob­ employees are expected to
ject Defini- work in this geozone.
tion page.

Yes officialLan- Official Lan­ String — As defined No If there is an official lan­


guage guage in the Con­ guage for a legal entity,
figure Ob­ you can enter the ISO code
ject Defini- for that language here.
tion page.

2.1.8 Location

Here is a list of the fields available for this element.

hris-element id: location

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more detailed
description of the location
than the Name field can
provide, enter it here.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 17
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different loca­
tions from each other.

Yes loca­ Location STRING — Both No If you want to assign this


tionGroup Group location to a group, enter
the identifier for the rele­
vant group here.

Yes name Name STRING 90 Both No You can enter a short


name for the location.

Yes start-date Start Date DATE — Both Yes Enter the date when the lo­
cation becomes active.

Yes end-date End Date DATE — None No You can also enter the date
the location stops being
active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

Yes standard­ Standard DOUBLE — Both No You can enter the stand­
Hours Weekly ard weekly hours for a lo­
Hours cation.

Yes timezone Timezone STRING — Both No You can enter the time­
zone for the location.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Data Model Field Information for Employee Central


18 PUBLIC Foundation Object Tables
2.1.9 Location Group

Here is a list of the fields available for this element.

hris-element id: locationGroup

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more de­
tailed description of the
location group than the
short Name can provide,
enter it here.

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different lo­
cation groups from each
other.

Yes name Name STRING 90 Both No You can enter a short


name for the location
group here.

Yes start-date Start Date DATE — Both Yes Enter the date the location
group becomes active.

Yes end-date End Date DATE — None No You can also enter the date
the location group stops
being active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 19
2.2 Job-Related Objects A-Z

2.2.1 Job Classification

Here is a list of the fields available for this element.

Job Classification is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: JobClassification

 Note

For information on country/region-specific fields that were earlier referenced through jobClassLocal, refer to
the SAP SuccessFactors Employee Central Country/Region Specifics Implementation Guide.

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes defaultEm­ Employee Picklist 32 As defined No If a customer configured


ployeeClass Class in the Con­ picklist is added in Job In­
figure Ob­ formation, then that infor­
ject Defini- mation is defaulted here.
tion page.

Yes defaultJo­ Job Level Picklist 32 As defined No If a customer configured


bLevel
in the Con­ picklist is added in Job In­
figure Ob­ formation, then that infor­
ject Defini- mation is defaulted here.
tion page.

Yes defaultSu­ Supervisor Picklist — As defined No If a customer configured


pervisorLe­ Level in the Con­ picklist is added in Job In­
vel figure Ob­ formation, then that infor­
ject Defini- mation is defaulted here.
tion page.

Yes description Description Translatable 4000 As defined No If you need a more detailed
in the Con­ description of the job clas­
figure Ob­ sification than the short
ject Defini- name can provide, enter it
tion page. here.

Yes fulltimeEm­ Is Full Time Boolean — As defined No Enter “Yes” to indicate that
ployee Employee in the Con­ employees with this classi­
figure Ob­ fication work full time or
ject Defini- “No” to indicate that they
tion page. work part time. No picklist
required.

Data Model Field Information for Employee Central


20 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes effectiveS- Start Date Date — As defined Yes Enter the date the job clas­
tartDate in the Con­ sification becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
veEndDate
in the Con­ the job classification stops
figure Ob­ being active.
ject Defini-
tion page.

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes external­ Job Code String 32 As defined Yes Define a unique code by
Code in the Con­ which the system can dis­
figure Ob­ tinguish the different job
ject Defini- classifications from each
tion page. other.

Yes jobFunction Job Func­ JobFunction As defined No You can enter the job func­
tion GO in the Con­ tion relating to this job
figure Ob­ classification.
ject Defini-
tion page.

Yes name Job Title Translatable 90 As defined No You can enter a short
in the Con­ name for the job classifica-
figure Ob­ tion here.
ject Defini-
tion page.

Yes parentJob­ Parent Job JobClassifi- — As defined No You can enter the job code
Classifica- Classifica- cation GO in the Con­ that is on the next level up
tion tion figure Ob­ in the job code hierarchy.
ject Defini-
tion page.

Yes payGrade Pay Grade payGrade — As defined No You can enter the pay
FO in the Con­ grade for this job classifi-
figure Ob­ cation.
ject Defini-
tion page.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 21
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes regularTem­ Regular/ Picklist 32 As defined No This field indicates


porary Temporary in the Con­ whether the employee is
figure Ob­ regular or temporary.
ject Defini-
tion page.

Yes standard­ Standard Decimal — As defined No You can enter the standard
Weekly­ Weekly in the Con­ weekly hours for the job
Hours Hours figure Ob­ classification.
ject Defini-
tion page.

Yes worker­ Workers' String 32 As defined No This is most commonly


CompCode Comp Code in the Con­ used in the US.
figure Ob­
ject Defini-
tion page.

2.2.2 Job Function

Here is a list of the fields available for this element.

Job Function is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: JobFunction

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description Translatable 128 As defined No If you need a more detailed
in the Con­ description of the job func­
figure Ob­ tion than the short name
ject Defini- can provide, enter it here.
tion page.

Yes external­ Job Func­ String 32 As defined Yes Define a unique code by
Code tion ID in the Con­ which the system can dis­
figure Ob­ tinguish the different job
ject Defini- functions from each other.
tion page.

Data Model Field Information for Employee Central


22 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the job
tartDate in the Con­ function becomes active.
figure Ob­
ject Defini-
tion page.

Yes effecti- End Date Date — As defined No You can also enter the date
in the Con­
veEndDate the job function stops be­
figure Ob­
ing active.
ject Defini-
tion page.

Yes jobFunction­ Job Func­ Picklist 32 As defined No This is customer configu-


Type tion Type in the Con­ rable picklist to use if clas­
figure Ob­ sification or grouping of
ject Defini- job functions is required.
tion page.

Yes name Name Translatable 90 As defined No You can enter a name for
in the Con­ the job function here.
figure Ob­
ject Defini-
tion page.

Yes parentJob­ Parent JobFunction — As defined No You can enter the function
Function Function GO in the Con­ code that is on the next
Job figure Ob­ level up in the function
ject Defini- code hierarchy.
tion page.

2.3 Pay-Related Objects A-Z

2.3.1 Frequency

Here is a list of the fields available for this element.

hris-element id: frequency

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 23
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes annualiza­ Annualiza­ LONG — Both Yes Use this field to record the
tionFactor tion Factor number of times in a year
an employee would be paid
at this frequency to ach­
ieve an annual salary. Ex­
ample: Enter “12” if the
employee is paid monthly.

Yes description Description STRING 128 Both No If you need a more de­
tailed description of the
frequency than the short
name can provide, enter it
here.

Yes external­ Frequency STRING 32 Both Yes Define a unique code by


Code ID which the system can dis­
tinguish the different fre­
quencies from each other.

Yes name Name STRING 90 Both No You can enter a name for
the frequency here.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.3.2 Pay Calendar

Here is a list of the fields available for this element.

Pay Calendar is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: PayCalendar

Data Model Field Information for Employee Central


24 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes payGroup Pay Group STRING — As defined Yes Enter the code for the pay
in the Con­ group to which this pay pe­
figure Ob­ riod applies.
ject Defini-
tion page.

Yes toPayPer­ Pay Period DATE — As defined Yes Enter the date a given
iod.payPer­
Begin Date in the Con­ pay period starts. Exam­
iodBegin­
figure Ob­ ple: First of the month.
Date
ject Defini-
tion page.

Yes toPayPer­ Pay Period DATE — As defined Yes Enter the date a given pay
iod.payPer­ End Date in the Con­ period ends. Example: 16th
iodEndDate figure Ob­ of the month.
ject Defini-
tion page.

Yes toPayPer­ Pay Check DATE — As defined Yes Enter the date a pay check
iod.pay­ Issue Date in the Con­ is issued for a pay pe­
CheckIssue­ figure Ob­ riod. Example: 18th of the
Date ject Defini- month.
tion page.

Yes toPayPer­ Pay Periods LONG — As defined No You can enter the number
iod.cust_pay
Per Year in the Con­ of pay periods in a year.
PeriodsPer­
figure Ob­
Year
ject Defini-
tion page.

Yes toPayPer­ Offcycle BOOLEAN — As defined No This field indicates


iod.offcycle
in the Con­ whether a payroll run is a
figure Ob­ special payroll execution in
ject Defini- addition to a regular (or
tion page. normal) payroll execution.

For example, for the month


of December, the regular
(normal) payroll execution
is scheduled on Dec 28.
On December 30, an off-
cycle run is scheduled to
be executed for a year-end
bonus.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 25
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes toPayPer­ Processing STRING 256 As defined No You can enter an identifier
iod.proces­
Run ID in the Con­ for pay processing runs
singRunId
figure Ob­ here.
ject Defini-
tion page.

Yes toPayPer­ Run Type STRING 256 As defined No The list of values
iod.runType
in the Con­ comes from the picklist
figure Ob­ RUNTYPE.
ject Defini-
tion page.

2.3.3 Pay Component

Here is a list of the fields available for this element.

hris-element id: payComponent

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes basePay­ Base Pay STRING — Both No This attribute is only


Compo­ Component shown when the Pay Com­
nentGroup Group ponent Type is set to
Percentage. It is hidden
when the Pay Component
Type is set to Amount.
In case Pay Component
Type = "Percentage", a Pay
Component or Pay Com­
ponent Group needs to
be selected to define the
amount on which percent­
age is to be applied.

Yes canOverride Can Over­ BOOLEAN — Both No You can enter “Yes” if it will
ride be possible to override this
pay component for individ­
ual employees to whom it
would otherwise apply, or
“No” if it will not be possi­
ble.

Data Model Field Information for Employee Central


26 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes currency Currency CURRENCY — Both No You can specify the cur­
rency in which the pay
component is paid.

Yes description Description STRING 128 Both No If you need a longer de­
scription of the pay com­
ponent than the short
name can provide, enter it
here.

Yes displayOn­ Display on BOOLEAN — Both No Controls whether this pay


SelfService Self Service component will be dis­
played in manager self-
service

Yes end-date End Date DATE — None No You can also enter the date
the pay component stops
being active.

Yes external­ Pay Compo­ STRING 32 Both Yes Define a unique code by
Code nent ID which the system can dis­
tinguish the different pay
components from each
other.

Yes frequency­ Frequency STRING — Both Yes Specify how often a pay
Code component is paid. Exam­
ple: annually.

Yes is-earning Is Earning BOOLEAN — Both No You can specify whether


the pay component is an
earning or a deduction.

Yes IsRelevant­ Relevant for BOOLEAN — None No Here you can specify if this
ForAdvance­ Advance pay component is used
Payment in the advance payments
process.

Possible values are Yes and


No.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 27
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes maxFrac­ Maximum LONG — None No In this field you can define
tionDigits Decimal Pla­ for each pay component
ces how many decimals are
maximally shown in the
amount field.

You can choose a number


from 0 to 5. If you do
not enter any value, the
system uses the following
value:

1. The value defined for


the
maximumFraction
Digits XML attrib­
ute that has been de­
fined for
payComponentRec
urring or
payComponentNon
Recurring in the
Succession Data
Model
2. If the aforementioned
XML attribute has not
been defined, the de­
fault value is 3.

Yes name Name STRING 90 Both No You can enter a name for
the pay component.

Yes number Number DOUBLE — Both Edit This field supports Unit-
based pay components as
well as number of units.

When Number is selected,


Unit of Measure and Rate
are shown.

Data Model Field Information for Employee Central


28 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes payCompo­ Pay Compo­ STRING — Both Yes Possible values are
nentType nent Type Amount, Percentage and
Number. Do not configure
this as a picklist.

For more information on


setting up number as a
possible value, refer to the
Creating a Pay Component
topic in the Implementing
Employee Compensation
Data in Employee Central
guide.

Yes payCompo­ Pay Compo­ DOUBLE — Both No You can specify a value for
nentValue nent Value the pay component here.

Yes rate Rate DOUBLE — Both No This field supports Unit-


based pay components,
typically price per unit.

Yes recurring Recurring BOOLEAN — Both No You can indicate whether


the pay component is paid
regularly or is just a one-
time payment.

Yes selfService­ Self Service STRING — Both No


 Note
Description Description
This field is only dis­
played in the founda­
tion object and will
not show up anywhere
else, even if filled with
text. It was originally
intended to be used as
a description for the
Manager Self-Service
UI but was never im­
plemented.

Yes start-date Start Date DATE — Both Yes Enter the date the pay
component becomes ac­
tive.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 29
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes taxTreat­ Tax Treat­ STRING — Both No You can indicate whether
ment ment the pay component is
taxed or not.

The list of values


comes from the picklist
TAXTREATMENT.

Yes target Target BOOLEAN — Both No You can enter “Yes” in this
field if the pay component
is a target figure or per­
centage, or enter “No” if it
is not.

Yes unit-of- Unit of STRING — Both No This field supports Unit-


based pay components,
measure Measure
for example, Day, Hour,
and so on.

Yes usedFor­ Used for STRING — Both No Controls whether this pay
CompPlan­ Comp Plan­ component will be used by
ning ning the comp module. Possible
values are None, Comp,
Varpay and Both. Do not
configure this as a picklist.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.3.4 Pay Component Group

Here is a list of the fields available for this element.

hris-element id: payComponentGroup

Data Model Field Information for Employee Central


30 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes currency Currency CURRENCY — Both No You can specify the cur­
rency in which the pay
components in this group
are paid.

Yes description Description STRING 128 Both No If you need a more detailed
description of the pay
component group than the
short name can provide,
enter it here.

Yes end-date End Date DATE — None No You can also enter the date
the pay component group
stops being active.

Yes external­ Pay Compo­ STRING 32 Both Yes Define a unique code by
Code nent Group which the system can dis­
ID tinguish the different pay
component groups from
each other.

Yes name Name STRING 90 Both No You can enter a short


name for the pay compo­
nent group.

Yes showOn­ Display on BOOLEAN — Both No You can choose whether to


CompUI Comp UI have the pay component
group displayed on the

Yes start-date Start Date DATE — Both Yes Enter the date the
pay component group be­
comes active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

Yes systemDe­ System De­ BOOLEAN — None No You can enter “Yes” in
fined fined this field if the system
generates pay component
groups for you, based on
other data, or “No” if they
are created manually.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 31
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes useForCom­ Use for BOOLEAN — Both No You can choose whether
paratioCalc Comparatio the pay component group
Calculation should be used as part of
the comp ratio calculation.

Yes useForRan­ Use for BOOLEAN — Both No You can enter “Yes” if
gePenetra­ Range Pene­ this pay component group
tion tration can be used to determine
how far into a given pay
range an employee has
progressed or “No” if it is
not used for that.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.3.5 Pay Grade

Here is a list of the fields available for this element.

hris-element id: payGrade

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more de­
tailed description of the
pay grade than the short
name can provide, enter it
here.

Data Model Field Information for Employee Central


32 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes end-date End Date DATE — None No You can also enter the date
the pay grade stops being
active.

Yes external­ Pay Grade STRING 32 Both Yes Define a unique code by
Code ID which the system can dis­
tinguish the different pay
grades from each other.

Yes name Name STRING 90 Both No You can enter a short


name for the pay grade.

Yes paygradeLe­ Pay Grade LONG — Both No You can use this field to
vel Level enter the level of the rel­
evant pay grade. For ex­
ample, level 1 for a new
starter.

Yes start-date Start Date DATE — Both Yes Enter the date the pay
grade becomes active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.3.6 Pay Group


Here is a list of the fields available for this element.

Pay Group is now an MDF Generic Object. Use the Configure Object Definition page to maintain this object.

generic object id: PayGroup

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 33
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes dataDeli­ DataDeli­ String 32 As defined No


 Note
miter miter in the Con­
figure Ob­ This field is not used
ject Defini- by Employee Central.
tion page.

Yes decimal­ Decimal­ String 32 As defined No


 Note
Point Point in the Con­
figure Ob­ This field is not used
ject Defini- by Employee Central.
tion page.

Yes description Description Translatable 128 As defined No If you need a more de­
in the Con­ tailed description of the
figure Ob­ pay group than the short
ject Defini- name can provide, enter it
tion page. here.

Yes earliest­ Earliest Date — As defined No Define the earliest date


ChangeDate Change in the Con­ for which payroll relevant
Date (for figure Ob­ changes can be made for
Payroll) ject Defini- an employee assigned to
tion page. this pay group.

Yes effectiveS- Start Date Date — As defined Yes Enter the date the pay
tartDate in the Con­ group becomes active.
figure Ob­
ject Defini-
tion page.th

Yes effecti- End Date Date — As defined No You can also enter a date
veEndDate in the Con­ the pay group stops being
figure Ob­ active.
ject Defini-
tion page.

Yes effectiveS- Status Enum — As defined Yes Possible values are Active
tatus in the Con­ and Inactive. Do not con­
figure Ob­ figure this as a picklist.
ject Defini-
tion page.

Yes external­ Pay Group String 32 As defined Yes Define a unique code by
in the Con­
Code ID which the system can dis­
figure Ob­
tinguish the different pay
ject Defini-
tion page. groups from each other.

Data Model Field Information for Employee Central


34 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes lag Lag Number — As defined No Indicates the number of


in the Con­ pay periods that the em­
figure Ob­ ployee is paid in arrears.
ject Defini- If the employee is paid
tion page. current, set the lag to 0.
This information is stored
in Employee Central to be
transmitted to payroll.

Yes name Name Translatable 90 As defined No You can enter a short


in the Con­ name for the pay group.
figure Ob­
ject Defini-
tion page.

Yes payment­ PayFre­ Picklist 32 As defined No Specify how often a pay


Frequency quency in the Con­ group is paid.
figure Ob­
ject Defini-
tion page.

Yes payrollVen­ PayrollVen­ String 32 As defined No If your company uses


dorId dorID in the Con­ an external contractor to
figure Ob­ process its payroll, enter
ject Defini- the contractor's ID here.
tion page.

Yes primary­ Primary­ String 256 As defined No You can enter an e-mail ad­
ContactE­ ContactE­ in the Con­ dress for the group's main
mail mail figure Ob­ contact.
ject Defini-
tion page.

Yes primary­ Primary­ String 256 As defined No You can enter the identifier
ContactId ContactID in the Con­ of the main contact for this
figure Ob­ group.
ject Defini-
tion page.

Yes primary­ Primary­ String 256 As defined No You can enter the name of
Contact­ Contact­ in the Con­ the group's main contact.
Name Name figure Ob­
ject Defini-
tion page.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 35
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes secondary­ Secondary­ String 256 As defined No You can enter an e-mail ad­
ContactE­ ContactE­ in the Con­ dress for the group's sec­
mail mail figure Ob­ ondary contact.
ject Defini-
tion page.

Yes secondary­ Secondary­ String 256 As defined No Enter the identifier of the
ContactId ContactID in the Con­ secondary contact for this
figure Ob­ group.
ject Defini-
tion page.

Yes secondary­ Secondary­ String 256 As defined No You can enter the name
Contact­ Contact­ in the Con­ of the group's secondary
Name Name figure Ob­ contact.
ject Defini-
tion page.

Yes weeksInPay­ WeeksIn­ Number — As defined No You can specify how many
Period PayPeriod in the Con­ weeks a pay period for this
figure Ob­ group should last.
ject Defini-
tion page.

2.3.7 Pay Range

Here is a list of the fields available for this element.

hris-element id: payRange

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes currency Currency CURRENCY 256 Both No You can specify the cur­
rency in which the pay
range is indicated.

Yes description Description STRING 128 Both No If you need a more de­
tailed description of the
pay range than the short
name can provide, enter it
here.

Data Model Field Information for Employee Central


36 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes end-date End Date DATE — None No This is the end date
the previous pay range
stops being effective. The
system calculates the
end date automatically de­
pending on the start date
entered.

Yes external­ Pay Range STRING 32 Both Yes Define a unique code by
Code ID which the system can dis­
tinguish the different pay
ranges from each other.

Yes frequency­ Frequency STRING — Both Yes Define how often a pay
Code component is paid — for
example, annually.

The list of values comes


from the frequency foun­
dation object.

Yes maximum­ Maximum DOUBLE — Both No Enter the maximum pay


Pay Pay for this pay range, for ex­
ample: 80,000.

Yes midPoint Mid Point DOUBLE — Both No Enter the mid point for
this pay range that lies be­
tween the minimum and
the maximum pay, for ex­
ample: 75,000.

Yes minimum­ Minimum DOUBLE — Both No Enter the minimum pay for
Pay Pay this pay range, for exam­
ple: 70,000.

Yes name Name STRING 90 Both No You can enter a short


name for the pay range.

Yes start-date Start Date DATE — Both Yes Enter the date the pay
range becomes effective.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

Yes custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 37
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes custom- Custom DATE — None No fields supplied as stand­


date1–10 Dates 1–10 ard.

Yes custom- Customer LONG — None No


long1–20 Numbers 1–
20

Yes custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.4 Other Objects A-Z

2.4.1 Dynamic Role Assignment

Here is a list of the fields available for this element.

hris-element id: dynamicRoleAssignment

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes businessU­ Business STRING — Both No The list of values comes


nit Unit from the business unit
foundation objects that are
available in the system.

Yes company Legal Entity STRING — Both No The list of values comes
from the legal entity foun­
dation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Data Model Field Information for Employee Central


38 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes costCenter Cost Center STRING — Both No The list of values comes
from the cost center foun­
dation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Yes department Department STRING — Both No The list of values comes


from the department foun­
dation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Yes jobCode Job Classifi- STRING — Both No The list of values comes
cation from the job classification
foundation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Yes location Location STRING — Both No The list of values comes


from the location founda­
tion objects that are availa­
ble in the system.

If you don't need this field,


you can set the visibility to
“none”.

Yes payGrade Pay Grade STRING — Both No The list of values comes
from the pay grade foun­
dation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 39
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes payGroup Pay Group STRING — Both No The list of values comes
from the pay group foun­
dation objects that are
available in the system.

If you don't need this field,


you can set the visibility to
“none”.

Yes person Approver STRING — Both No Depending on what you


have selected in the
resolverType field,
you can either select a dy­
namic group here, a posi­
tion, or a specific person
as workflow approver. For
the person, the list of val­
ues comes from the users
that have been created in
the system.

Yes resolver­ Approver STRING — Both Yes In this field, you define who
Type Type should approve the work­
flow request. The possible
values are:

• Person
• Dynamic Group
• Position (if Position
Management is ena­
bled)

This field is always manda­


tory and visible; you can
only change the label.

2.4.2 Dynamic Role

Here is a list of the fields available for this element.

hris-element id: DynamicRole

Data Model Field Information for Employee Central


40 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more detailed
description of the dynamic
role than the short name
can provide, enter it here.

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different dy­
namic roles from each
other.

Yes name Name STRING 90 Both No You can enter a short


name for the dynamic role.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.4.3 Event Reason

Here is a list of the fields available for this element.

hris-element id: eventReason

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more de­
tailed description of the
pay grade than the short
name can provide, enter it
here.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 41
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes emplStatus EmplStatus STRING 45 None No You can use this field to
enter the change in sta­
tus that is causing the rele­
vant event. Example: “Ter­
mination” if the relevant
employee has left the com­
pany.

Yes end-date End Date DATE — None No You can also enter the date
the event reason stops be­
ing active.

Yes event Event STRING 45 Both Yes Use this field to describe
the event covered by this
event reason.

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different event
reasons from each other.

Yes implicit-po­ Follow-Up STRING 32 None No You can use this field to
sition-action Activity in specify which event rea­
Position sons trigger a follow-up ac­
tivity on the assigned po­
sition, such as reclassifica-
tion or transfer.

This field is relevant when


you have activated Posi­
tion Management. The list
of values comes from the
predefined picklist
positionActionType
.

Yes inside-work- Display in STRING 256 Both No You can define which
experience Internal Job event reason should be
History displayed in the Internal
Job History block in the
Employee Profile. This
block is a custom back­
ground block on the Em­
ployee Files page.

Yes name STRING 90 Both No You can enter a short


name for the event reason.

Data Model Field Information for Employee Central


42 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes payroll- Payroll STRING 4 Both No This field is required for


event Event payroll integration with
SAP ERP. It is used to store
additional events to those
delivered by SAP Success­
Factors. Leave the maxi­
mum length to 4. For more
information, refer to the
Employee Central Payroll
Implementation Guide.

Yes start-date Start Date DATE — Both Yes Enter the date the event
reason becomes active.

Yes status Status STRING — Both Yes Possible values are Active
and Inactive. Do not con­
figure this as a picklist.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Customer LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

2.4.4 WfConfig

Here is a list of the fields available for this element.

hris-element id: wfConfig

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 43
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes description Description STRING 128 Both No If you need a more detailed
description of the WFCon­
fig than the short name
can provide, enter it here.

Yes escalation Escalation Generic Ob­ — Both No You can use this for
ject the auto-escalation feature
based on the Escalation
MDF object.

Yes external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different work­
flow configurations from
each other.

Yes future- Alternate STRING — Both No See note for future-dated-


alternate-workflow after
dated-alter­ Workflow
table.
nate-work­
flow

Yes is-cc-link-to- Redirect CC BOOLEAN — Both No See note for is-cc-link-to-


approval- Users to approval-page below ta­
page Workflow ble.
Approval
Page

Yes is-delegate- Is Delegate BOOLEAN — Both No See note for is-delegate-


supported after table.
supported Supported

Yes name Name STRING 90 Both No You can enter a short


name for this WfConfig.

Yes remind-in­ Remind in LONG — Both No See note for remind-in­


days after table.
days Days

Yes custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
Yes custom- Custom DATE — None No
date1–10 Dates 1–10

Yes custom- Customer LONG — None No


long1–20 Numbers 1–
20

Data Model Field Information for Employee Central


44 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Note for: remind-in-days

This field is relevant when you set up reminder notifications with individual time spans for different workflow
foundation objects. Enter the number of days after which the workflow approver is reminded to take action on a
pending workflow.

Note that if you set up the time span for reminder notifications at quartz job level, you do not need to set up this
field in the Corporate Data Model as the system will ignore any entries made in this field.

Note for: is-delegate-supported

Select Yes to enable manual delegation or auto delegation of workflows.

For auto delegation, all incoming workflow requests are automatically redirected to the delegate the user has
selected in the My Info tile. For manual delegation, the approver can delegate the current workflow request for the
current workflow step to any system user. The approver can revoke this delegation later. If the delegate declines the
delegation, the workflow request is assigned back to the approver.

Note: This field is only supported when the workflow step approver type is Role and approver is configured with
Employee, Employee Manager, Employee Manager Manager, or Employee HR. It is not applicable when the workflow
step is configured with multiple approver roles, such as dynamic role, dynamic group or job relationship type roles
(matrix manager, custom manager, second manager and additional manager).

Note for: future-dated-alternate-workflow

You can configure an alternate workflow that is used for future-dated records; if there are no future-dated records,
or if this field has an invalid value, the main workflow is used. The list of values contains the workflow foundation
objects defined in the system.

Note for: is-cc-link-to-approval-page

When a workflow is completed, CC users are informed by e-mail or notification that contains a link. This field
defines to which page this link leads to.

If you select Yes, the link leads the CC users to the workflow approval page. If you select No, the link leads the CC
users to the Employment Information page.

2.4.5 wfConfig Contributor

Here is a list of the fields available for this element.

hris-element id: wfConfigContributor

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 45
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes actorRole Contributor STRING — Both Yes Select one of the following
contributors:

• Employee
• Employee Manager
• Employee Manager
Manager
• Employee HR
• Matrix Manager
• Custom Manager
• Second Manager
• Additional Manager

Yes actorType Contributor STRING 32 Both Yes Select one of the following
Type contributor types:

• Role
• Dynamic Role
• Dynamic Group
• Person
• Position

No context Context STRING 32 Both No When the transaction that


requires an approval im­
plies a manager change,
the context allows you to
determine which manager
has to approve:

• Source (the initial


manager)
• Target (the new man­
ager)

No description Description STRING 128 Both No If you need a more detailed


description of the WFCon­
fig Contributor than the
short name can provide,
enter it here.

No external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different con­
fig contributors from each
other.

Data Model Field Information for Employee Central


46 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

No name Name STRING 90 Both No You can enter a short


name for this config con­
tributor.

2.4.6 wfConfig CC

Here is a list of the fields available for this element.

hris-element id: wfConfigCC

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes actorRole CC Role STRING — Both Yes Select one of the following
CC roles:

• Employee
• Employee Manager
• Employee Manager
Manager
• Employee HR
• Matrix Manager
• Custom Manager
• Second Manager
• Additional Manager

Yes actorType CC Role STRING 32 Both Yes Select one of the following
Type CC role types:

• Role
• Dynamic Role
• Dynamic Group
• Person
• External Email
• Position

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 47
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

No context Context STRING 32 Both No When the transaction that


requires an approval im­
plies a manager change,
the context allows you to
determine which manager
has to approve:

• Source (the initial


manager)
• Target (the new man­
ager)

No description Description STRING 128 Both No If you need a more detailed


description of the CC Role
than the short name can
provide, enter it here.

No external­ Code STRING 32 Both Yes Define a unique code by


Code which the system can dis­
tinguish the different CC
Roles from each other.

No name Name STRING 90 Both No You can enter a short


name for this CC Role.

2.4.7 wf Step Approver

Here is a list of the fields available for this element.

hris-element id: wfStepApprover

Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes actionType Edit Trans­ STRING 256 None No See note for actionType be­
low.
action

Data Model Field Information for Employee Central


48 PUBLIC Foundation Object Tables
Max.
Standard Field ID Field Label Data Type Length Visibility Required How to Use this Field

Yes approver­ Approver STRING — Both Yes Select one of the following
Role Role approver roles:

• Employee
• Employee Manager
• Employee Manager
Manager
• Employee HR
• Matrix Manager
• Custom Manager
• Second Manager
• Additional Manager

Yes approver­ Approver STRING 32 Both No Select one of the following


Type Type approver types:

• Role
• Dynamic Role
• Dynamic Group
• Position

Yes context Context STRING 32 Both No When the transaction that


requires an approval im­
plies a manager change,
the context allows you to
determine which manager
has to approve:

• Source (the initial


manager)
• Target (the new man­
ager)

Yes skipType No Approver String 32 Both No See note for SkipType be­
Behavior low.

Note for actionType

When you create a new workflow, you have to define if the workflow step approver can edit the submitted workflow.
The options are:

• No Edit: The approver cannot edit an already submitted workflow. This is the standard option for an approver.
• Edit with Route Change: The approver can edit an already submitted workflow. The edited workflow will then
go through the approval process again from the beginning.
• Edit without Route Change: The approver can edit an already submitted workflow. The edited workflow will
then continue with the next step approver.

Data Model Field Information for Employee Central


Foundation Object Tables PUBLIC 49
Note for skipType:

Define how the system should react when there is an empty position or dynamic group:

• Stop the Workflow Workflow step is considered as mandatory step.


• Skip this Step Workflow step is skipped. This is the default system behavior

Both options are applied when:

1. Workflow step approver is not assigned in case of Role, and Dynamic Role with person resolver type.
2. Workflow step position has no incumbents in case of Position.
3. Workflow step dynamic group has no members in case of Dynamic Group.
4. Workflow step dynamic role is assigned to an empty position or an empty dynamic group.

Data Model Field Information for Employee Central


50 PUBLIC Foundation Object Tables
3 Person Object Tables

The tables in the list below give you the technical information about the person objects and their fields that are
relevant for Employee Central.

You can define these in the Succession Data Model and the country/region-specific Succession Data Model with
the XML file or Manage Business Configuration tool. You can find more information on these data models in the
Setting Up the Succession Data Model and Setting up Country/Region-Specific Data Models sections of the
Implemening Employee Central Core guide.

 Note

Beware that hiding all fields in a block using a business rule is not supported and will potentially cause
unexpected behavior in the system. You must have at least one field on this object enabled to avoid inconsistent
behavior.

When you refer to the following tables, consider the following:

• The standard XML file for the data models contains only a subset of these fields, but you can use all the fields
listed in these tables, for example, to override default attributes.
• Those fields listed in the tables, but not in the Succession Data Model, still appear on the UI if their default
visibility is set to “both”. If you want to hide those fields, add them to the corresponding data model and set
the visibility to “none”.
• For start-date, end-date, event-reason and event-reason-code, you cannot change the default
visibility. That means even if you change the visibility in the XML file for the Succession Data Model, the
system ignores this and the default visibility as listed in these tables is considered.
• Fields listed in the standard XML files, but not in these tables, are not relevant for Employee Central 2.0. You
should leave their visibility to “none”. Exceptions to this rule are customer-specific fields that you can use as
needed.

3.1 Person Objects A- Z

3.1.1 Addresses

Here is a list of the fields available for this element.

Addresses (hris-element-id: homeAddress)

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 51
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes item-id Item ID LONG — None No This field is used for inter­
nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No address- Address STRING 30 None No Do not configure this field


type Type in the data model as some
other data type.

The list of values


comes from the picklist
addressType. The pre­
configured list of values
contains the following:

• Home
• Mailing
• Benefits
• Payroll

You can add more


values to the picklist
addressType by export­
ing and importing the pick­
list using the Admin Tools.

Yes address1-25 Address 1– STRING 256 Both No You can enter 25 lines for
25 address here.

Yes city City STRING 256 Both No This is where you enter the
city or town the employee
lives in.

Yes county County STRING 256 Both No This is where you enter the
county the employee lives
in.

Yes state State STRING 256 Both No This is where you enter the
state the employee lives in.

No province Province STRING 256 Both No This is where you enter


the province the employee
lives in.

Data Model Field Information for Employee Central


52 PUBLIC Person Object Tables
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes zip-code Zip Code STRING 256 Both No This is where you enter the
ZIP code of the place the
employee lives in.

Yes country Country STRING 256 Both Yes The list of values comes
from the predefined pick­
list <country>.

 Note
You must not config-
ure any picklist or
child picklist for the
<country> field, as
this field is hard-coded
in the system.

If you want to define coun­


try-specific addresses,
configure the fields for the
corresponding country in
the homeAddress HRIS-
element in the country-
specific Succession Data
Model.

No address1– Alt1 Ad­ STRING 256 None No You can enter 25 lines for
alt1 (lines 1– dress1 the address in alternate
25) languages here, for exam­
ple, the employee's native
languages.

Address information can


be displayed in up to two
alternate language fields.
A link to the alternate lan­
guage fields is displayed in
"Edit" mode, and the non­
alternate language fields
are already filled with the
home address information
that has been entered be­
fore.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 53
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No city-alt1 Alt1 City STRING 256 None No You can enter the city or
town in alternate language
1 here.

No state-alt1 Alt1 State STRING 256 None No You can enter the state in
alternate language 1 here.

No province- Alt1 Prov­ STRING 256 None No You can enter the prov­
alt1 ince ince in alternate language
1 here.

No county-alt1 Alt 1 County STRING 256 None No You can enter the county in
alternate language 1 here.

No zip-code- Alt1 Zip STRING 256 None No You can enter the zip code
alt1 Code in alternate language 1
here.

No country-alt1 Alt1 Country STRING 256 None No You can enter the coun­
try in alternate language 1
here.

No address1– Alt2 Ad­ STRING 256 None No You can enter 25 lines for
alt2 (lines 1– dress 1 address in alternate lan­
25) guage 2 here.

No city-alt2 Alt2 City STRING 256 None No You can enter the city in al­
ternate language 2 here.

No state-alt2 Alt2 State STRING 256 None No You can enter the state in
alternate language 2 here.

No province- Alt12 Prov­ STRING 256 None No You can enter the prov­
alt2 ince ince in alternate language
2 here.

No county-alt2 Alt 2 County STRING 256 None No You can enter the county in
alternate language 2 here.

No zip-code- Alt2 Zip STRING 256 None No You can enter the zip code
alt2 Code in alternate language 2
here.

No country-alt2 Alt2 Coun­ STRING 256 None No You can enter the coun­
try try in alternate language 2
here.

Data Model Field Information for Employee Central


54 PUBLIC Person Object Tables
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes attachment- Attach­ LONG — Both No


 Note
id ments
This field can be
added either to the
SDM or the CSF SDM.
If the field is added to
SDM, then it is availa­
ble for all countries.

Attachments can be up­


loaded using this field.

Yes emp-users- Employ­ STRING 50 None No This field is filled with the
sys-id ment Users users_sys_id of the em­
Sys ID ployee on a global assign­
ment when a host country
address is created, thereby
linking the address to the
employment.

 Note
This field is never visi­
ble on the UI.

No end-date End Date DATE — None No This is the end date


the previous home ad­
dress stops being effec-
tive. The system calculates
the end date automatically
depending on the start
date entered.

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

 Note
This field can't be
displayed on the Em­
ployee Profile.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 55
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

No custom- Custom STRING 256 None No


string1-20- Strings 1–
alt1 20 in Lan­
guage 1

No custom- Custom DATE — None No


date1-10-alt1 Dates 1–10
in Language
1

No custom- Custom LONG — None No


long1-20- Numbers 1–
alt1 20 in Lan­
guage 1

No custom- Custom DOUBLE — None No


double1-20- Decimals 1–
alt1 20 in Lan­
guage 1

No custom- Custom STRING 256 None No You can use these fields
string1-20- Strings 1– for data for the second lan­
alt2 20 in Lan­ guage not covered by the
guage 2 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1-10- Dates 1–10
alt2 in Language
2

Data Model Field Information for Employee Central


56 PUBLIC Person Object Tables
The fields of this element are defined in the country-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- Custom DOUBLE — None No


double1-20- Decimals 1–
alt2 20 in Lan­
guage 2

No custom- Custom DOUBLE — None No


long1-20- Numbers 1–
alt2 20 in Lan­
guage 2

No script Script STRING 128 None No Picklist ID is


LANGUAGESCRIPTNAME
No script-alt1 Script in STRING 128 None No
Language 1

No script-alt2 Script in STRING 128 None No


Language 2

 Note

Two sets of alternate languages are supported for Addresses. Alternate fields can be enabled in the Succession
Data Model rather than in the Country/Region-Specific Data Model. Country/Region-Specific settings would
be ignored for alternate fields. Each alternate field represents some existing parent field in the element model
in alternate script. The alternate fields take the visibility and permission from the parent fields. If any of the
alternate fields have entries, they can be displayed on the screen. However, in edit mode, these fields are
automatically hidden.

3.1.2 Biographical Information

Here is a list of the fields available for this element.

Biographical Information (hris-element-id: personInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes attachment- Attach­ LONG — Both No If the biographical info of


id ments an employee has a docu­
ment such as birth certifi-
cate, this can be uploaded
in this field.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 57
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes birth-name Birth Name STRING 128 Both No You can enter the employ­
ee's birth name here, for
example: Smith.

This field is required if you


use payroll integration with
SAP ERP.

Note: If you have specified


a formal name format (us­
ing a birth-name) for your
legal entity and want to
replicate to SAP ERP, leave
this field in hris-element-
id: personlInfo empty and
specify the birth-name in
the hris-element-id: per­
sonalInfo instead.

Yes country-of- Country/ COUNTRY 100 Both No You can enter the employ­
birth Region Of ee's country of birth here.
Birth
By default, the list of val­
ues come from the prede­
fined MDF object "Coun­
try/Region".

Yes date-of- Date Of DATE — Both No You can enter the employ­
birth Birth ee's date of birth here.

Yes date-of- Date Of DATE — None No You can enter the employ­
death Death ee's date of death here.

Yes person-id- Person Id STRING 32 Both No This field contains the em­
external ployee ID. You can man­
ually assign employee IDs
or have system-generated
IDs. When you use sys­
tem-generated IDs, set the
visibility to “view” and
add the attribute allow-
import=”true”.

Data Model Field Information for Employee Central


58 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes place-of- Place Of STRING 100 Both No You can enter the town the
birth Birth employee was born, for ex­
ample: Chicago.

This field is required if you


use payroll integration with
SAP ERP.

Yes region-of- Region Of STRING 100 Both No You can enter the admin­
birth Birth istrative district where the
employee was born. This is
a free text field.

 Note
The behavior of
this field changes
when payroll integra­
tion is enabled in
your instance. The
system will dynam­
ically change the
field behavior based
on the value given
in the <country
of birth> field.
Also, depending on
the <country of
employment>, this
field may be made
mandatory. For more
information, refer to
the end of this docu­
ment.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 59
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes per-person- Person STRING 32 None No This field contains a


uuid UUID unique identifier of em­
ployees or their depend­
ents, which you can use
to integrate Person Data
with other modules like
Onboarding, Learning, Re­
cruiting, Talent, and so on.
You can manually assign a
value or have system-gen­
erated IDs.

To use with data im­


ports, set the visibil­
ity to “view” and
add the attribute allow-
import=”true”.

 Note
Once this field is
populated with a
value, it cannot be
changed.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Region of Birth

When payroll integration is enabled, the system may dynamically change region of birth field and override the data
model configuration. The following is a list of areas or countries affected by the behavior changes.

Data Model Field Information for Employee Central


60 PUBLIC Person Object Tables
Provisioning

The dynamic behavior of the <region-of-birth> field will be activated only when the instance the Enabled
Payroll Integration or Enable Employee Central Payroll feature is switched on in Provisioning.

 Remember

As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.

Countries Supported

If Country of Employment If Country of Birth matches,


matches, convert field to convert field to a picklist
Country (Country Code) mandatory? field? Picklist ID used

Italy (ITA) Yes Yes PROVINCE_ITA

France (FRA) Yes Yes DEPARTMENT_FRA

Venezuela (VEN) Yes Yes REGION_VEN

Brazil (BRA) No Yes STATE_BRA

Chile (CHL) No Yes REGION_CHL

Mandatory or Not

Italy France Venezuela Brazil Chile Other

region-of-birth is True True True Value in data Value in data Value in data
mandatory model model model
value =

Picklist or Not

Italy France Venezuela Brazil Chile Other

region-of-birth is True True True True True Value in data


picklist value = model

If no picklist ID is mentioned in the data model, then whenever the <country of birth> chosen is any of the
five countries, the region-of-birth field will be converted to a picklist field with corresponding picklist ID (which is
different for each of the five countries). For other countries, the field will remain as a free text. If a picklist ID is
mentioned in the data model, then the region-of-birth field will always be a picklist field irrespective of the value in
country of birth. The picklist ID will also remain same as the one mentioned in the data model.

Imports

When importing values, ensure that the correct values are filled out in the template.

• If the <region of birth> field has been assigned a picklist in the data model, then the standard procedure
for working with fields with picklist assignment must be followed while filling the import file
• If the field does not have any picklist assigned to it in the data model, then

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 61
• If payroll integration is activated and <country of birth> is one of the five countries mentioned earlier,
then use the external code of the corresponding picklist value while filling the import file
• Otherwise, you need to use free text while filling the import file

Current Behavior

• The picklist IDs are hard-coded in the system. They cannot be changed!
• The behavior is based on the current active effective-dated Job Information record. So, the behavior can
change for a user who has multiple job information records when the country of employment changes.
• This works only on Employee Profile page, and only for the employees, not their dependents.
• Does not work in the New Hire process.
• Does not work for future hires since this is based on the current active job information record.
• You must enter a country of birth for the country of employment - you cannot leave it empty.

3.1.3 Dependents

Here is a list of the fields available for this element.

Dependents (hris-element-id: personRelationshipInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes item-id Item ID LONG — None No This field is used for inter­
nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes attachment- Attach­ LONG — No No If the dependent of an em­


id ments ployee has a document
such as birth certificate,
this can be uploaded using
this field.

Data Model Field Information for Employee Central


62 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes is-accompa­ Accompany­ BOOLEAN — Both No When you add a global


nying-de­ ing assignment, you can se­
pendent lect this field in the
Dependents block to de­
termine if a dependent
joins the employee on the
global assignment.

Possible values are Yes and


No.

You must have activated


Global Assignments in the
Admin Center.

Yes is-address- Copy Ad­ BOOLEAN 3 None No If the address of an em­


same-as- dress from ployee’s dependent is the
person Employee same as the employee’s
address, you can select
Yes to copy the address
information for the de­
pendent. If the employ­
ee’s address subsequently
changes, this change is
not reflected in the de­
pendent's address infor­
mation unless you select
Yes again.

Yes is-benefi- Is Benefi- BOOLEAN — Both No When you add pension


ciary ciary payouts, you can select
this field to determine
whether a dependent is
the beneficiary of an em­
ployee’s pension payout in
the event of that employ­
ee's death. Possible values
are Yes and No.

You must have activated


Pension Payouts.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 63
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes relationship- Relationship STRING 50 Both Yes You have to define the rela­
type tionship of the dependent
to the employee.

The list of values comes


from the picklist
personRelationship
Type. Possible values are:

• Child
• Stepchild
• Child of Domestic
Partner
• Spouse
• Registered Partner
• Divorced Spouse
• Father
• Mother
• Brother
• Sister
• Related Persons
• Domestic Partner

No custom- Custom STRING 256 None No You can use these fields
string1–30 Strings 1– for data not covered by the
30 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–20 Dates 1–20

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

3.1.4 Direct Deposit


Direct Deposit is now replaced by the Payment Information and Payment Information Detail Generic Objects.

Direct Deposit (hris-element-id: directDeposit)

For more information, refer to the Employee Central Payment Information guide for details.

Data Model Field Information for Employee Central


64 PUBLIC Person Object Tables
3.1.5 Email

Here is a list of the fields available for this element.

Email (hris-element-id: emailInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes email-ad­ Email Ad­ STRING 100 Both Yes Enter an email address
dress dress here.

Yes email-type Email Type STRING 32 Both Yes Enter the type of
email address. The list
of values comes from
the predefined picklist
ecMailType and uses
the following values:

• Personal
• Business

Yes isPrimary Is Primary BOOLEAN 1 Both No Indicate if the email ad­


dress is the primary one.
Possible values are Yes and
No.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

3.1.6 Emergency Contact

Here is a list of the fields available for this element.

Emergency Contact (hris-element-id: emergencyContactPrimary)

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 65
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes address Address STRING 1000 Both No Enter the address of the
dependent here. This field
is only available for de­
pendents.

Yes dateOfBirth Date of Birth DATE None No Enter the date of birth of
the contact. This field is
only available for depend­
ents.

Yes ecNameAlt1 Name in Al­ STRING 256 None No Enter the name of the
ternate contact in alternate lan­
Character 1 guages. This field is only
available for dependents.

Yes ecNameAlt2 Name in Al­ STRING 256 None No Enter the name of the
ternate contact in alternate lan­
Character 2 guages. This field is only
available for dependents.

Yes email eMail STRING 100 None No Enter the email address of
the contact person.

Yes gender Gender STRING 2 None No You can define the gen­
der of the contact here.
This field is only available
when the person identified
in the Primary Emergency
Contact block is a depend­
ent. The list of values
comes from a predefined
picklist.

Yes isAddSa­ Copy Ad­ BOOLEAN None No Indicate whether the


meAsEm­ dress from emergency contact has
ployee Employee the same address as the
employee.

If the value is set to Yes,


the address is copied from
the employee's home ad­
dress, even if there are
multiple address types
listed for the employee.

This field is only available


for dependents.

Data Model Field Information for Employee Central


66 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes isDepend­ Dependent BOOLEAN None No Define whether the person


ent is a dependent of the em­
ployee.

Possible values are Yes and


No.

Yes isDisabled Disabled BOOLEAN None No You can indicate if the de­
pendent is disabled or not.
This field is only available
for dependents.

Possible values are Yes and


No.

Yes isEmergen­ Emergency BOOLEAN None No Define whether the person


cyContact Contact is an emergency contact of
the employee.

Possible values are Yes and


No.

Yes isStudent Student BOOLEAN None No You can indicate whether


the dependent is a stu­
dent. This field is only
available for dependents.

Possible values are Yes and


No.

Yes name Name STRING Both No You can enter the full name
of the contact person.

Yes phone Phone STRING 256 Both No Enter the phone number of
the contact person.

Yes second- Second STRING 256 Both No If the contact person or


phone Phone has a second phone num­
ber, you can add it here.

No pri­ Primary STRING 1 Both No One of the contacts you


mary_flag enter in this block must
be the primary emergency
contact. Possible values
are Yes and No.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 67
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes relationship Relationship STRING 50 Both No You can define the rela­
tionship of the contact
person with the employee.
The relationship can be
child, spouse, and so on.
The list of values comes
from the predefined pick­
list relation.

Yes custom- Emergency STRING 256 None No You can use these fields
string1 Contact for data not covered by the
Custom fields supplied as stand­
String 1 ard.

No custom- Custom STRING 256 None No


string2–20 Strings 2–
20

No custom- Custom DATE None No


date1–10 Dates 1–10

No custom- Custom LONG None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE None No


double1–20 Decimals 1–
20

3.1.7 Global Information

Here is a list of the fields available for this element.

Global Information (hris-element-id: globalInfo)

Data Model Field Information for Employee Central


68 PUBLIC Person Object Tables
The fields of this element are defined in the country/region-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No country Country/ COUNTRY Both Yes The country/region-spe­


Region cific fields shown as global
information depend on the
country you select here.

 Note
You must not config-
ure any picklist or
child picklist for the
<country> field, as
this field is hard-coded
in the system.

No end-date End Date DATE None No This is the end date the
previous global informa­
tion stops being effective.
The system calculates the
end date automatically de­
pending on the start date
entered.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 69
The fields of this element are defined in the country/region-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes gender­ Gender STRING 256 None No To collect country/region-


Country­
specific information re­
Specific
lated to genders, enable
this field and define a pick­
list that contains the gen­
der options for a coun­
try/region.

The picklist ID must


follow the format of
gender_XXX, where XXX
is a 3-letter ISO coun­
try/region code. Picklist
IDs in any other format are
ignored by the system.

It is recommended to
leave the <Gender> field
in Personal Information
empty if you choose to
maintain the country/re­
gion-specific field.

 Remember
Predefined picklists
of the country/region-
specific gender field
are available for Ger­
many and India.

See the picklists


with ID gender_DEU
and gender_IND
from Employee Central
Master Picklists. For
more information,
see Employee Central
Country/Region Spe­
cifics.

 Note
All configuration files
for Employee Cen­

Data Model Field Information for Employee Central


70 PUBLIC Person Object Tables
The fields of this element are defined in the country/region-specific Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

tral, for example,


master data models,
master picklists, as
well as country/re­
gion-specific files,
have moved from the
SAP Help Portal to
the Software Down­
load Center .

No generic­ Generic STRING 256 None No The data covered by


String1–30 String these fields is country/re­
gion-specific. You can find
No generi­ Generic DATE None No the fields defined for the
cDate1–20 Date corresponding country/re­
gion in the Country/Re­
No generi­ Generic LONG None No
gion-Specific Succession
cNumber1– Number
Data Model. These fields
40
are defined by SAP Suc­
cessFactors; you can't add
your own generic fields.

No custom- Custom STRING 256 None No You can use these fields
string1–30 Strings 1– for data not covered by the
30 fields supplied as stand­
ard.
No custom- Custom DATE None No
date1–20 Dates 1–20

No custom- Custom LONG None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE None No


double1–20 Decimals 1–
20

3.1.8 National ID Information

Here is a list of the fields available for this element.

National ID Info (hris-element-id: nationalIdCard)

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 71
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes attachment- Attach­ LONG — Both No If the national ID card of


id ments an employee has a docu­
ment such as passport or
other ID card, this can be
uploaded in this field.

Yes card-type National Id STRING 256 Both Yes Depending on the coun­
Card Type try/region selected, the
corresponding national ID
card type is displayed in
this field, for example:

• Social Security Num­


ber (for USA)
• Social Insurance
Number (for Canada)

Yes country Country STRING 100 Both Yes Select the country/region
in which the national ID
has been assigned from
the list of countries.

Yes isPrimary Is Primary BOOLEAN 1 Both No Indicate which national ID


is the primary one.

Yes isTemporary Temporary BOOLEAN 1 None No Indicate that a temporary


ID is available.
ID Available

Data Model Field Information for Employee Central


72 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes national-id National Id STRING 256 Both No Enter the number of the
national ID in the corre­
sponding format, for ex­
ample:

999–999–999

 Note
If you use only the
National ID field, then
it can be set as a re­
quired field. If you al­
low temporary IDs in
the system, then Na­
tional ID must not be
set to required.

You set up the country/re­


gion-specific format in
the country-specific Suc­
cession Data Model, where
you also define if the user
input is validated against a
specific format.

Yes temporary- Temporary STRING 256 None No Enter the temporary ID.
ID
id

Yes start-date Start Date — — Both No Enter the start date of the
validity period.

 Note
This field has
been deprecated and
should no longer be
used.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 73
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes end-date — — Both No Enter the start date of the


validity period.

 Note
This field has
been deprecated and
should no longer be
used.

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

 Note
This field can't be
displayed on the Em­
ployee Profile.

Yes cpam-id Cpam ID STRING 256 None No This field is specific to


France.

Yes deuev-code Deuev Code STRING 256 None No This field is specific to Ger­
many.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

3.1.9 Personal Information

Here is a list of the fields available for this element.

Personal Information (hris-element-id: personalInfo)

Data Model Field Information for Employee Central


74 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes aboriginal- Aboriginal BOOLEAN None No


person Person

Yes attachment- Attach­ LONG None No


id ments

Yes birth-name- Birth Name STRING 128 Both No Here you can enter the
alt1 Alt1 employee's birth name in
an alternate language.

 Note
The birth name must
first be enabled to
use the alternate lan­
guage fields. The ad­
min must also be
given permissions for
the alternate language
fields.

Yes birth-name- Birth Name STRING 128 Both No Here you can enter the
alt2 Alt2 employee's birth name in
an alternate language.

 Note
The birth name must
first be enabled to
use the alternate lan­
guage fields. The ad­
min must also be
given permissions for
the alternate language
fields.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 75
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes birth-name Birth Name STRING 128 Both No Here you can enter the
employee's birth name.

This field is required if you


use payroll integration with
SAP ERP.

Note: If you have speci­


fied a formal name format
(using a birth-name) for
your legal entity and want
to replicate to SAP ERP,
specify the birth-name in
the hris-element-id: per­
sonalInfo and leave birth-
name field in hris-element-
id: personlInfo empty.

Yes bilinguism- Bilingualism STRING 256 None No


code Code

Yes business- Business STRING 128 None No Here you can enter a busi­
first-name First Name ness first name that may
be needed in some coun­
tries or regions. For exam­
ple, if an employee keeps
using an original name in
business after the official
name is changed, you can
enter the original name as
the business name.

Yes business- Business STRING 128 None No Here you can enter a busi­
last-name Last Name ness last name that may
be needed in some coun­
tries or regions. For exam­
ple, if an employee keeps
using an original name in
business after the official
name is changed, you can
enter the original name as
the business name.

Yes business- Business STRING 128 None No Here you can enter a busi­
first-name- First Name
ness first name in an alter­
alt1 Alt1
nate language that may be
needed in some countries
or regions.

Data Model Field Information for Employee Central


76 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes business- Business STRING 128 None No Here you can enter a busi­
last-name- Last Name ness last name in an alter­
alt1 Alt1 nate language that may be
needed in some countries
or regions.

Yes business- Business STRING 128 None No Here you can enter a busi­
first-name- First Name ness first name in an alter­
alt2 Alt2 nate language that may be
needed in some countries
or regions.

Yes business- Business STRING 128 None No Here you can enter a busi­
last-name- Last Name ness last name in an alter­
alt2 Alt2 nate language that may be
needed in some countries
or regions.

Yes certificate- Certificate DATE — Both No Here you can enter the
start-date Start Date start date of the certificate
that confirms that the em­
ployee is challenged.

Yes certificate- Certificate DATE — Both No Here you can enter the
end-date End Date end date of the certificate
that confirms that the em­
ployee is challenged.

Yes challenge- Challenge STRING 1 Both No Here you can select if the
status Status employee is challenged.

Possible values are Yes and


No.

Yes community- Community SRING 256 None No


background Background

Yes country-of- Country/ STRING 256 None No


birth Region of
Birth

Yes date-of- Date of Birth DATE None No


birth

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 77
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes display- Display STRING 128 Both No Here you can enter the
name Name display name of the em­
ployee. For example, if an
employee with the official
Chinese name Shengjie
chooses to be called Ja­
son, you can enter Jason
as the display name.

 Note
This field is not used in
General Display Name.
General Display Name
uses a standard ele­
ment in Succession
Data Model - display­
Name. For more in­
formation, see Field
Requirements for the
User Data File.

Yes display- Display STRING 128 Both No Here you can enter an em­
name-alt1 Name Alt1 ployee's display name in a
second language.

Yes display- Display STRING 128 Both No Here you can enter an em­
name-alt2 Name Alt2 ployee's display name in a
third language.

Yes date-of- Date of DATE None No


death Death

Yes dateOfFirst­ Date of First DATE None No


EntryIn­ Entry in
France France

Yes disabled- Disabled BOOLEAN None No


veteran Veteran

No end-date End Date DATE None No This is the end date the
previous personal informa­
tion stops being effective.
The system calculates the
end date automatically de­
pending on the start date
entered.

Data Model Field Information for Employee Central


78 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes expected- Expected DATE None No


retirement- Retirement
date Date

Yes first-name First Name STRING 128 Both Yes Enter the employee's first
name here.

Yes first-name- Alt1 First STRING 128 Both No You can enter the employ­
alt1 Name ee's name in alternate lan­
guages used by the em­
ployee's native language.

You can enter the first


name in alternate lan­
guage 1 here.

Yes first-name- Alt2 First STRING 128 Both No You can enter the first
alt2 Name name in alternate lan­
guage 2 here.

Yes formal- Formal STRING 128 Both No Here you can enter the
name Name employee's formal name.

For external user integra­


tion in Learning, set this to
not mandatory.

Yes formal- Formal STRING 128 Both No Here you can enter an em­
name-alt1 Name Alt1 ployee's formal name in a
second language.

Yes formal- Formal STRING 128 Both No Here you can enter an em­
name-alt2 Name Alt2 ployee's formal name in a
third language.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 79
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes gender Gender STRING 2 Both No Do not configure this as a


picklist.

For external user integra­


tion in Learning, set this to
not mandatory.

The list of values of this


field is system-defined. By
default, the values are
"Male" and "Female". You
can enable the following
five values for the field
from the Upgrade Center:

• Male
• Female
• Unknown
• Undeclared
• Others

To enable this list:

1. Go to Upgrade

Center Optional

Upgrades .
2. Select Enhancement
to Gender Values –
Inclusion of Additional
Gender Values.

 Note
The changes
by the upgrade
can be reversed
within 10 days. To
reverse changes,
in the Upgrade
Center, select
View Recently
Completed
Upgrades. On the
Completed Up­
grades page, se­
lect Undo against

Data Model Field Information for Employee Central


80 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Enhancement to
Gender Values.

For rules to validate coun­


try/region-specific gender,
see Local Gender Rules.

Yes healthcare- Healthcare STRING 256 None No


no Number

Yes initials Initials STRING 128 Both No Here you can enter an em­
ployee's initials, for exam­
ple: J.D.

Yes is-overrid­ Customize STRING 128 Both No Here you can customize
den Name For­ the employee's name for­
mat mat, by selecting the
country whose name for­
mat you wish to use. You
can do this by clicking on
Options.

 Remember
If the changes to
employee's personal
information are man­
aged by workflows, to
edit an employee's for­
mal name in Personal
Information block, you
must enable the
<is-overridden>
field with the
Manage Business
Configuration tool or
the XML file.

Yes last-name Last Name STRING 128 Both Yes Enter the employee's last
name here.

Yes last-name- Alt1 Last STRING 128 Both No You can enter the last
alt1 Name name in alternate lan­
guage 1 here.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 81
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes last-name- Alt2 Last STRING 128 Both No You can enter the last
alt2 Name name in alternate lan­
guage 2 here.

Yes marital-sta­ Marital Sta­ STRING Both No The list of values comes
tus tus from the predefined pick­
list ecMaritalStatus
and contains the following
values:

• Married
• Single
• Divorced
• Widow
• Unknown
• Cohabitation
• Separated
• Head of Household
• Partnership
• Cohabitation with
Contract (Nether­
lands)
• Cohabitation with­
out Contract (Nether­
lands)
• PACS (France)

For external user integra­


tion in Learning, set this to
not mandatory.

Yes middle- Middle STRING 128 Both No You can enter the employ­
name Name ee's middle name here, if
existing.

Yes middle- Alt1 Middle STRING 128 Both No You can enter the mid­
name-alt1 Name dle name in alternate lan­
guage 1 here.

Yes middle- Alt2 Middle STRING 128 Both No You can enter the mid­
name-alt2 Name dle name in alternate lan­
guage 2 here.

Yes medal-vet­ Medal Vet­ BOOLEAN None No


eran eran

Data Model Field Information for Employee Central


82 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes name-for­ Name For­ STRING 128 Both No Here you can specify the
mat mat format of the employee's
name.

Yes name-for­ Name For­ STRING 128 Both No Users can select the name
mat-code mat Code format code from a list of
values at employee level.
The list shown in this field
is linked to the name for­
mat configuration object
of Employee Central. Each
format that is defined in
this object is shown in the
field and the user can de­
cide (on employee level)
which format is to be ap­
plied to their name.

Yes name-prefix Prefix PICKLIST 128 Both No Here you can select an
honorary title before the
employee's name if appli­
cable, for example van
or van der, and so on.
The list of values come
from a predefined picklist
nameprefix. This field
is getting converted from
a free text to a picklist
field. To get more details
on how to do the con­
version, refer to the an­
nouncement "New Picklist
for Name Prefix Field" un­
der Optional Upgrades in
Upgrade Center.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 83
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes nationality Nationality STRING 128 Both No You can enter the employ­
ee's nationality here, for
example:

• Germany
• USA

This field is required if you


use payroll integration with
SAP ERP.

For external user integra­


tion in Learning, set this to
not mandatory.

 Note
There are validations
in the system to check
the Nationality, Sec­
ond Nationality and
Third Nationality fields
avoid that incorrect
data is entered in
the fields. Nationality
and Second National­
ity cannot have the
same value in both
fields. The Third Na­
tionality can only be
entered if there is also
a Second Nationality.

If the information in
the Nationality fields
is provided from an
external system such
as Recruiting and/or
Onboarding 1.0 please
make sure that the
corresponding source
nationality fields are
mapped to the right
target fields with the
right meaning. Also
make sure that the na­
tionality fields do not
have the same value

Data Model Field Information for Employee Central


84 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

in all the nationality


fields.

Yes native-pre­ Native Pre­ STRING 256 Both No You can enter the prefer­
ferred-lang ferred Lang red native language of the
employee.

The list of values comes


from the predefined pick­
list Language. The exter­
nal code is the ISO 639
code for each language.
Stick to the ISO codes if
you consider integration
with SAP ERP.

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

 Note
This field can't be
displayed on the Em­
ployee Profile.

Yes partner- Partner STRING 128 Both No Here you can enter the
name Name name of your partner.

Yes partner- Partner PICKLIST 128 Both No Here you can select
name-prefix Name Prefix an honorary title before
the employee's partner's
name if applicable, for ex­
ample van or van der, and
so on. The list of values
come from a predefined
picklist nameprefix.

Yes preferred- Preferred STRING 128 Both No You can enter the employ­
name Name ee's chosen name or nick­
name.

You can also set the field


label as Chosen Name.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 85
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes protected- Protected BOOLEAN None No


veteran Veteran

Yes religion Religion STRING 256 None No

Yes script Language Both No You can enter the language


Script script.

Yes script-alt1 Language Both No You can enter the language


Script script for the first alternate
language.

Yes script-alt2 Language Both No You can enter the language


Script script for the second alter­
nate language.

Data Model Field Information for Employee Central


86 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes second-na­ Second Na­ STRING 128 Both No If the employee has a sec­
tionality tionality ond nationality, you can
enter it in this field.

 Note
There are validations
in the system to check
the Nationality, Sec­
ond Nationality and
Third Nationality fields
avoid that incorrect
data is entered in
the fields. Nationality
and Second National­
ity cannot have the
same value in both
fields. The Third Na­
tionality can only be
entered if there is also
a Second Nationality.

If the information in
the Nationality fields
is provided from an
external system such
as Recruiting and/or
Onboarding 1.0 please
make sure that the
corresponding source
nationality fields are
mapped to the right
target fields with the
right meaning. Also
make sure that the na­
tionality fields do not
have the same value
in all the nationality
fields.

Yes second-last- Second Last STRING 128 None No Enter the employee's sec­
Name
name ond last name here.

Yes separated- Separated BOOLEAN None No


veteran Veteran

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 87
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes since Marital Sta­ DATE 128 Both No You can enter the date
tus Since since when the marital sta­
tus you indicated in the
field marital-status
is valid.

Yes salutation Salutation STRING 128 None No The list of values comes
from the predefined pick­
list salutation and
contains the following
standard fields:

• Mr
• Mrs
• Ms

Yes second-title Second Title STRING 128 Both No Here you can enter the
second title, for example:
Phil. as the second title
of Dr. Phil. John Smith.

The list of values comes


from the predefined pick­
list secondtitle.

Yes suffix Suffix STRING 128 None No You can enter a name suf­
fix, such as Jr, Sr, PhD, and
so on.

The list of values comes


from the predefined pick­
list namesuffix.

Data Model Field Information for Employee Central


88 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes third-nation­ Third Na­ STRING 128 Both No If the employee has a third
ality tionality nationality, you can enter it
in this field.

 Note
There are validations
in the system to check
the Nationality, Sec­
ond Nationality and
Third Nationality fields
avoid that incorrect
data is entered in
the fields. Nationality
and Second National­
ity cannot have the
same value in both
fields. The Third Na­
tionality can only be
entered if there is also
a Second Nationality.

If the information in
the Nationality fields
is provided from an
external system such
as Recruiting and/or
Onboarding 1.0 please
make sure that the
corresponding source
nationality fields are
mapped to the right
target fields with the
right meaning. Also
make sure that the na­
tionality fields do not
have the same value
in all the nationality
fields.

Yes third-name Third Name 256 Both No If the person has a third
name, you can enter that
here.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 89
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes third-name- Third Name 256 Both No If the person has a third
alt1 name, you can enter that
here for the first alternate
language.

Yes third-name- Third Name 256 Both No If the person has a third
alt2 name, you can enter that
here for the second alter­
nate language.

Yes title Title STRING 128 Both No Here you can enter an em­
ployee's title, for example:
Dr. for Dr. John Smith.

The list of values comes


from the predefined pick­
list title.

Yes veteran Veteran BOOLEAN None No

Yes visible-mi­ Visible Mi­ BOOLEAN None No


nority nority

Yes custom- Preferred STRING 256 Both No You can enter the employ­
string1 Name ee's preferred name here.

No custom- Custom STRING 256 None No You can use these fields
string2–30 Strings 2– for data not covered by the
30 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–20 Dates 1–20

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

 Note

Two sets of alternate languages are supported for Personal Information. Alternate fields can be enabled in
the Succession Data Model rather than in the Country/Region-Specific Data Model. Country/Region-Specific
settings would be ignored for alternate fields. Each alternate field represents some existing parent field in the
element model in alternate script. The alternate fields take the visibility and permission from the parent fields.

Data Model Field Information for Employee Central


90 PUBLIC Person Object Tables
If any of the alt fields have entries, they can be displayed on the screen. However, in edit mode, these fields are
automatically hidden.

3.1.10 Phone Information

Here is a list of the fields available for this element.

Phone Information (hris-element-id: phoneInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes country- Country STRING 32 Both No You can enter the country
code Code code here, for example,
0049 for Germany.

Yes area-code Area Code STRING 32 Both No You can enter the code for
the region or state here.

Yes phone-num­ Phone Num­ STRING 100 Both Yes You can enter the phone
ber ber number here.

Yes extension Extension STRING 32 Both No You can enter the exten­
sion of the phone number
here.

Yes isPrimary Is Primary BOOLEAN 1 Both No You can indicate which


phone number is the pri­
mary one.

Yes phone-type Phone Type STRING 100 Both Yes The list of values
comes from the picklist
ecPhoneType and con­
tains the following values:

• Home
• Business
• Billing
• Cell
• Fax
• Private Mobile
• Other
• Shipping

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 91
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- Custom DATE — None No fields supplied as stand­


date1–10 Dates 1–10 ard.

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

3.1.11 Social Accounts

Here is a list of the fields available for this element.

Social Accounts (hris-element-id: imInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes domain Domain STRING 100 Both Yes You can select the in­
stant messaging domain
for your social account,
for example, Yahoo Mes­
senger, AOL Instant Mes­
senger, and so on.

You can add more domains


to the predefined picklist
imdomain.

Yes im-id Instant Mes­ STRING 100 Both Yes You can enter the ID that
saging ID identifies the user in the
instant messaging applica­
tion.

Yes url URL STRING 256 Both No You can enter the corre­
sponding URL to the in­
stant messaging domain
here.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20

Data Model Field Information for Employee Central


92 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- Custom DATE — None No fields supplied as stand­


date1–10 Dates 1–10 ard.

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

3.1.12 Work Permit Info

Here is a list of the fields available for this element.

Work Permit Info (hris-element-id: workPermitInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No attachment- Attach­ ATTACH­ — Both No You can upload a copy of


id ments MENT the work permit document
in different formats, for ex­
ample, .doc, .ppt, .png, and
so on.

Yes country Country STRING 256 Both No This field is used to cap­
ture the country/region for
which the document is
valid.

The list of values comes


from the predefined pick­
list ISOCountryList.

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 93
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes document- Document STRING 256 Both No The type of the document
type Type for which the ID needs to
be captured is given in this
field.

The list of values


comes from the prede­
fined cascading picklist
permitdoctype, which
is filtered based on the
country/region selected in
the country field.

Yes document- Document STRING 256 Both No You can enter the title of
title Title the document.

Yes document- Document STRING 256 Both No You can enter the number
number Number of the document.

No entity-type Entity-type STRING 32 None No


 Note
In Employee Central
V1, 3 entity types
were supported. With
Employee Central V2,
only 1 (Work Eligibility)
is supported and the
other types are obso­
lete. So this field is al­
ways automatically set
to Work Eligibility.

Since only 1 type is


supported, this is al­
ways set to not visible
in the system.

Yes expiration- Expiration DATE — Both No The work permit docu­


date Date ment is valid until this
date.

Yes issuing-au­ Issuing Au­ STRING 256 Both No You can enter the authority
thority thority that issued the document.

Yes issue-date Issue Date DATE — Both Yes Enter the date when the
document was issued.

Data Model Field Information for Employee Central


94 PUBLIC Person Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes issue-place Issue Place STRING 256 Both No You can enter the place
where the document was
issued.

Yes is-validated Validated BOOLEAN — Both No You can indicate if the


document has been vali­
dated by somebody. Possi­
ble values are Yes and No.

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

 Note
This field can't be
displayed on the Em­
ployee Profile.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Data Model Field Information for Employee Central


Person Object Tables PUBLIC 95
4 Employment Object Tables

The tables in the list below give you the technical information about the employment objects and their fields that
are relevant for Employee Central.

You can define these in the Succession Data Model and the country-specific Succession Data Model. You can find
more information on these data models in the Setting Up the Succession Data Model and Setting up Country/
Region-Specific Data Models sections of the SAP SuccessFactors Data Model Reference guide.

 Note

Beware that hiding all fields in a block using a business rule is not supported and will potentially cause
unexpected behavior in the system. You must have at least one field on this object enabled to avoid inconsistent
behavior.

When you refer to the following tables, consider the following:

• The standard XML file for the data models contains only a subset of these fields, but you can use all the fields
listed in these tables, for example, to override default attributes.
• Those fields listed in the tables, but not in the Succession Data Model, still appear on the UI if their default
visibility is set to “both”. If you want to hide those fields, add them to the corresponding data model and set
the visibility to “none”.
• For start-date, end-date, event-reason and event-reason-code, you cannot change the default
visibility. That means even if you change the visibility in the XML file for the Succession Data Model, the
system ignores this and the default visibility as listed in these tables is considered.
• Fields listed in the standard XML files, but not in these tables, are not relevant for Employee Central 2.0. You
should leave their visibility to “none”. Exceptions to this rule are customer-specific fields that you can use as
needed.

Related Information

Succession Data Model (SDM)

4.1 Employment Objects A - Z

4.1.1 Compensation Information

Here is a list of the fields available for this element.

Compensation Information (hris-element-id: compInfo)

Data Model Field Information for Employee Central


96 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes benefits- Benefits DOUBLE — None No This field is to show


the benefits calculation
rate Rate
for employees who have
highly variable compensa­
tion, for example, employ­
ees who work on commis­
sion. This calculation de­
termines their benefit cov­
erage.

Yes compa-ratio Compa-ratio DOUBLE — View No This field is calculated by


the system; leave the visi­
bility on “view”.

No event-rea­ Event-rea­ UNDEFINED — Both No If you have defined event


son-icode son-icode reason foundation objects,
this field contains the ex­
ternal code of those event
reasons.

Yes flsa-status US FLSA STRING 256 Both No This field is moving to


Status the country-specific data
model as it is US-specific.

Yes job-level Job Level STRING 256 Both No This field is not in use for
Employee Central 2.0 and
must be configured with
visibility “none”.

Yes is-eligible- Is Eligible BOOLEAN — None No You can indicate if the em­
for-benefits For Benefits ployee is eligible for bene­
fits. Possible values are Yes
and No.

Yes is-eligible- Is Eligible BOOLEAN — None No You can indicate if the em­
for-car For Car ployee is eligible for a com­
pany car. Possible values
are Yes and No.

Yes is-eligible- Is Eligible BOOLEAN — None No You can indicate if the em­
for-leave- for Leave ployee is eligible for leave
loading Loading loading. Possible values
are Yes and No.

Yes is-highly- Is Highly BOOLEAN — None No Here you indicate if an em­


compen­ Compen­ ployee is highly compen­
sated-em­ sated Em­ sated. Possible values are
ployee ployee Yes and No.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 97
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes is-insider Insider As BOOLEAN — None No This field helps you to


Defined By track insider trading on the
Statute stock market. You can de­
fine if an employee has
access to insider informa­
tion and is thus considered
an insider according to the
local insider law, for ex­
ample, the Securities Ex­
change Act in the USA.

Possible values are Yes and


No.

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

Yes pay-group Pay Group STRING — None No You can define the pay
group of the employee
here.

If you have defined pay


group foundation objects,
this field contains the ex­
ternal code of those pay
groups.

 Caution
Do not add picklists
for this field.

Yes pay-type Pay Type STRING 256 Both No The list of values for the
pay type is predefined by
picklist PayType. Possi­
ble values are salaried,
commissioned, and so on.

Yes payroll-id Payroll Id STRING 64 None No Here you can enter the
ID of the payroll that is
used to compensate the
employee.

Data Model Field Information for Employee Central


98 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes payroll-sys­ Payroll Sys­ STRING 32 None No Here you can enter the ID
tem-id tem Id of the payroll system used
for compensating the em­
ployee.

Yes pensiona­ Pensionable DOUBLE — None No You can enter an amount


ble-salary Salary that defines the employ­
ee's pensionable salary.

Yes range-pene­ Range Pene­ DOUBLE — View No This field is calculated by


tration tration the system; leave the visi­
bility on “view”.

Yes salary Salary SALARY — Both No This field is not in use for
Employee Central 2.0 and
must be configured with
visibility “none”.

In Employee Central 1.0,


this field was a combina­
tion of
salaryRateType,
salaryRateUnits and
salaryCurrencyCode
. This field has been re­
placed with Recurring Pay
Components in Employee
Central 2.0.

Yes salaryRate­ Salary Rate STRING 50 Both No This field is not in use for
Type Type Employee Central 2.0 and
must be configured with
visibility “none”.

Yes salaryRa­ Salary Rate LONG — Both No This field is not in use for
teUnits Units Employee Central 2.0 and
must be configured with
visibility “none”.

Yes salaryCur­ Currency STRING 20 Both No This field is not in use for
rencyCode Employee Central 2.0 and
must be configured with
visibility “none”.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 99
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes seq-number Sequence LONG — Both No This field tells you the se­
quence of transactions for
Number
that day, for example, 1 of
2, 2 of 2. This field is only
required for import, and
will appear in the import
template if you have ena­
bled the field.

No custom- Custom STRING 256 None No You can use these fields
string1–100 Strings 1– for data not covered by the
100 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–30 Dates 1–30

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

 Note

In compensation information as well as recurring and non-recurring payments, fields of type DOUBLE can now
be hidden. To do this, set the pii field to TRUE (pii="true"). This allows the users to decide for themselves what
information is visible and prevents unauthorized eyes from seeing the information by mistake.

4.1.2 Employee Information

Here is a list of the fields available for this element.

Employee Information (hris-element-id: userAccountInfo)

Data Model Field Information for Employee Central


100 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes user-name User Name STRING 32 None Yes You can enter a unique
user name for new em­
ployees during the hire
process. This value is
also displayed on the
Username field on the Tal­
ent Profile page.

If this field has visibil­


ity=”both”, but no value
is entered during the new
hire process, the system
copies over the value from
the Person Id field. This is
also the standard behavior
if userAccountInfo is
not contained in the Suc­
cession Data Model.

4.1.3 Employment Information

Here is a list of the fields available for this element.

Employment Information (hris-element-id: employmentInfo)

See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes assignment- Assignment STRING 256 Both Yes This is an identifier for
id-external ID external the employment of a user
and can be used for inte­
grations with external sys­
tems. It is unique and
case-sensitive.

This is a multipurpose field


that can be used for differ-
ent scenarios.

Yes benefits-eli- Benefits Eli­ DATE — Both No This is the start date from
gibility- gibility Start which the employee is eli­
start-date Date gible for benefits.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 101
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes company New Assign­ STRING 256 Both Yes This field is required when
ment Com­ you have enabled Concur­
pany rent Employment.

Here you define the com­


pany where the concurrent
employment takes place; it
can be the same company
as specified for the exist­
ing employment.

Yes companyEx­ Company DATE — None Yes It is important to have this


itDate Exit Date field filled out when an
employee leaves the com­
pany. From this date, the
legal obligation period for
when to purge the user
can be calculated.

Yes eligibleFor­ Eligible for BOOLEAN — Both No You can indicate if the em­
Stock Stock ployee is eligible for stock.

Possible values are Yes and


No.

No employee­ Employee's BOOLEAN 10 None No The field indicates whether


FirstEm­ First Em­ this is the employee’s first
ployment ployment employment or not.

Yes firstDate- First Date STRING 256 Both No You can enter the employ­
Worked Worked ee’s first date at the com­
pany here.

If you use payroll integra­


tion with SAP ERP, this
field is required for legal
reporting in the USA.

Yes initialOp­ Initial Op­ LONG — Both No This is the initial number of
tionGrant tion Grant options granted to the em­
ployee.

Yes initialStock­ Initial Stock LONG — Both No This is the initial number of
Grant Grant stocks granted to the em­
ployee.

Data Model Field Information for Employee Central


102 PUBLIC Employment Object Tables
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No isContin­ Is Contin­ BOOLEAN 1 View No This field is used to denote


gentWorker gent Worker that a user is an external
worker.

 Note
Only enable this field if
contingent workforce
is enabled in your sys­
tem.

If the isContingent­
Worker field is present
in employmentInfo
HRIS Element, ensure
that its Visibility prop­
erty is set to View and
Allow Import is set
to Yes to avoid valida­
tions while saving your
changes.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 103
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes isECRecord Is EC Record FIXED 1 Both No This field is system gen­


erated and is used to dif­
ferentiate Employee Cen­
tral users from other Em­
ployee Profile users who
have no Employee Central
data.

For an Employee Profile


user the value is set to 0.

If a user is created using


the Hire Wizard or any
Employee Central Employ­
ment wizard (Add New
Employee, Manage Pend­
ing Hire, Add Contingent
Worker, Add Global Assign­
ment, Add Concurrent Em­
ployment), this value will
be set to 1, to indicate that
they are an Employee Cen­
tral user.

If a user is created from


an import, they have to
have their data imported
in the correct sequence to
be marked as an Employee
Central user and have the
value set to 1.

If they are not imported


in the correct order, the
system will not mark them
as an Employee Central
user and they will not be
included in Employee Cen­
tral functions, for exam­
ple, their data will not be
synced in the HRIS Sync.

The only way to correct


this is to FULL PURGE im­
port their data in the cor­
rect order.

Data Model Field Information for Employee Central


104 PUBLIC Employment Object Tables
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

The field is not visible in


the UI and can either be re­
ported on using Advanced
Reporting or checked in
the Integration Center.

Yes isPrimary Is Primary BOOLEAN — Both No


 Note
You cannot use this
field because it has
been deprecated.

Yes jobCredit Job Credit STRING — Both No The job credit corresponds
to the seniority an em­
ployee can acquire before
joining the company.

Yes jobNumber Employ­ STRING — View No This field has significance


ment Id when we implement multi­
ple jobs concept, until then
it is defaulted to 1.

Yes original­ Original DATE — Both No If the employee has been


StartDate Start Date working for the company
before, enter the date of
the first hire in the organi­
zation in this field.

No notes Note STRING 4000 Both No This is a text field where


the user can enter ad­
ditional information if re­
quired.

Yes prevEm­ Previous STRING — Both No This field shows the pre­
ployeeId Employ­ vious employee ID if the
ment ID employee has been at the
company before. The new
ID differs from the old ID,
because the employee is
considered as a new hire,
even if the employee has
worked for the same com­
pany before.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 105
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes primaryEm­ Primary Em­ DATE — None No This is a transient field


ployment
ployment­ used for Concurrent Em­
Date
Date ployment, when updating
primary and secondary
employments.

Yes professio­ Professional DATE — Both No You can use this field to
track dates for professio­
nalService­ Service Date
nal experience.
Date

Yes seniority­ Seniority DATE — Both No This is the date from which
Date Start Date seniority should be calcu­
lated.

Yes serviceDate Service Date DATE — Both No You can use this date to
grandfather service to re­
hired employees. In rare
cases, a job credit is given
to an employee and serv­
ice date is adjusted. For ex­
ample, if an employee is
rehired with less than a 6-
month break, the service
date is set to the original
hire date.

Yes start-date Hire Date DATE — Both Yes Enter the date of the cur­
rent hire for an employ­
ment.

Data Model Field Information for Employee Central


106 PUBLIC Employment Object Tables
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes sourceOfRe­ Source of STRING — None Yes This field is required for
cord Record integration between Em­
ployee Central and SAP
ERP as well to Integration
Center.

The list of values comes


from the sourceOfRecord
picklist. The picklist must
contain the values "EC",
"ONB", as well as any val­
ues for each external sys­
tem where employee data
is recorded. For technical
reasons, the values for
the picklist cannot contain
commas.

Picklists are in the Soft­


ware Download Center.

 Note
All configuration files
for Employee Cen­
tral, for example,
master data models,
master picklists, as
well as country/re­
gion-specific files,
have moved from the
SAP Help Portal to
the Software Down­
load Center .

You update picklists in

Admin Center Picklist

Center .

No custom- — STRING 256 None No You can use these fields


string1–15 for data not covered by the
and custom- fields supplied as stand­
string21–80 ard.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 107
See also Termination Information table further below

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- — DATE — None No


date1–5,
custom-
date21–30,
custom-
date41-65

No custom- — LONG — None No


long1–10

No custom- — DOUBLE — None No


double1–10

 Note

The <isRehire> field is a transient field used during import when a user is created for the Rehire with New
Employment scenario. This value is not saved to the database, it is only needed for the import.

4.1.4 Global Assignment Details

Here is a list of the fields available for this element.

Global Assignment Details (hris-element-id: globalAssignmentInfo)

To use the Global Assignment Details block, you have to turn on Global Assignments in the Admin Center.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes assignmen­ Assignment STRING 256 Both Yes This is an identifier for
tIDExternal ID external the employment of a user
and can be used for inte­
grations with external sys­
tems. It is unique and
case-sensitive.

Yes assignment- Assignment STRING 128 Both Yes Select the type of the
type Type global assignment. The list
of values comes from the
picklist
global_assignment_
type.

Data Model Field Information for Employee Central


108 PUBLIC Employment Object Tables
To use the Global Assignment Details block, you have to turn on Global Assignments in the Admin Center.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes company Company STRING 256 Both Yes Enter the company the
employee goes to for the
global assignment. You
can choose from the com­
panies that are available in
the system.

Yes end-date Actual End DATE — Both Yes When you end a global
Date assignment, you need to
specify the actual end
date. The date cannot be
empty.

Yes planned- Planned End DATE — Both Yes Enter the date when the
end-date Date global assignment is sup­
posed to end.

No payroll-end- Payroll End DATE — Both No The date of the last payroll
date Date for the global assignment.

No custom- — STRING 256 None No You can use these fields


string101– for data not covered by the
115 and cus­ fields supplied as stand­
tom- ard.
string116–
The first 5 customer—spe­
120
cific field numbers are
used to add a global as­
No custom- — DATE — None No
signment, the last 5 cus­
date31–35
tom field numbers are
and custom-
used to end a global as­
date36–40
signment.
No custom- — LONG — None No
long21–25
and custom-
long26–30

No custom- — DOUBLE — None No


double21–
25 and cus­
tom-dou­
ble26–30

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 109
4.1.5 Job Information

Here is a list of the fields available for this element.

Job Information (hris-element-id: jobInfo)

 Note

If a field is not defined in the data model, it cannot be used in business rules.

 Remember

As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.

Max. Default Vis­ Is Re­


Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

No acquired- Acquired- STRING — None No You can enter the former


from-com­ from-com­ company the employee
pany pany used to work in before join­
ing the current company.

No additional- Additional- HRIS_FIN­ 384 None No This field was previously


used to enter an additional
manager manager DUSER
manager for the employee.

No address Address LONG — None No


 Note
This field has been
deprecated and can
no longer be used.

Yes amount-of- Amount Of DOUBLE — None No This field was previously


used to indicate whether
financial- Financial
an employee is eligible for
plan Plan
the financial plan, you can
indicate the amount that is
planned.

 Note
This field has been
deprecated and can
no longer be used.

No attachment- Attachment- LONG — None No Use this field to upload any


id id attachments.

Data Model Field Information for Employee Central


110 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes business- Business STRING — None Yes If you have defined busi­
unit Unit ness unit foundation ob­
jects, this field contains
the external code of those
business units.

Yes company Company STRING — None Yes This is the company or le­
gal entity where the em­
ployee is hired.

The country of the le­


gal entity determines the
country-specific attributes
displayed in the Job
Information block.

If you have defined legal


entity foundation objects,
this field contains the ex­
ternal code of those legal
entities.

Yes company- Company STRING — None No If an employee leaves the


company, you can track
leaving-for Leaving For
the new company of the
employee.

Yes contract- Contract DATE 0 Both No Enter the date in which the
end-date End Date contract ends.

Yes cost-center Cost Center STRING — None No If you have defined cost
center foundation objects,
this field contains the ex­
ternal code of those cost
centers.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 111
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes country-of- Country STRING 256 View No This field contains the
company country the company is
located in. The values
are derived from the
country (territory ID) of
the legal entity, showing
the values from the pick­
list ISOCountryList.
The field cannot be
edited. Fields in the sec­
tion Job Information
can use the picklist
ISOCountryList as
parent picklist, for ex­
ample for the hris-field
notice-period. In this
case it is mandatory that
the field country-of-
company is visible in the
same block as the field us­
ing this picklist as parent
picklist.

Yes default- Default STRING — None No This field is relevant for the
overtime- Overtime Employee Central Payroll
compensa­ Compensa­ Time Sheet.
tion-variant tion Variant
Set this field to define the
form of the overtime com­
pensation received by em­
ployees.

Yes department Department STRING 128 Both No If you have defined depart­
ment foundation objects,
this field contains the ex­
ternal code of those de­
partments.

Data Model Field Information for Employee Central


112 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes division Division STRING 128 Both No If you have defined divi­
sion foundation objects,
this field contains the ex­
ternal code of those divi­
sions.

This field is synced to the


standard element 'division'
in the Employee Profile.

Yes dynamic- Dynamic STRING 256 Both No For the payroll time sheet,
break-con­ Break Con­ you can specify that a dy­
fig-code figuration namic break rule is applied
on days where no breaks
are configured in the em­
ployee’s work schedule.
For those days, a dynamic
break rule will automati­
cally create breaks after a
specific number of hours
of working time.

Yes eeo-class EEO Class STRING 256 Both No You can define the class
for equal employment op­
portunities.

The list of values comes


from the predefined pick­
list eeo-class.

Yes employee- Employee STRING 256 None No This field indicates if the
class Class worker is an employee, a
contractor, an intern, and
so on.

The list of values comes


from the predefined pick­
list EMPLOYEECLASS.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 113
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

employee- Employee PICKLIST 256 Both No Here you can specify


notice-pe­ Notice Pe­ the notice period the em­
riod riod ployee must give or follow
when he/she wants to quit
their job (leave the com­
pany).

 Note
This field can be
used with a cas­
cading picklist. You
can enable this
in Manage Business
Configuration. If you
do that, you must as­
sign the <country-
of-company> as the
parent picklist.

In the Picklist Center,


the picklist ID must be
edited to accept coun­
try-specific values. As­
sign the ISOCountry­
List picklist ID to the
<Parent Picklist>
field.

Yes employee- Employee STRING 100 Both No You can define whether the
type Type employee type is hourly,
salaried, exception hourly,
not applicable, and so on.

The list of values comes


from the predefined pick­
list employee-type.

Yes employ­ Employ­ STRING 32 None No This is a customer configu-


rable picklist to track types
ment-type ment Type
of employment, for exam­
ple, apprentice, full-time,
and so on.

Data Model Field Information for Employee Central


114 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

No emplStatus EmplStatus STRING — None No This is a fixed picklist to in­


dicate employment status,
for example, Active, Paid
Leave, Unpaid Leave, Sus­
pended, Terminated, and
so on.

This cannot be changed by


the customer.

Yes ern-number Employee LONG — None No


 Note
Record
Number This field has been
deprecated and can
no longer be used.

No event Event STRING — Both No This field indicates the


event that has led to the
change of the job informa­
tion.

The list of values comes


from the predefined pick­
list event. You can
change the labels for the
events in this picklist, but
you cannot add additional
events.

No event-rea­ Event-rea­ LONG — Both No This is the reason for the


son son-code change of the job informa­
tion.

If you have defined event


reason foundation objects,
this field contains the ex­
ternal code of those event
reasons.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 115
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

No expected- Expected- DATE — None No If an employee is on a


leave of absence, then this
return-date return-date
field can be used to record
the planned return date.

 Note
This field will only be
displayed for leave of
absence job history re­
cords.

Yes fte FTE DOUBLE — None No This is a calculated field


that cannot be updated
manually. It is hard coded
in the system that FTE is
calculated according to a
cascading logic based on
the default working hours
(position, job, location, le­
gal entity).

FTE stands for “full-time


equivalent” and indicates
an employee's working
hours or a legal entity's
standard working hours.

No govt-grant- Govt-grant- DOUBLE 4000 None No


 Note
amount amount
This field has been
deprecated and can
no longer be used.

No hire-source Hire-source STRING — None No This field can be used to


track the source of the
hire, for example, internet
ad or newspaper ad.

No hire-source- Hire-source- STRING — None No This is a customer config-


urable picklist. This is a
details details
sub-grouping of the Hire
Source field. If the source
was a newspaper, then this
field can be used to say
which newspaper.

Data Model Field Information for Employee Central


116 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes holiday-cal­ Holiday Cal­ STRING — None No This field is relevant for
endar-code endar Time Off.

A holiday calendar shows


the public holidays for a
given period and country.

If you have defined holiday


calendar generic objects,
this field contains the ex­
ternal code and name of
those holiday calendars.

Yes hr-manager HR Manager STRING None No


 Note
This field is not sup­
ported by Employee
Central and should
never be enabled for
it.

This field does not appear


on the UI. Leave the visibil­
ity to “none” to prevent
this field from showing up
in the role-based permis­
sions setup.

Yes interna­ Interna­ STRING 256 None No


 Note
tional-org- tional Org
code Code This field is depre­
cated and can no lon­
ger be used.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 117
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes is-competi­ Competition BOOLEAN — None No Set this field to indicate


tion-clause- Clause whether a competition
active clause has been defined
for the employee. A com­
petition clause is an agree­
ment restricting an em­
ployee who leaves the
enterprise from acquiring
employment with a com­
petitor within a specific in­
dustry, or period of time.

Possible values are Yes and


No.

Yes is-cross- Is Cross BOOLEAN — None No You can indicate if the em­
border- Border ployee is a cross-border
worker Worker worker.

Possible values are Yes and


No.

Yes is-eligible- Is Eligible BOOLEAN — None No This field was previously


used to indicate whether
for-benefit For Benefit
the employee is eligible for
company benefits.

This information should


now be set in Compensa­
tion Information.

Yes is-eligible- Is Eligible BOOLEAN — None No This field was previously


used to indicate whether
for-car For Car
the employee is eligible for
a company car.

This information should


now be set in Compensa­
tion Information.

Yes is-eligible- Is Eligible BOOLEAN — None No You can indicate whether


the employee is eligible for
for-finan- For Financial
a company financial plan.
cial-plan Plan

Yes is-fulltime- Is Fulltime BOOLEAN — None No You can indicate if the em­
employee Employee ployee is a full-time em­
ployee.

Possible values are Yes and


No.

Data Model Field Information for Employee Central


118 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

No is-home- Is-home- BOOLEAN — None No You can indicate if the em­


worker worker ployee works from home.

Yes is-primary Is Primary BOOLEAN — None No This field was previously


used to track the primary
job if an employee had
multiple jobs in the com­
pany.

This can now be tracked


in the UI for Concurrent
Employment by setting
main and secondary em­
ployment.

Yes is-shift-em­ Is Shift Em­ BOOLEAN — None No This is where you indicate
ployee ployee if the employee works in
shift.

Yes is-side-line- Sideline Job BOOLEAN — None No This field indicates if the
job-allowed Allowed employee is allowed to
take up a sideline job sup­
plementary to the employ­
ee's main occupation.

Possible values are Yes and


No.

No is-volunteer Is-volunteer BOOLEAN — None No You can use this field to


indicate whether an em­
ployee is a volunteer.

Yes job-code Job Classifi- STRING 128 Both Yes This is the job classifica-
cation tion of the employee.

If you have defined job


classification foundation
objects, this field contains
the external code of those
job classifications.

This field is synced to the


standard element 'jobCo­
de' of the Employee Pro­
file.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 119
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes job-title Job Title STRING 256 Both No This field is automatically
filled with the job title de­
fined in the job classifica-
tion foundation object.

This field is synced to the


standard element 'title' of
the Employee Profile.

No job-request- Job-re­ LONG — None No This field can be used to


track the job requisition ID
number quest-num­
in a recruiting system.
ber

Yes local-job-ti­ Local Job Ti­ STRING 256 None No Here you can enter the lo­
tle tle cal job title if it differs from
the company-wide used
job title.

Yes location Location STRING 128 Both No If you have defined loca­
tion foundation objects,
this field contains the ex­
ternal code of those loca­
tions.

Yes manager Manager STRING None No This field does not appear
on the UI. Leave the visibil­
ity to “none” to prevent
this field from showing up
in the role-based permis­
sions setup.

Yes manager- Manager STRING 256 None No This is customer configu-


rable picklist to categorize
category Category
manager types.

Yes manager-id Supervisor HRIS_FIN­ 384 Both No You can choose from the
DUSER list of existing users in the
system to identify the em­
ployee's manager. This in­
formation is then used to
build the Org Chart.

This field is synced to the


standard element 'mana­
gerId' of the Employee Pro­
file.

Data Model Field Information for Employee Central


120 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes notes Note STRING 4000 Both No This is a text field where
the user can enter ad­
ditional information if re­
quired.

No notice-pe­ Notice Pe­ STRING 256 Both No In this field you define
riod riod the amount of time that
must be given, by either
an employer or an em­
ployee, before the date
on which the work agree­
ment is terminated. The
list of values comes from
the predefined picklist
NOTICEPERI.

As you can use this


field country depend­
ent, you can create
country-dependent values
by using the picklist
ISOCountryList as
parent picklist.

Yes pay-grade Pay Grade STRING 256 None No If you have defined pay
grade foundation objects,
this field contains the ex­
ternal code of those pay
grades.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 121
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes pay-group Pay Group STRING 256 None No This field is not to be
used. Leave the visibility
to “none” to prevent this
field from showing up in
the role-based permission
setup.

 Note
This field is depre­
cated and can no lon­
ger be used. In addi­
tion, this field is not
supported for any fea­
tures released after Q1
2017.

Do not use this field


if you are integrating
with Employee Cen­
tral Payroll or SAP
HCM Suite. Instead,
please use the field
pay-group in Compen­
sation Information.

Data Model Field Information for Employee Central


122 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes paySca­ Pay Scale STRING 256 None No This is the pay scale area
leArea Area
to which the employee is
assigned.

If you have defined pay


scale area generic objects,
this field contains the ex­
ternal code of those pay
scale areas.

 Note
Customers who use a
picklist for this object
should migrate this
picklist to foundation
objects using the Pro­
visioning job “Initialize
migration of picklist
fields payscale area
and type to MDF ob­
jects”. New customers
should not use a pick­
list for this field.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 123
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes payScale­ Pay Scale STRING 256 None No This is the pay scale type
Type Type
to which the employee is
assigned.

If you have defined pay


scale type generic objects,
this field contains the ex­
ternal code of those pay
scale types.

 Note
Customers who use a
picklist for this object
should migrate this
picklist to foundation
objects using the Pro­
visioning job “Initialize
migration of picklist
fields payscale area
and type to MDF ob­
jects”. New customers
should not use a pick­
list for this field.

Yes paySca­ Pay Scale STRING 256 None No This is the pay scale group
leGroup Group
to which the employee is
assigned.

If you have defined pay


scale group generic ob­
jects, this field contains
the external code of those
pay scale groups.

Yes payScaleLe­ Pay Scale STRING 256 None No This is the pay scale level
vel Level
to which the employee is
assigned.

If you have defined pay


scale level generic objects,
this field contains the ex­
ternal code of those pay
scale levels.

Data Model Field Information for Employee Central


124 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

No pm-form PM Form DECIMAL 34 None No This field stores the ID of a


Performance Management
form that was generated
as the result of a Smart­
Suite event. This is used
for integration with the
Talent module. The field
is for technical purposes
only and shouldn't be dis­
played on the Job Informa­
tion UI, meaning no view
or edit permissions should
be granted for this field.
This isn't supported and
will lead to the unwanted
generation of a new form
every time a Job Informa­
tion record with an existing
value is edited in the His­
tory UI.

Yes position Position LONG — None No This field is only shown


when you have activated
Position Management.

Yes probation- Probation­ DATE — None No Here you enter the end
period-end- ary Period date of the employee's
date End Date probationary period.

Yes radford-job­ Radford STRING 128 Both No These are standardized job
codes from the Radford
code JobCode
consulting company.

Yes refresh- Enable STRING 128 Both Yes The new property indi­
comp-re­ Compensa­ cates whether the corre­
quired tion Refresh sponding field needs to
trigger the refresh of
compensation information
when there is a change in
the job information.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 125
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes regular- Regular/ STRING 32 None No This field indicates


temp Temporary whether the employee is
regular or temporary.

The list of values comes


from the predefined pick­
list regular-temp.

Yes seq-number Sequence LONG — Both Yes This field tells you the se­
quence of transactions for
Number
that day, for example, 1 of
2, 2 of 2.

Yes shift-code Shift Code STRING 256 None No The shift code indicates in
which shift the employee
works in.

Yes shift-factor Shift Per­ DOUBLE — None No This field indicates the
compensation multiplier
cent
for working a specific shift,
for example, 1.5 for a
weekend day or holiday.

Yes shift-rate Shift Rate DOUBLE — None No This field indicates the dif­
ferential for a specific shift,
for example, on a weekend
or holiday.

Yes sick-pay- Sick Pay STRING 256 Both No This field indicates if the
supplement Supplement employee gets an addi­
tional payment when on
sick leave. Continued pay
is affected when an em­
ployee is unable to work.

The list of values comes


from the predefined
picklist SICKPAYSUPP.
As you can use this
field country depend­
ent, you can create
country-dependent values
by using the picklist
ISOCountryList as
parent picklist.

Data Model Field Information for Employee Central


126 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes standard- Standard DOUBLE — None No You can define the stand­
hours Weekly ard weekly hours the em­
Hours ployee is supposed to
work. This should be the
same amount as defined in
the employee's contract.

Yes supervisor- Supervisor STRING 256 None No This is a customer config-


urable picklist for custom­
level Level
ers who want to categorize
supervisory levels.

Yes time-record­ Time Re­ STRING — None No This field is relevant for the
ing-admissi­ cording Ad­ Employee Central Payroll
bility-code missibility Time Sheet.

This field allows you to


define time recording ad­
missibility rules for individ­
ual employees - controlling
whether employees can
amend time sheet data
in the past and whether
they can amend already-
approved time sheets.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 127
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes time-record­ Time Re­ STRING — None No This field is relevant for the
ing-profile- cording Pro­ Employee Central Payroll
code file Time Sheet.

The Time Recording Pro­


file contains employee-
specific settings for the
Employee Central Payroll
Time Sheet.

It sets the time recording


method and the time valu­
ation rules which are used
for this employee. If you
have defined time record­
ing profile generic objects,
this field contains the ex­
ternal code and name of
those time recording pro­
files.

Note: If the Employee Cen­


tral Payroll Time Sheet
is enabled in Provisioning,
the Time Recording Profile
can only be entered and
saved together with the
other three Time Off fields
in job information.

Data Model Field Information for Employee Central


128 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes time-record­ Time Re­ STRING — None No This field is relevant for the
ing-variant cording Var­ Employee Central Payroll
iant Time Sheet.

Employees record their


time in the Employee Cen­
tral Payroll Time Sheet us­
ing one of the following
time recording variants:

Clock Time-Based Re­


cording - Time recording
based solely on the en­
tered start and end times
of work within a specified
period, for example, per
day.

Duration-Based Record­
ing - Time recording based
solely on the duration of
the work recorded for a
specific period, for exam­
ple, in hours and minutes
for a given day of work.

Yes time-type- Time Profile STRING — None No This field is relevant for
profile-code Time Off.

Different time types, such


as work, vacation, and paid
time off (PTO) can be as­
signed to a single struc­
ture, called the time pro­
file. This time profile is
then assigned to employ­
ees so that they know, for
example, how much time
off they can take and what
kind.

If you have defined time


profile generic objects, this
field contains the external
code and name of those
time profiles.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 129
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes track-id Track Id STRING 32 None No


 Note
This field has
been deprecated and
should no longer be
used.

No triggerMa­ User de­ BOOLEAN n/a None No You can use this field if
trixRelation­ fined. You
you've enabled matrix re­
Sync define the
lationship sync in Position
label on the
BCUI when Management Settings, but
adding the would like to skip it.
field to the
Job Infor­
mation
model

Yes workingDay­ Working STRING 256 Both No You can enter the num­
sPerWeek Days Per ber of working days each
Week week. It is not a working
schedule.

The number must be


smaller than or equal 7. For
example:

• 5
• 3.5

This field is required if you


use payroll integration with
SAP ERP.

Yes work-period Work Period STRING 100 None No This field belongs to the
Standard Weekly Hours
field to denote how many
hours an employee should
work each week.

Data Model Field Information for Employee Central


130 PUBLIC Employment Object Tables
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes worksched­ Work STRING — None No This field is relevant for


ule-code Schedule Time Off.

It defines how an employ­


ee’s total work time is div­
ided. For example, an em­
ployee might be scheduled
to work 40 hours a week,
comprising 5 days of 8
hours each.

If you have defined work


schedule generic objects,
this field contains the ex­
ternal code and name of
those work schedules.

Yes custom- Custom STRING 256 None No Do not use the type
string1 String 1 attribute for this cus­
tom string (neither
type=“foundation
object” nor
type=”generic
object” nor
type=”worker”).

No custom- Custom STRING 256 None No You can use these fields
string2–160 Strings 2– for data not covered by the
160 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–50 Dates 1–50

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Yes companyEn­ Company DATE — View No For more information, refer


to the Entry-Based Date
tryDate Entry Date
Fields section of Entry
Dates, Event-Based Dates,
Yes timeInCom­ Time In STRING 256 View No
and TimeIn Calculation for
pany Company Job Information.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 131
Max. Default Vis­ Is Re­
Standard Field ID Field Label Data Type Length ibility quired? How To Use This Field

Yes locationEn­ Location En­ DATE — View No


tryDate try Date

Yes timeInLoca­ Time In Lo­ STRING 256 View No


tion cation

Yes departmen­ Department DATE — View No


tEntryDate Entry Date

Yes timeInDe­ Time In De­ STRING 256 View No


partment partment

Yes jobEntry­ Job Entry DATE — View No


Date Date

Yes timeInJob Time In Job STRING 256 View No

Yes positionEn­ Position En­ DATE — View No


tryDate try Date

Yes timeInPosi­ Time In Po­ STRING 256 View No


tion sition

Yes payScaleLe­ Pay Scale DATE — View No


velEntry­ Level Entry
Date Date

Yes timeInPay­ Time In Pay STRING 256 View No


ScaleLevel Scale Level

Yes hireDate Hire Date DATE — View No For more information, refer
to the Event-Based Date
Fields section of Entry
Yes termination­ Termination DATE — View No
Dates, Event-Based Dates,
Date Date
and TimeIn Calculation for
Job Information.
Yes leaveOfAb­ Leave Of Ab­ DATE — View No
senceStart­ sence Start
Date Date

Yes leaveOfAb­ Leave of Ab­ DATE — View No


senceRe­ sence Re­
turnDate turn Date

4.1.6 Job Relationships


Here is a list of the fields available for this element.

Job Relationships (hris-element-id: jobRelationsInfo)

Data Model Field Information for Employee Central


132 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes relationship- Relationship STRING 100 Both Yes Here you choose the type
type Type of relationship. The list
of values comes from
the predefined picklist
jobRelType. Possible
values are:

• HR manager
• Matrix manager
• Custom manager
• Second manager
• Additional manager
• Delegate A
• Delegate B

You can also add more


types of manager by en­
hancing the picklist CSV
file.

Yes rel-user-id Name STRING 384 Both Yes You can select the manag­
er's name from the list of
existing users in the sys­
tem.

No custom- Custom STRING 256 None No You can use these fields
string1–20 string 1 to for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

4.1.7 PayComponentNonRecurring

Here is a list of the fields available for this element.

PayComponentNonRecurring (hris-element-id: payComponentNonRecurring)

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 133
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No action- Action- — None No This field is used for inter­


enum enum nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No action-id Action-id LONG — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes alternative- Alternative STRING 256 Both No You can assign an alterna­
cost-center Cost Center tive cost center to the non-
recurring payment by en­
tering the cost center here.

This field is relevant for


payroll integration. For
more information, refer to
the SAP SuccessFactors
Employee Central Payroll
guide.

No allow-delete Specifies if BOOLEAN — None No This field is used for inter­


delete is al­ nal purposes. Do not use it
lowed for a in the data model. Even if it
record is used, it won't be visible
on the UI.

Data Model Field Information for Employee Central


134 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes base-pay- Base Pay STRING — None No You can specify for pay
component Component components of type PER­
CENTAGE of what exactly
the pay component is a
percentage, for example,
bonus = 10% of base sal­
ary. Once this field is filled
for a pay component def­
inition, all employee pay
components must use this
value of the base pay com­
ponent group field (it can­
not be overwritten).

 Note
If you enable this
field as editable in
the employee UIs, the
value help will offer
you all the pay compo­
nent groups to which
the pay component
you are editing are
assigned. So for ex­
ample, you would get
the pay component
group “Total annual
earnings” offered as
a possible base pay
component group for
employee pay compo­
nent base salary, bo­
nus, and car allow­
ance.

Set to View to be dis­


played on the UI or
None. Do not set it to
Both.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 135
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes calculated- Calculated Double — View No • For pay components


amount Amount of type AMOUNT, the
calculated amount is
set to the amount
• For pay components
of type PERCENT­
AGE, the calculated
amount is the amount
of the corresponding
base pay component
group multiplied with
the percentage which
is stored in the field
amount
• For pay components
of type NUMBER, the
calculated amount is
the number entered
in the employee pay
component multiplied
by a rate read from
either the pay scale
level or from the pay
component (FO) defi-
nition.

 Note
If the rate in
the payscalelevel
is not available,
the rate specified
in the Foundation
Object is used.

No created-by Created-by STRING 100 None No This field is used for inter­
nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No created-on Created-on DATE — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Data Model Field Information for Employee Central


136 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes currency- Currency STRING 20 Both Yes Select the currency the
code Code pay component is issued
in from the list of curren­
cies provided in this field.

No item-id Item-id LONG — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No last-modi­ Last-modi­ STRING 100 None No This field is used for inter­
fied-by fied-by nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No last-modi­ Last-modi­ DATE — None No This field is used for inter­


fied-on fied-on nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes non-recur­ End Date of DATE default None No This field has the visibility
ring-pay-pe­ the Related ‘none’ by default. So if the
riod-end- Period customers require these
date fields, then they need to
change the data model to
have the visibility set to
‘both’. The field values will
be replicated to SAP ERP if
payroll is enabled.

Yes non-recur­ Start Date DATE default None No This field has the visibility
ring-pay-pe­ of the Re­ ‘none’ by default. So if the
riod-start- lated Period customers require these
date fields, then they need to
change the data model to
have the visibility set to
‘both’. The field values will
be replicated to SAP ERP if
payroll is enabled.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 137
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes number-of- Number of DOUBLE — Both No The value specified in this


units field is multiplied with the
Units
rate from the payscalele­
vel defined in Job Informa­
tion. In case the payscale­
level is not available, the
value specified in this field
is multiplied with the rate
defined for the Foundation
Object, which is then dis­
played in the calculated-
amount field.

Yes offcycle-rea- OffCycle Picklist — None No


 Note
son Reason
You only need to use
this field if you use
Payroll Control Center.

The value of this field gives


the reason for the offcycle
payment.

The valid offcycle reasons


need to be specified in a
picklist. The external code
of the picklist can be any
value except blank. The
external code of the pick­
list has to be mapped
in the Code Value Map­
ping (T77SFEC_CVMAPC )
table in Employee Central
Payroll.

Yes pay-compo­ Type STRING — Both Yes If you have defined pay
nent-code component foundation ob­
jects, this field contains
the external code of those
pay components.

No pay-compo­ Pay-compo­ STRING 38 None No This field is used for inter­


nal purposes. Do not con­
nent-type nent-type
figure the visibility.

Yes pay-date Issue Date DATE — Both Yes The date the compensa­
tion is issued.

Data Model Field Information for Employee Central


138 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes pay-id Pay ID Picklist — None No


 Note
You only need to use
this field if you use
Payroll Control Center.

The ID is used to differen-


tiate batches of offcycle
payroll runs.

The ID values need to be


specified in a picklist. They
cannot be in the ranges
of 0-9, A-Z and ‘!’. Only
special characters, such as
‘@’, ‘#’, ‘$’, ‘%’, ‘^’, ‘&’, ‘*’,
‘?’, can be used to indicate
the specific payment to be
treated as planned offcycle
if the Payroll Control Cen­
ter is implemented.

When the ID is not en­


tered, the specific pay­
ment will be treated as ad­
hoc offcycle payment if the
Payroll Control Center is
implemented.

Yes reference-id Reference LONG — None No This field is relevant for


ID
payroll integration. For
more information, refer to
the SAP SuccessFactors
Employee Central Payroll
guide.

Yes sent-to-pay­ Sent To Pay­ DATE — None No The date the compensa­
tion information is sent to
roll roll
payroll.

No sequence- Sequence STRING 38 View Yes This field is required for


number Number importing data. If you ena­
ble this field, the allow im­
port property is defaulted
to True.

Yes tax-treat­ Tax Treat­ STRING 32 None No This field shows whether
the pay component is
ment ment
taxed or not.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 139
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes unit-of- Unit of Generic Ob­ — Both No Displays the unit that is
measure Measure ject (Unit of used. For example, kg,
Measure ac­ pound, pieces, and so on.
cording to
UN/CEFACT
Recommen­
dation
20/21)

Yes value Amount DOUBLE — Both Yes Here you define the
amount of the component
in numbers.

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–50 Decimals 1–
50

 Note

In compensation information as well as recurring and non-recurring payments, fields of type DOUBLE can now
be hidden. To do this, set the pii field to TRUE (pii="true"). This allows the users to decide for themselves what
information is visible and prevents unauthorized eyes from seeing the information by mistake.

4.1.8 PayComponentRecurring

Here is a list of the fields available for this element.

PayComponentRecurring (hris-element-id: payComponentRecurring)

Data Model Field Information for Employee Central


140 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No action- Action- — None No This field is used for inter­


enum enum nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No action-id Action-id LONG — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No allow-delete Specifies if BOOLEAN — None No This field is used for inter­


delete is al­ nal purposes. Do not use it
lowed for a in the data model. Even if it
record is used, it won't be visible
on the UI.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 141
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes base-pay­ Base Pay STRING — None No You can specify for pay
component Component components of type PER­
CENTAGE of what exactly
the pay component is a
percentage, for example,
bonus = 10% of base sal­
ary. Once this field is fil-
led for a pay component,
all employee pay compo­
nents must use this value
of the base pay compo­
nent group field (it cannot
be overwritten).

 Note
If you enable this
field as editable in
the employee UIs, the
value help will offer
you all the pay compo­
nent groups to which
the pay component
you are editing are
assigned. So for ex­
ample, you would get
the pay component
group “Total annual
earnings” offered as
a possible base pay
component group for
employee pay compo­
nent base salary, bo­
nus, and car allow­
ance.

Data Model Field Information for Employee Central


142 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes calculated- Calculated Double — View No • For pay components


amount Amount of type AMOUNT, the
calculated amount is
set to the amount.
Note that you cannot
use a rule to automat­
ically set this value.
• For pay components
of type PERCENT­
AGE, the calculated
amount is the amount
of the corresponding
base pay component
group multiplied with
the percentage which
is stored in the field
amount.
• For pay components
of type NUMBER, the
calculated amount is
the number entered
in the employee pay
component multiplied
by a rate read from
either the pay scale
level or from the
pay component foun­
dation object defini-
tion.

 Note
If the rate in the
pay scale level
is not available,
the rate specified
in the foundation
object is used.

No compensa­ Compensa­ LONG — None No This field is used for inter­


tion-id tion-ID nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 143
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No created-by Created-by STRING 100 None No This field is used for inter­
nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

NO created-on Created-on DATE — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes currency- Currency STRING 32 Both Yes Here you select the cur­
code rency of the pay compo­
nent. The values come
from the list of currencies.

Yes deferralper­ Deferral Per­ DOUBLE — None No This field is used for inter­
centage centage nal purposes. Do not con­
figure the visibility.

No end-date End Date DATE — None No This field is used for inter­
nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes frequency­ Frequency STRING 30 Both No This is the frequency


Code in which the pay compo­
nent is paid, for exam­
ple, monthly, annual, bi-
weekly, and so on.

If you have defined


frequency foundation ob­
jects, this field contains
the external code of those
frequencies.

No is-earning Is-earning BOOLEAN 1 None No This field is used for inter­


nal purposes. Do not con­
figure the visibility.

Yes is-target Is Target BOOLEAN 1 None No This field is used for inter­
nal purposes. Do not con­
figure the visibility.

Data Model Field Information for Employee Central


144 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No item-id Item-id LONG — None No This field is used for inter­


nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No last-modi­ Last-modi­ STRING 100 None No This field is used for inter­
fied-by fied-by nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

No last-modi­ Last-modi­ DATE — None No This field is used for inter­


fied-on fied-on nal purposes. Do not use it
in the data model. Even if it
is used, it won't be visible
on the UI.

Yes no-changes- No Changes DATE — None No This is a calculated, transi­


until-date Until This ent field on the UI. It shows
Date the date when a change is
planned for a pay compo­
nent.

Yes number-of- Number of DOUBLE — Both No The value specified in this


units field is multiplied with the
Units
rate from the payscale
level defined in Job Infor­
mation. In case the pay­
scale level is not availa­
ble, the value specified in
this field is multiplied with
the rate defined for the
Foundation Object which is
then displayed in the cal­
culated-amount field.

Yes pay-compo­ Pay Compo­ STRING — Both Yes Enter the pay component
nent nent that makes up the employ­
ee's total compensation,
like base salary.

If you have defined pay


component foundation ob­
jects, this field contains
the external code of those
pay components.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 145
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes pay-compo­ Pay Compo­ STRING 38 None No This field is used for inter­
nal purposes. Do not con­
nent-type nent Type
figure the visibility.

Yes paycomp­ Amount DOUBLE — Both Yes Here you define the
value amount of the component
in numbers.

Yes sent-to-pay­ Sent To Pay­ DATE — None No This field is used for inter­
roll roll Date nal purposes. Do not con­
figure the visibility.

No seq-number Seq-number LONG — None No This field is used for inter­


nal purposes. Do not con­
figure the visibility.

Yes tax-treat­ Tax Treat­ STRING — None No This field is used for inter­
ment ment nal purposes. Do not con­
figure the visibility.

Yes unit-of- Unit of Generic Ob­ — Both No Displays the unit which
measure Measure ject (Unit of is used. For example, kg,
Measure ac­ pound, pieces, and so on.
cording to
UN/CEFACT
Recommen­
dation
20/21)

No custom- Custom STRING 256 None No You can use these fields
string1–20 Strings 1– for data not covered by the
20 fields supplied as stand­
ard.
No custom- Custom DATE — None No
date1–10 Dates 1–10

No custom- Custom LONG — None No


long1–20 Numbers 1–
20

No custom- Custom DOUBLE — None No


double1–20 Decimals 1–
20

Data Model Field Information for Employee Central


146 PUBLIC Employment Object Tables
 Note

In compensation information as well as recurring and non-recurring payments, fields of type DOUBLE can now
be hidden. To do this, set the pii field to TRUE (pii="true"). This allows the users to decide for themselves what
information is visible and prevents unauthorized eyes from seeing the information by mistake.

4.1.9 Payment Information

Here is a list of the fields available for this element.

Payment Information (hris-element-id: paymentInfo)

 Note

To use the Payment Information block with payroll integration, you have to turn on payroll integration in
Provisioning. Alternatively to use Payment Information without payroll integration, choose “Enable Direct
Deposit as a Payment Method in Payment Information even if Payroll Integration is not enabled” in Provisioning
and ensure that the Generic Objects setting is also selected.

 Remember

As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.

The fields of this element are defined in the Succession Data Model.

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes payment- Payment STRING 20 None No This field is required if you


method Method have activated payroll inte­
gration. It indicates how an
employee gets paid, for ex­
ample:

• By bank transfer

• By check

• Cash

For more information


about how to set up pay­
roll integration, refer to
the SuccessFactors Em­
ployee Central Payroll
guide.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 147
4.1.10 Pension Payout Details

Here is a list of the fields available for this element.

Pension Payout Details (hris-element-id: pensionPayoutsInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes company Pension Pro­ STRING 256 Both Yes Enter the pension provider
vider that pays the pension pay­
out. You can select from
the pension providers you
have created as company
foundation object in the
system.

Yes end-date Actual End DATE — Both Yes When you end a pension
Date payout, you have to enter
the actual end date of the
pension payout.

Yes payroll-end- Payroll End DATE — Both Yes Enter the payroll end date.
date Date This might differ from the
end date of the pension
payout.

Yes planned- End Date DATE — Both No Enter the end date when
end-date the pension payout is sup­
posed to end. This does
not end the pension pay­
out automatically.

Yes start-date Start Date DATE — Both Yes Enter the start date of the
pension payout.

No custom- — STRING 256 None No You can use these fields


string101– for data not covered by the
115 and cus­ fields supplied as stand­
tom- ard.
string116–
The first 5 custom field
120
numbers are used to add a
pension payout, the last 5
No custom- — DATE — None No
custom field numbers are
date31–35
used to end a pension pay­
and custom-
out.
date36–40

Data Model Field Information for Employee Central


148 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- — LONG — None No


long21–25
and custom-
long26–30

No custom- — DOUBLE — None No


double21–
25 and cus­
tom-dou­
ble26–30

4.1.11 Termination Information

Here is a list of the fields available for this element.

Termination Information (part of hris-element-id: employmentInfo)

Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No attachment- Attachment- LONG — None No This field shows any at­


id id tachments from Job Infor­
mation.

Yes benefit- Benefits DATE — Both No Benefits are granted until


sEndDate End Date this date. By default, this is
the same date as the ter­
mination date, unless you
change it here.

No bonus­ Bonus Pay DATE — Both No Bonus pays are being paid
PayExpira­ Expiration until this date. By default,
tionDate Date this is the same date as
the termination date, un­
less you change it here.

Yes eligiblefor­ Eligible for BOOLEAN — Both No This field indicates that the
SalContinu­ Salary Con­ employee is eligible for sal­
ation tinuation ary continuation. Possible
values are Yes and No.

Yes end-date Termination DATE — View Yes Enter the end date of the
Date employee's working con­
tract with the company.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 149
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

Yes lastDate­ Last Date DATE — Both No The last day the employee
Worked Worked worked for the company.
By default, this is the same
date as the termination
date, unless you change it
here.

Yes okToRehire Ok to Rehire BOOLEAN — Both No If the employee can be re­


hired, set this field to Yes.

Yes payrollEnd­ Payroll End DATE — Both No The last payroll for this
Date Date employee. By default, this
is the same date as the
termination date, unless
you change it here.

Yes regretTermi­ Regret Ter­ BOOLEAN — Both No If this termination is a loss


nation mination for the organization, set
this field to Yes.

Yes salary-end- Salary End DATE — Both No Salary is paid until this
date Date date. By default, this is
the same date as the ter­
mination date, unless you
change it here.

Yes StockEnd­ Stock End DATE — Both No Stocks are granted until
Date Date this date. By default, this is
the same date as the ter­
mination date, unless you
change it here.

No custom- Custom STRING 256 None No You can use these fields
string16 to Strings 16– for data not covered by the
custom- 20 fields supplied as stand­
string20 ard.
Custom
and custom-
Strings 81–
string81–
100
100

No custom- Custom DATE — None No


date6 to Dates 6–20
custom-
Custom
date20
Dates 66–
90

Data Model Field Information for Employee Central


150 PUBLIC Employment Object Tables
Standard Field ID Field Label Data Type Max. Default Vis­ Is Re­ How To Use This Field
Length ibility quired?

No custom- Custom LONG — None No


long11 to Numbers
custom- 11–20
long20

No custom- Custom DOUBLE — None No


double11 to Decimals
custom- 11–20
double20

 Note

If the attachment field is configured for Job Information, then attachments are shown in the related Job
Information record in the History UI.

However, if the attachments field is not configured for Job Information or the logged-in user does not have
permission to view or edit that field, but the workflow initiator added the attachments to Job Information, then
system loads the attachment into the Employment Information attachments field in the Termination UI.

Data Model Field Information for Employee Central


Employment Object Tables PUBLIC 151
5 Deprecated Fields

The following elements are deprecated and must not be used in the data models.

Job Information

• Additional-Manager
• Address
• Amount-of-Financial-Plan
• Custom-Manager
• ERN-Number
• Govt-Grant-Amount
• HR-Manager
• International-Org-Code
• Is-Primary
• Manager
• Manager-Employment-ID
• Matrix-Manager
• Pay-Group
• Second-Manager
• Time-Account-Profile-Code
• Track-ID

Compensation Information

• BonusInfo
• CompAdjustInfo
• DirectDeposit
• JobInfoLocal
• LeaveOfAbsence
• NameInfo
• PayrollInfo
• RelInfo
• StatusInfo
• WorkEligibilityInfo

Data Model Field Information for Employee Central


152 PUBLIC Deprecated Fields
Important Disclaimers and Legal Information

Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:

• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements
with SAP) to this:

• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.

• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you
agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.

Videos Hosted on External Platforms


Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the
control or responsibility of SAP.

Beta and Other Experimental Features


Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the
experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback
(e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and
phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example
code unless damages have been caused by SAP's gross negligence or willful misconduct.

Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities, genders,
and abilities.

Data Model Field Information for Employee Central


Important Disclaimers and Legal Information PUBLIC 153
www.sap.com/contactsap

© 2022 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form


or for any purpose without the express permission of SAP SE or an SAP
affiliate company. The information contained herein may be changed
without prior notice.

Some software products marketed by SAP SE and its distributors


contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for


informational purposes only, without representation or warranty of any
kind, and SAP or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP or
SAP affiliate company products and services are those that are set forth
in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an
additional warranty.

SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.

Please see https://www.sap.com/about/legal/trademark.html for


additional trademark information and notices.

THE BEST RUN

You might also like