Introduction
Data integration between SuccessFactors Performance Management Suite and your Human Resource Information System (HRIS) or payroll system allows single source updates of your employee data. With this simple data transfer process, the updates you enter into your HRIS will be passed to PM, eliminating duplicate entry. This integration requires the export of the defined data fields (see below) into a flat file, which is uploaded through the Admin Tools user interface. The update process can be automated using a Secure File Transport Protocol (SFTP) process executed at your schedule to maintain synchronized data.
Business Rules for Data Transfer
To import data from an HRIS (or other data source) into Performance Manager, certain business rules MUST be followed.
1. The file must be in Comma Separated Values (.csv) format. The file can be a plain text file (.txt) too but the values must be separated by commas. For values with commas, we suggest enclosing them in quotes so they load properly.
2. Take care when using data fields with leading zeroes. Spreadsheet applications such as Microsoft Excel strip leading zeroes from data fields and could corrupt the data. If there are leading zeroes in the data file, verify that the leading zeroes are present in the file before uploading.
3. The file must contain two rows of predefined column IDs and labels. A template for these column IDs and labels can be exported from the system using the Export Template option.
4. All fields are case sensitive and will reflect what is loaded in the data load.
If the user name is created in mixed case, the logon process will require that the user name be specified in mixed case.
5. JOBCODE is case sensitive and must match exactly the job codes designated for roles. To see a list of families and roles, go to the Administration tools. In the Company Processes & Cycles portlet, select , Company Settings
— Manage Job Roles.
6. JOBCODE is used to determine competency mapping which allows competencies to be populated on forms and worksheets based on the value in the JOBCODE field. If the company is using job profiles, the value entered in this column will determine what set of competencies will be displayed on the appraisal form for that employee. This value may be the actual job code from the HRIS or a derived code: Many customers will choose to combine job codes into broad employee groups to simplify administration of competency sets that may be common across many roles in the same group. This decision should be made by the implementation team based on the process.
Example
JOB CODE EMPLOYEE GROUP EXEC Officers and Executives
SMGR Seniors managers or employees who manage multiple functions MGR Single function managers
SUP First Line Supervisors
PROF Professionals or managerial level knowledge workers who do not supervise others IC Individual Contributors
7. STATUS must be the first field and USERID must be the second field and the upper case header must be repeated for the second row. Remaining fields need not be in the order presented here. If a field will not be populated, do not include that field in the import file. If that field in the file is blank, it will wipe out what is already in the database.
8. USERID is the system unique value for each user and must be unique. This value is visible in a variety of places to all end users. Accordingly, USERID should not contain data that is considered confidential, such as social security number. This value must be passed with each employee data record during each upload.
Take care in selecting this value as it this is a permanent decision. This value cannot be changed once set.
9. USERNAME is a unique name for each user and is used as the logon ID value. This value is visible in a variety of places to all end users. Accordingly, USERNAME should not contain data that is considered confidential, such as social security number. Unlike USERID, this value can be updated if needed, (e.g. name change) but must be unique. Most customers choose to use the same USERNAME that they use for their local network or e-mail application.
10. The definition of which fields are required is the minimum requirements and must be populated. The additional recommended fields are used in the system for reporting and/or are important for grouping data. Additional fields can be marked as required during initial implementation based on business need. The order of field display on the Personal Information screen can be modified if required.
11. The ability for the employee to edit/not edit the data loaded into the employee record (on the Personal Information screen) is an option defined during initial setup.
We strongly recommend that these edit rights be turned off to maintain sync of data with the HRIS.
Take care to understand impact of ability of the user to update certain variables directly (e.g.
manager). Values updated via the user interface will be overwritten by the next data load from the HRIS.
12. The individual fields in the employee record can also be hidden during the initial setup so they will not display in the Personal Information screen. This allows for the storage of data associated with each individual, passed from the HRIS to be used by one or more process, but does not display this data on the Personal Information screen (accessed by the employee).
13. If the DEPARTMENT, DIVISION and/or LOCATION fields are not used, do not include them in the import file.
The system will automatically assign "N/A" values in these fields. Report security is tied to these values and entering a common value (e.g. NA) will allow for the broadest reporting access to the data - leaving it blank will limit reporting access.
14. Data placed in the Department, Division, and Location fields - may be a code or a text name. The value entered will appear in drop-down menus.
15. Data labels are limited to 100 characters.
16. Most String values are limited to 255 characters. Exceptions are USERID (100), USERNAME (100), FIRSTNAME (128), LASTNAME (128), MI (128), GENDER (2), EMAIL (100), DEPARTMENT (128), DIVISION (128), LOCATION (128), MANAGER (100), HR (100), JOBCODE (128), TIMEZONE (32).
17. Date format must be mm/dd/yyyy.
18. HIREDATE is used in Performance Manager to display the defined date AND/OR can be the date used to initiate an automatic form creation for this user. The value in the HIREDATE field does not have to be the actual hire date and may be a derived date from the HRIS system (e.g. hire date + 90 days, last review date -60 days, etc.) upon a new document will be created for this employee. The system can be set to automatically generate a new form for this employee based on the month/day combination of this field value (i.e. if Jim's hire date is 03/02/2002, the system can be set to automatically create a new appraisal form for Jim each March 2nd).
19. Custom fields can be defined to import additional information (e.g. FLSA code, etc.). However, this data does not show up anywhere in the system, other than the Employee Profile or custom fields in a form. They can also be used in the Employee Scorecard and Organization Chart.
20. Performance Manager uses the MANAGER field to create the organizational hierarchy within the system.
Each employee must have a valid manager. Upon data load, Performance Manager will validate that each employee has a valid manager listed in their data record. This validation check is executed against the employees held within the exiting Performance Manager database. Therefore, the MANAGER field in each employee record must hold a valid USERID of someone in the existing database. If a user who does not have a valid manager attempts to login the attempt will fail and the user will receive this error message:
21. The individual at the top of the organizational hierarchy (e.g. CEO) must have NO_MANAGER (in all caps) listed in the MANAGER data field, so that the system knows how to treat this individual in the routing chain.
This value must be exactly NO_MANAGER. Other values, such NO_MGR will fail.
22. Since the data load validation process validates the MANAGER and HR data against the existing database, it is strongly recommended that the new employees be added to the beginning of the data load file. This will allow the new employee to be loaded first in case the new employee is a manager or HR rep referenced later in the data file and will improve processing speed, especially for large files.
23. COUNTRY can be used to determine which of several possible Privacy Consent Statements will be presented to a new user. If the Privacy Consent feature is enabled, when users log in to the system the very next time, they will go directly to the data consent page - which can differ depending on their COUNTRY. Users can then choose to accept or decline the terms presented. Use the country names specified in the Country List at the end of this document.
24. MATRIX_MANAGER, CUSTOM_MANAGER, and SECOND_MANAGER fields are not required in the data file unless those relationships are required for permissions or document routing. MATRIX_MANAGER and CUSTOM_MANAGER can include multiple managers. The syntax would be to separate the manager IDs with pipe (|) characters.
Example
"gsmith624|sholmes423|smaddox666"
25. DEFAULT_LOCALE field is not required in data file. If present, the values in the field will determine the languages experienced by the users (one language per user). If the field is left blank for a user, the user's existing value will not be changed. Example: Bo had previously selected "it_IT" (Italian) and the data file now includes the DEFAULT_LOCALE field with a blank value for Bo; his value for default locale remains "it_IT" - his previous selection rather than the company-wide default language. See the list of supported locales at the end of this document.
26. PROXY field does not need to be included in data file. If present, the value in the field defines which person can act as proxy on behalf of the user. If left blank, no proxy holder will be assigned and existing proxy holders will be removed. The field can include multiple proxy holders. The syntax would be to separate the proxy holder IDs with pipe (|) characters.
Example
"admin|sholmes423|smaddox666"
27. TIMEZONE is required in the system for internal time/date stamps in the time of the user. If a TIMEZONE value is not loaded the field will be automatically populated with a default of Eastern Standard Time. Records may be set to one value (e.g. time zone of corporation) rather than different zones for each employee. To have the system automatically adjust for daylight savings time use the time zone ID from the Supported Time Zones section at the end of this document rather than the short three-letter abbreviation.
Business Rules
Label1 Column Name Required2 Data Type Max.
Length Example
Functionality Area Using This Data
STATUS STATUS TRUE STRING 32 ACTIVE
INACTIVE
Label1 Column Name Required2 Data Type Max.
Length Example
Functionality Area Using This Data
USERID3 USERID TRUE STRING 100 BOBJONES SYSTEM ID —
unique ID
Username3 USERNAME TRUE STRING 100 BOBJONES Log-on name/ID
See note below
First Name FIRSTNAME TRUE STRING 128 BOB User Information
Last Name LASTNAME TRUE STRING 128 BOB User Information
Middle Name MI FALSE STRING 128 P User Information
Gender GENDER TRUE STRING 2 M Writing Assistant
Email EMAIL TRUE STRING 100 [email protected] E-mail
Notifications Manager
(USERID) MANAGER TRUE STRING 100 SSMITH Routing, User
Information HR Rep
(USERID) HR TRUE STRING 100 DDAVIDSON HR Approval,
Routing
Department DEPARTMENT RECOM STRING 128 MARKETING User Information,
Reporting
Job Code JOBCODE RECOM STRING 128 321 Competency
Mapping; User Info
Division DIVISION RECOM STRING 128 Mkt Reporting
Location4 LOCATION RECOM STRING 128 SM Reporting
Time Zone TIMEZONE TRUE STRING 64 PST Time Stamp
Hire Date HIREDATE FALSE DATE date 01/01/2001 Date of Company
Hire (Also can be used to trigger auto creation of forms)
Employee ID EMPID FALSE STRING 255 1234 User Information
Title TITLE FALSE STRING 255 ANALYST User Information
Business Phone BIZ_PHONE FALSE STRING 255 6504755123 User Information
Business Fax FAX FALSE STRING 255 6504755124 User Information
Address 1 ADDR1 FALSE STRING 255 2 MAPLE ST User Information
Address 2 ADDR2 FALSE STRING 255 SUITE 2 User Information
City CITY FALSE STRING 255 SAN MATEO User Information
State STATE FALSE STRING 255 CA User Information
Zip ZIP FALSE STRING 255 94403 User Information
Country COUNTRY FALSE STRING 255 USA Data Privacy
Consent Statements Review
Frequency REVIEW_FREQ FALSE STRING 255 1 Not Needed
Last Review Date LAST_REVIEW_DATE FALSE DATE date 04/19/1999 User Information Customizable
Field 1 CUSTOM01 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart
Label1 Column Name Required2 Data Type Max.
Field 2 CUSTOM02 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 3 CUSTOM03 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 4 CUSTOM04 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 5 CUSTOM05 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 6 CUSTOM06 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 7 CUSTOM07 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 8 CUSTOM08 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 9 CUSTOM09 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 10 CUSTOM10 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 11 CUSTOM11 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 12 CUSTOM12 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 13 CUSTOM13 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart Customizable
Field 14 CUSTOM14 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart
Label1 Column Name Required2 Data Type Max.
Field 15 CUSTOM15 FALSE STRING 255 Any string value Display in forms,
Employee Profile, Scorecard, Organization Chart
Matrix Manager MATRIX_MANAGER FALSE STRING SSMITH Dotted line
relationship
Default Locale DEFAULT_LOCALE FALSE STRING 100 fr_FR Language seen by
user
Custom Manager CUSTOM_MANAGER FALSE STRING SSMITH Dotted line
relationship/
Succession Planner
Second Manager SECOND_MANAGER FALSE STRING SSMITH Dotted line
relationship/
Compensation Manager
Proxy PROXY FALSE STRING SSMITH Assign proxy(ies)
for user
1. Label can be changed to reflect business practices
2. Fields can be made required or not required to reflect business practices.
3. This value is visible in a variety of places to all end users. Do NOT use any data that is considered confidential (i.e. social security number). Data in this field MUST be unique to each employee record and is case-sensitive
4. If these values are left as NULL, the import process will assign N/A during the data load.
Characters
For the Performance Manager application, not all characters can be used in all fields of the Employee Data Upload file, or in the information appearing on the Log On page. Specifically, the following table shows which characters can be used where.
Character(s) Description Company ID User ID Username Password
a through z Lowercase letters Y Y Y Y
A through z Uppercase letters Y Y Y Y
0 through 9 Numerals Y Y Y Y
Character(s) Description Company ID User ID Username Password
# Pound sign N N Y Y
$ Dollar sign N N Y Y
% Percent sign N N Y Y
& Ampersand N N Y Y
* Asterisk N N Y Y
+ Plus sign N N Y Y
' Single quote N N Y N
` Accent grave N N Y N
? Question mark N N Y Y
= Equal sign N N N Y
^ Caret N N N Y
( Left Parenthesis N N N Y
) Right Parenthesis N N N Y
, Comma N N N Y
/ Slash N N N N
; Semicolon N N N Y
[ Left bracket N N N Y
] Right bracket N N N Y
< Less than N N N Y
> Greater than N N N Y
: Colon N N N Y
“ Double quote N N N N
{ Left braces N N N Y
} Right braces N N N Y
\ Back slash N N N Y
| Pipe sign N N N Y
Space N N N N
Country List
Country List — A
● Afghanistan
● Albania
● Algeria
● Andorra
● Angola
● Antigua and Barbuda
● Argentina
● Armenia
● Bosnia and Herzegovina
● Botswana
● Central African Republic
● Chad
● Congo, Democratic Republic of the
● Costa Rica
● Denmark
● Djibouti
● Dominica
● Dominican Republic Country List — E
● East Timor (Timor Timur)
● Ecuador
● Ireland
● Macedonia, Former Yugoslav Republic of
● Madagascar
● Micronesia, Federated States of
● Moldova
● Monaco
● Mongolia
● Saint Kitts and Nevis
● Saint Lucia
● Saint Vincent and The Grenadines
● Samoa
● San Marino
● Sao Tome and Principe
● Trinidad and Tobago
● Tunisia
● United Arab Emirates
● United Kingdom
● United States
● Uruguay
● Uzbekistan Country List — V
● Vanuatu
● Vatican City
● Venezuela
● Vietnam Country List — W
● Western Sahara Country List — Y
● Yemen Country List — Z
● Zambia
● Zimbabwe
Locales
Locale Admin Text Language and Country
en_US English US English US
en_GB English UK English UK
bg_BG Български (Bulgarian) Bulgarian Bulgaria
bs_BS Bahasa Melayu (Malay) Bahasa Malaysian
bs_ID Bahasa Indonesia Bahasa Indonesian
cs_CZ Čeština (Czech) Czech Czech Republic
da_DK Dansk (Danish) Danish Denmark
de_CH Schweizer Hochdeutsch (Swiss High German) German Switzerland
de_DE Deutsch (German) German Germany
el_GR Ελληνικά (Greek) Greek Greece
es_ES Español (Spanish) Spanish Spain
es_MX Español (Mexico) Mexican Spanish
fi_FI Suomi (Finnish) Finnish Finnland
fr_CA Français canadien (Canadian French) French Canadian
fr_FR Français (French) French France
hi_IN Hindi India
hr_HR Hrvatski (Croatian) Croatian
hu_HU Magyar (Hungarian) Hungarian Hungary
it_IT Italiano (Italian) Italian Italy
ja_JP Japanese Japanese Japan
ko_KR Korean Korean Korea
nb_NO Norsk bokmål (Norwegian Bokmål) Norwegian Norway
nl_NL Nederlands (Dutch) Dutch Netherlands
pl_PL Polski (Polish) Polish Poland
pt_PT Português (Portuguese) Portuguese Portugal
Locale Admin Text Language and Country pt_BR Português do Brasil (Brazilian Portuguese) Brazilian Portuguese
ro_RO Română (Romanian) Romanian Romania
ru_RU Русский (Russian) Russian Russia
sk_SK Slovenčina (Slovak) Slovak Slovakia
sl_SI Slovenščina (Slovenian) Slovenian Slovenia
sr_RS Srpski (Serbian) Serbian (Latin) Serbia
sv_SE Svenska (Swedish) Svenska Sweden
th_TH Thai Thai Thailand
tr_TR Türkçe (Turkish) Turkish Turkey
vi_VN Tiếng Việt (Vietnamese) Vietnamese Vietnam
zh_CN Simplified Chinese Simplified Chinese (Chinese China)
zh_TW Traditional Chinese Traditional Chinese (Chinese Taiwan)
Time Zones
ID Short Name Long Name
MIT WST West Samoa Time
Do not use — only available for backward compatibility.
Pacific/Apia WST West Samoa Time
Pacific/Midway SST Samoa Standard Time
Pacific/Niue NUT Niue Time
Pacific/Pago_Pago SST Samoa Standard Time
US/Samoa SST Samoa Standard Time
America/Adak HADT Hawaii-Aleutian Daylight Time
America/Atka HADT Hawaii-Aleutian Daylight Time
HST HST Hawaii Standard Time
Do not use — only available for backward compatibility.
Pacific/Fakaofo TKT Tokelau Time
Pacific/Honolulu HST Hawaii Standard Time
Pacific/Johnston HST Hawaii Standard Time
Pacific/Rarotonga CKT Cook Is. Time
Pacific/Tahiti TAHT Tahiti Time
US/Aleutian HADT Hawaii-Aleutian Daylight Time
US/Hawaii HST Hawaii Standard Time
Pacific/Marquesas MART Marquesas Time
ID Short Name Long Name
AST AKDT Alaska Daylight Time
Do not use — only available for backward compatibility.
America/Anchorage AKDT Alaska Daylight Time
America/Juneau AKDT Alaska Daylight Time
America/Nome AKDT Alaska Daylight Time
America/Yakutat AKDT Alaska Daylight Time
Pacific/Gambier GAMT Gambier Time
US/Alaska AKDT Alaska Daylight Time
America/Dawson PDT Pacific Daylight Time
America/Los_Angeles PDT Pacific Daylight Time
America/Tijuana PST Pacific Standard Time
America/Vancouver PDT Pacific Daylight Time
America/Whitehorse PDT Pacific Daylight Time
PST PDT Pacific Daylight Time
Do not use — only available for backward compatibility.
Pacific/Pitcairn PST Pacific Standard Time
US/Pacific PDT Pacific Daylight Time
America/Boise MDT Mountain Daylight Time
America/Cambridge_Bay MDT Mountain Daylight Time
America/Cambridge_Bay MDT Mountain Daylight Time