CIC Data Connector external fields


The CIC Data 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 CIC Data Connector in the JSON configuration. For help, see Edit the JSON configuration. You can:

  • Map CIC fields to your preference in Collaborate and Collaborate fields to your preference in CIC.
  • Map more than one field to a single field in either direction.
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 CIC Data 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 CIC configuration mapping.

CIC field name Description Type Sync direction Collaborate field name
Person.EmailAddress User configuration: Personalinfo/Internet/Business Email String

2way_in

2way_ex

contactInfo.email_main
Person.Extension User configuration: Configuration/Extension Integer

2way_in

2way_ex

contactInfo.phone_
work.extension
Person.DisplayName User configuration: Personal Info/General/>Display Name String

2way_in

2way_ex

general.name
Person.Title User configuration: Personal Info/Business/Title
String

2way_in

2way_ex

general.title
Person.DepartmentName User configuration: Personal Info/Business/Department String

2way_in

2way_ex

general.department
Person.Business1Number User configuration: Personal Info/General/Business Phone Integer

2way_in

2way_ex

contactInfo.phone_work
Person.FaxNumber User configuration: Personal Info/More Phone Numbers/Fax Integer

2way_in

2way_ex

contactInfo.phone_other


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

CIC field name Description Type Sync direction Collaborate field name
Person.Id Username configured when user is created, also ID of CIC User String ex2in hr.empid
Person.Alias User configuration: Personal Info/Internet/Alias String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Surname User configuration: Personal Info/General/Last Name String

ex2in

(concatenated)

general.name

Person.GivenName and Person.Surname, concatenated in that order.

Person.NTDomainUser User configuration: Configuration/NT Domain User String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.AssistantName User configuration: Personal Info/Business 2/Assistant String

2way_in

2way_ex

relationships.assistant
Person.City User configuration: Personal Info/Home/City String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.CompanyName User configuration: Personal Info/General/Company String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Country User configuration: Personal Info/Home/Country String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.EmailAlias User configuration: Personal Info/Internet/Alias String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.GivenName User configuration: Personal Info/General/First Name String

ex2in

(concatenated)

general.name

Person.GivenName and Person.Surname, concatenated in that order.

Person.Notes User configuration: Personal Info/Notes String

2way_in

2way_ex

bio.bio
Person.OfficeLocation User configuration: Personal Info/Business/Address String

2way_in

2way_ex

contactInfo.address
Person.PostalCode User configuration: Personal Info/Home/Zip Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.StreetAddress User configuration: Personal Info/Home/Address String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.StateOrProvince User configuration: Personal Info/Home/State String

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.AssistantNumber User configuration: Personal Info/Business 2/Phone Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.AssistantExtension User configuration: Personal Info/Business 2/Ext Integer

2way_in

2way_ex

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

Person.Business1Extension User configuration: Personal Info/General/Business Phone Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Business2Number User configuration: Personal Info/More Phone Numbers/Business Phone 2 Integer

2way_in

2way_ex

contactInfo.phone_other
Person.Business2Extension User configuration: Personal Info/More Phone Numbers/Business Phone Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.FaxExtension User configuration: Personal Info/More Phone Numbers/Fax Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Home1Number User configuration: Personal Info/General/Home Phone Integer

2way_in

2way_ex

contactInfo.phone_home
Person.Home1Extension User configuration: Personal Info/General/Home Phone Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Home2Number User configuration: Personal Info/More Phone Numbers/Home Phone 2 Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.Home2Extension User configuration: Personal Info/More Phone Numbers/Home Phone 2 Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.MobileNumber User configuration: Personal Info/More Phone Numbers/Mobile Integer

2way_in

2way_ex

contactInfo.phone_cell
Person.MobileExtension User configuration: Personal Info/More Phone Numbers/Mobile Ext Integer

2way_in

2way_ex

No default field for this value. Create a custom field if needed.
Person.PagerNumber User configuration: Personal Info/More Phone Numbers/Pager Integer

2way_in

2way_ex

contactInfo.phone_other
Person.PagerExtension User configuration: Personal Info/More Phone Numbers/Pager Ext Integer

2way_in

2way_ex

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

Vector of user-assigned skills names (Does not get inherited skills).

The CIC administrator configures user-assigned skills in User configuration: ACD.

Tag ex2in skills.skills
Person.WebRTCExtension

The CIC WebRTC connector assigns this extension to the CIC web-based phone for internal use.

Added automatically when the CIC web-based phone integration is enabled. Do not change.

Integer ex2in contactInfo.phone_work
_4.extension



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.