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.
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.