SCIM 和 Genesys Cloud 字段映射

注意: 本文适用于 Genesys Cloud SCIM(身份管理)。

下表显示了 Genesys Cloud SCIM(身份管理)映射到 Genesys Cloud 字段的 SCIM 字段。 然后,这些 SCIM 字段将映射到第三方应用程序中的字段。 

SCIM 字段 Genesys Cloud 呼叫 注释
id 用户配置文件 .id
用户名 用户配置文件。联系信息 .email_main。[0] .value
状态 用户配置文件。状态 true eq “活动” false eq “非活动”
显示名称 用户配置文件。常规。名称。[0] .value
标题 用户配置文件。常规。标题。[0] .value
scimEnterprise User.manager.value 用户配置文件。关系。管理器。[0] .value 完整的 URN: urn: ietf:params: scims: 模式:
扩展名:企业版:2.0:
用户:经理。值
scimEnterprise 用户。部门 用户配置文件。常规。部门。[0] .value 完整的 URN: urn: ietf:params: scims: 模式:
扩展名:企业版:2.0:
用户:部门
scimEnterprise User.Division 用户配置文件。DivisionID 完整的 URN: urn: ietf:params: scims: 模式:
扩展名:企业版:2.0:
用户分部
电子邮件 [键入 eq "other"] .value 用户配置文件。联系信息 .email_main。[0] .value 此字段与userName相同。此字段为只读。 
注意:过滤多值属性
电子邮件 [键入 eq "work"] .value 用户配置文件。联系信息 .email_work。[0] .value 笔记:看过滤多值属性
phoneNumbers[type eq "work<"].value 用户个人资料。联系信息。[0] .phone_work。[0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "work2"].value 用户配置文件。联系信息。[0] .phone_work_2. [0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "work3"].value 用户配置文件。联系信息。[0] .phone_work_3. [0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "work4"].value 用户配置文件。联系信息。[0] .phone_work_4. [0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "home"].value 用户配置文件。联系信息。[0] .phone_home。[0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "other"].value 用户个人资料。联系信息。[0] .phone_other。[0] .value.number 笔记:看过滤多值属性
phoneNumbers[type eq "mobile"].value 用户个人资料。联系信息。[0] .phone_mobile。[0] .value.number 笔记:看过滤多值属性
meta.location {用户配置文件自身 URL}
meta.version (ETag) 用户配置文件。版本
meta.Last 修改 用户配置文件。日期已修改
外部 ID {外部 ID API}
角色。[] .value {用户角色 API} 笔记:看多值属性字段
名称 .GivenName Genesys Cloud 目前不支持。
姓名。姓氏 Genesys Cloud 目前不支持。
地址 [键入 eq "work"]。邮政编码 Genesys Cloud 目前不支持。 
地址 [键入 eq "other"]。已格式化 Genesys Cloud 目前不支持。
地址 [键入 eq "work"]。街道地址 Genesys Cloud 目前不支持。
电子邮件 [键入 eq "{type}"]。主 用户配置文件。主要联系信息。电子邮件。[0] .value.field Path

在供应商映射中,此字段设置为布尔常量 true”。

笔记:看过滤多值属性

电话号码 [键入 eq "{type}"]。主 用户配置文件。主要联系信息。语音。[0]。值。字段路径

此字段将与该字段关联的电话号码指定为用户联系信息上的主要电话号码。该字段设置为布尔常量真的在供应商映射中。

笔记:看过滤多值属性

用户配置文件。组 [键入 eq 官方] + {用户为所有者的组}
密码 用户资料 无法返回密码,但可以使用 PUT 或 PATCH 进行更新。 
scimEnterprise User.雇员数/员工数量 用户配置文件 .hr.empid. [0]. 值 完整的 URN: urn: ietf:params: scims: 模式:
扩展名:企业版:2.0:
用户:员工编号
scimuseExtensions。
路由技能。[]. name
{用户路由技能 API}

完整的 URN: urn: ietf:params: scims: 模式:
扩展名:genesys: purecloud: 2.0:
用户:路由技能。[] .name

笔记:看多值属性字段

scimuseExtensions。
路由技能。[]. 熟练程度
{用户路由技能 API}

完整的 URN: urn: ietf:params: scims: 模式:
扩展名:genesys: purecloud: 2.0:
用户:路由技能。[]. 熟练程度

笔记:看多值属性字段

scimuseExtensions。
路由语言。[]. 名称
{用户路由语言 API}

完整的 URN: urn: ietf:params: scims: 模式:
扩展名:genesys: purecloud: 2.0:
用户:路由语言。[] .name

笔记:看多值属性字段

scimuseExtensions。
路由语言。[]. 熟练
{用户路由语言 API}

完整的 URN: urn: ietf:params: scims: 模式:
扩展名:genesys: purecloud: 2.0:
用户:路由语言。[]. 熟练程度

笔记:看多值属性字段

多值属性字段

SCIM 和 Genesys Cloud 字段映射表仅列出了每个映射所需的基本子属性。虽然有其他子属性可用,如RFC 7643 第 2.4 节,表中仅列出必要的。有关任何多值属性的子属性的完整列表,请参阅 SCIM 规范。

多值属性 SCIM 字段遵循以下格式:

<attribute>.[].<subattribute>

在哪里<attribute>引用多值属性列表中的元素,并且<subattribute>表示映射所需的每个元素的特定子属性。

此格式的通用 JSON 模式为:

{
   "$schema": "http://json-schema.org/draft-04/schema#",
   "type": "object",
   "required": ["<attribute>"],
   "properties": {
     "attribute": {
       "type": "array",
       "items": [
         {
           "type": "object",
           "additionalProperties":true,
           "required": ["<sub_attribute>"],
           "properties": {
             "sub_attribute": {
               "type": "string"
             }
           }
        }
      ]
    }
  }
}

使用任何在线 JSON 模式验证器来验证表中映射中的多值属性引用的 JSON 模式。例如,在roles.[].value映射,roles代表<attribute>value代表<subattribute>

 JSON 元素为roles.[].value因此映射验证如下:

 {
   "roles": [
     {
       "other": "this is allowed but doesn’t contribute to the roles mapping",
       "value": "Role1"
     },
     {
       "value": "Role2"
     }
   ]
 }

过滤多值属性

一些 SCIM 多值属性需要将特定列表项映射到 Genesys Cloud 字段。在这些情况下,会指定一个附加子属性作为列表的过滤字段。此过滤字段将成为该元素的强制子属性。

例如,在phoneNumbers[type eq "home"].value场地,phoneNumbers代表<attribute>value代表<subattribute>, 和type是额外的<subattribute>用于过滤。与不需要过滤器的标准映射不同,type子属性用于识别并绑定到列表中正确的电话号码条目。使用额外的子属性类型,用于映射的 JSON 元素验证如下:

 {
   "phoneNumbers": [
     {
       "type": "home",
       "value": "+13175551234"
     },
     {
       "type": "mobile",
       "value": "+13175554321" 
     }
   ]
 }