Workday Connector external fields


The Workday Connector installation automatically loads a default configuration. However, you can sync more than just the fields included in the default configuration. Use the following default and additional external fields to set mappings and tasks for the Workday Connector in the JSON configuration.  For help, see Edit the JSON configuration

Note: For an explanation of the Type, Sync direction, and Collaborate field name values in the default fields and additional fields tables, see Field value descriptions.


This table provides additional information for the Workday Connector default fields listed in Default field mappings and Create a profile field synchronization scheme.  The fields are listed in the order that they appear in the Workday configuration mapping. 

Note: Most of the Workday fields are members of the Worker_Data SOAP structure.

Workday field name/description Type Sync
direction
Implementation details

Collaborate
field name

Employee.Email_Work

Email address categorized as Work or Business in that order.

String

ex2in

ex2in_on
_create

 

Email_Address_Data attribute of Personal_Data.Contact_Data 
of Worker_Data record

contactInfo.email_main

Employee.Name

Preferred title, first, last and secondary last concatenated together in that order.

String

2way_in

2way_ex

A composite of Preferred member attributes

First_Name, Last_name and Secondary_Last_Name
from the Title_Reference of the Person_Name_Detail
_DataType

general.name

Employee.Image

Image saved for employee in Workday.

Byte[]

2way_in

2way_ex

Image member of the Photo
Data member of Worker_Data

images.profile.[0].ref.x200

Note“.[0].ref.x200” references the 200×200 image appropriate for Workday. 

Employee.Voice_Work

Telephone number categorized as Work.

String

2way_in

2way_ex

Phone_Data member of
Contact_Data member of
Person_Data member of
Worker_Data which is
categorized as work

contactInfo.phone_work

Employee.Voice_Personal

Telephone number categorized as Home.

String

2way_in

2way_ex

Phone_Data member of
Contact_Data member of
Person_Data member of
Worker_Data which is
categorized as personal

contactInfo.phone_home

Employee.ManagerId

Manager ID number.

String ex2in

First ID array element of the
Manager_Reference of the
Worker_Supervisory
Management_Chain_Data
array of the Management_Chain_Data
member of
Worker_Data record

Note: The short Employee ID number,
not the long WIS#

relationships.manager

Employee.Department

Department.

String ex2in Organization_Name attribute of the Organization_Data member of the first Organization_Data array element of Worker_Data record. general.department

Employee.Title

Business Title.

 

String 2way_in 2way_in

Business_Title attribute of the
Position_Data member of the
Employment_Data member of Worker_Data record

general.title



This table provides the complete list of additional external fields for the Workday Connector. The fields are listed in order of importance. 

Note: Most of the Workday fields are members of the Worker_Data SOAP structure.

Workday field name/description Type Sync direction Implementation details Collaborate field name

Employee.LegalName

Legal title, first, last and secondary last concatenated together in that order.

String

2way_in

2way_ex

A composite of Legal name attributes

First_Name, Last_name, and
Secondary_Last_Name from the
Title_Reference member of the 
Person_Name_Detail_DataType

hr.officialName

Employee.Status

Active, Retired, Terminated, or Unknown.

Enum ex2in

Enum is translated to the known values from Worker_Status_Data attribute of Employment_Data member of Worker_Data record

Note: Not localized

No default field for this value. Create a custom field if needed.

Employee.Email

First email address marked as primary, or first found if no primaries are found. The order of the fields or the primaries is not guaranteed. Work or Business is not guaranteed to come before personal.

String ex2in

Email_Address_Data attribute from Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.email_main

Employee.Email_Personal

Email address categorized as Home.

String ex2in

Email_Address_Data attribute from Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.email

Employee.Voice

The first telephone number set as primary, or the first telephone number if none are set to primary. The order of the primaries is not guaranteed. Work or Business is not guaranteed to come before personal.

String

2way_in

2way_ex

Phone_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.phone_work

Employee.Voice_Work
_Mobile

Telephone number categorized as Work, and Type of Mobile.

String

2way_in

2way_ex

Phone_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.phone_cell

Employee.Voice_Personal
_Mobile

Telephone number categorized as Work and Type of Mobile.

String

2way_in

2way_ex

Phone_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.phone_other

Employee.Address

Primary address or the first one listed. Address is concatenated from the multi-parts in Workday into a standard North American address pattern.

String ex2in

Address_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.address

Employee.Address_Work

Address categorized as Work or Business, in that order.

String ex2in

Address_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

contactInfo.address

Employee.Address_Home

Address categorized as Home.

String ex2in

Address_Data attribute of Contact_Data member of Personal_Data member of Worker_Data record

No default field for this value. Create a custom field if needed.

Employee.EmployeeId

Employee ID number.

String ex2in

Worker_id attribute of Worker_Data record

Note: Worker_ID is the short Employee ID number, not the long WIS#

No default field for this value. Create a custom field if needed.

Employee.EmployeeType

Employee Type

Note: Values returned from Workday are not compatible with Directory. Use replace functionality from DataSync to map to Directory employee types.

String ex2in

Descriptor attribute of Worker_Type_Reference member of Position_Data member of Employment_Data of 
Worker_Data record

hr.empType

Employee.IsEmployee

True if is Worker and Not contract employee.

Boolean ex2in True if the user was found in the HRClient.Get_Workers (worker_id) lookup. Contract employees are not found in this lookup and will not be marked as IsEmployee. No default field for this value. Create a custom field if needed.

Employee.WorkerType

“Employee”, or “Contingent”.

Enum ex2in  if (isEmployee()) then “Employee”, else is “Contingent” No default field for this value. Create a custom field if needed.

Employee.Combined
WorkerEmployeeType

WorkerType + “-” + EmployeeType.

String ex2in

WorkerType + "-" + Descriptor attribute of the Worker_Type_Reference member of the Position_Data member of the Employment_Data member of Worker_Data record

No default field for this value. Create a custom field if needed.

Employee.WorkHistory

Multi-line string of Work History data in pattern, Title Company StartDate – EndDate.

Multi-string ex2in

External_Job_History array of the Qualification_Data member of Worker_Data record

Cannot be bio.workHistory which is a complex field. Create a custom multi-line field.

Employee.Emergency Contact

Personal data, related person with emergency contact information set. Includes person name, and all contact numbers.

String ex2in Emergency_Contact_ID attribute of the Emergency_Contact_Data member of the Emergency_Contact value referenced in the Related_Person array of the Personal_Data member of the Related_Person member of the Related_Person_Data of Worker_Data record hr.emergencyContactInfo

Employee.Spouse

Formatted name of related person where relationship is Spouse.

String ex2in

Related_Person attribute of the Related_Person_Data
member of Worker_Data record

bio.spouse

Employee.Children

Comma delimited list of formatted names of related persons where relationship is “Child”.

String ex2in

Related_Person array of the Related_Person_Data member of Worker_Data record

bio.children

Employee.ImageType

Type of image, JPG, GIF, or PNG.

Enum

2way_in

2way_ex

Filename attribute of the Photo_Data member of Worker_Data record

No applicable field

Employee.HireDate

Hire date time.

DateTime ex2in

Hire_Date attribute of the Worker_Status_Data member of the Employment_Data member of Worker_Data record

hr.hireDate

Employee.OriginalHire
Date

First hire date time of employee.

DateTime ex2in

Original_Hire_Date attribute of the Worker_Status_Data member of the Employment_Data member of Worker_Data record

hr.hireDate

Employee.Certifications

Array of certifications.

String array ex2in

Certification array of the Qualification_Data member of Worker_Data record

skills.certs

Employee.Competency

Array of competencies.

String array
ex2in

Competency array of the Qualification_Data member of Worker_Data record

No default field for this value. Create a custom field if needed.

Employee.Skills

Array of skills.

String array ex2in

Skill_Data array of the Qualification_Data member of Worker_Data record

skills.skills

This section provides descriptions for the values in the Type, Sync direction, and Collaborate field name columns in the Collaborate Connector Default fields and Additional fields tables.

Type

This table describes the data type values used in the Genesys Cloud field.

Value Description
String Use a simple string field for any Collaborate field type.
Multi-string Use in a simple string without line breaks or a multi-line string as multiple lines.
Integer Numbers only. Other values are normalized or removed.
Enum A fixed enumeration of values. May require translate functions to map the Collaborate values to the external connector values.
Byte Use for image mapping to Genesys Cloud.
Boolean True/False, Yes/No, On/Off, etc.
Tag Multi-value data type, searchable in Genesys Cloud
String array Multiple string values which can be synced with a Genesys Cloud tag field type.

Sync direction

The table describes the sync direction values for the data transfer between the Genesys Cloud field (internal) and the field in your system (external).

Value Description
ex2in Copies data from your system to Genesys Cloud. 
in2ex Copies data from Genesys Cloud to your system.*
ex2in_on_create Copies data from your system to Genesys Cloud only once to create users. Subsequent changes to your system do not synchronize to Genesys Cloud.
2way_in Copies data in both directions, but if data is changed in both locations simultaneously, Genesys Cloud wins.*
2way_ex Copies data in both directions, but if data is changed in both locations simultaneously, your system wins.*

* Genesys Cloud does not write to your system by default. To do so, you must add the update task in the JSON configuration. 

Collaborate field name

The values in the Collaborate field name column represent the most likely matches in Genesys Cloud for the Collaborate Connector fields. If the listed value does not fit, use a custom field.