• No results found

Data Integration for the Performance Management Suite

In document EC Implementation Handbook (Page 167-195)

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

In document EC Implementation Handbook (Page 167-195)