Asignaciones de campos de SCIM y Genesys Cloud

Nota: Este artículo se aplica a Genesys Cloud SCIM (Gestión de identidades).

Esta tabla muestra los campos SCIM que Genesys Cloud SCIM (Gestión de identidad) asigna a los campos Genesys Cloud. Estos campos SCIM luego se asignan a campos en aplicaciones de terceros. 

Campo SCIM Campo de Genesys Cloud Notas
identificación UserProfile.Id
nombre de usuario UserProfile.contactInfo.email_main. [0] .value
estado UserProfile.state true eq 'active' false eq 'inactive'
nombre para mostrar UserProfile.general.name. [0] .value
título UserProfile.general.title. [0] .value
scimEnterpriseUser.manager.value UserProfile.relationships.manager. [0] .value URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: manager.value
scimEnterpriseUser.department UserProfile.general.department. [0] .value URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: departamento
scimEnterpriseUser.division UserProfile.divisionId URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: division
correos electrónicos [escriba eq "otro"].valor UserProfile.contactInfo.email_main. [0] .value Este campo es el mismo que userName. Este campo es de sólo lectura. 
Nota: Véase Filtrar atributos multivaluados.
correos electrónicos [escriba eq "trabaja"].valor UserProfile.contactInfo.email_work. [0] .value Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work<"].value UserProfile.contactInfo. [0] .phone_work. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work2"].value UserProfile.contactInfo. [0] .phone_work_2. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work3"].value UserProfile.contactInfo. [0] .phone_work_3. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work4"].value UserProfile.contactInfo. [0] .phone_work_4. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "home"].value UserProfile.contactInfo. [0] .phone_home. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "other"].value UserProfile.contactInfo. [0] .phone_other. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "mobile"].value UserProfile.contactInfo. [0] .phone_mobile. [0] .value.number Nota: Véase Filtrar atributos multivaluados.
meta.location {URL propia de UserProfile}
meta.version (ETag) UserProfile.version
meta.lastModified UserProfile.dateModified
externalId {API de ID externa}
roles. []. valor {API de roles de usuario} Nota: Véase Campos de atributos multivaluados.
name.givenName Actualmente no es compatible con Genesys Cloud.
name.familyName Actualmente no es compatible con Genesys Cloud.
direcciones [escriba eq "trabaja"].código postal Actualmente no es compatible con Genesys Cloud. 
direcciones [escriba eq "otro"] .Formateado Actualmente no es compatible con Genesys Cloud.
direcciones [escriba eq "trabaja"].Dirección Actualmente no es compatible con Genesys Cloud.
correos electrónicos [escriba eq "{escribe}"].primario UserProfile.primaryContactInfo.email. [0] .value.fieldPath

Este campo se establece en constante booleana "cierto" en el mapeo de proveedores.

Nota: Véase Filtrar atributos multivaluados.

phoneNumbers [type eq "{escribe}"].primario UserProfile.primaryContactInfo.voice. [0] .value.fieldPath

Este campo designa el número de teléfono asociado al campo como número de teléfono principal en la información de contacto del usuario. Este campo se establece en la constante booleana "true" en la asignación de proveedores.

Nota: Véase Filtrar atributos multivaluados.

grupos UserProfile.groups [type eq official] + {grupos donde el usuario es propietario}
contraseña Perfil del usuario La contraseña no se puede devolver, pero se puede actualizar con PUT o PATCH. 
scimEnterpriseUser.employeeNumber UserProfile.hr.empId. [0] .value URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: employeeNumber
scimUserExtensions.
routingSkills. []. nombre
{API de habilidades de enrutamiento del usuario}

URN completo: urn: ietf: params: scim: esquemas:
extensión: genesys: purecloud: 2.0:
Usuario: routingSkills. []. Name

Nota: Véase Campos de atributos multivaluados.

scimUserExtensions.
routingSkills. []. proficiency
{API de habilidades de enrutamiento del usuario}

URN completo: urn: ietf: params: scim: esquemas:
extensión: genesys: purecloud: 2.0:
Usuario: routingSkills. []. Proficiency

Nota: Véase Campos de atributos multivaluados.

scimUserExtensions.
routingLanguages. []. nombre
{API de lenguajes de enrutamiento de usuario}

URN completo: urn: ietf: params: scim: esquemas:
extensión: genesys: purecloud: 2.0:
Usuario: routingLanguages. []. Name

Nota: Véase Campos de atributos multivaluados.

scimUserExtensions.
routingLanguages. []. proficiency
{API de lenguajes de enrutamiento de usuario}

URN completo: urn: ietf: params: scim: esquemas:
extensión: genesys: purecloud: 2.0:
Usuario: routingLanguages. []. Proficiency

Nota: Véase Campos de atributos multivaluados.

Campos de atributos multivaluados

La tabla de asignaciones de campos de SCIM y Genesys Cloud enumera únicamente los subatributos esenciales necesarios para cada asignación. Aunque existen subatributos adicionales definidos en RFC 7643 Sección 2.4, en la tabla sólo se enumeran los esenciales. Para obtener una lista completa de los subatributos de cualquier atributo multivaluado, consulte la especificación SCIM.

Los campos SCIM de atributos multivaluados siguen este formato:

<attribute>.[].<subattribute>

Donde <attribute> se refiere a los elementos de la lista de atributos multivaluados y <subattribute> indica el subatributo específico de cada elemento que se requiere para la asignación.

El esquema JSON genérico para este formato es:

{
   "$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"
             }
           }
        }
      ]
    }
  }
}

Utilice cualquiera de los validadores de esquema JSON en línea para validar el esquema JSON para las referencias de atributos multivaluados en la asignación de la tabla. Por ejemplo, en la correspondencia roles.[].value, roles representa <attribute> y value representa <subattribute>.

 Por lo tanto, el elemento JSON para el mapeo roles.[].value se valida de la siguiente manera:

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

Filtrar atributos multivaluados

Algunos atributos multivaluados SCIM requieren la asignación de un elemento específico de la lista a un campo de Genesys Cloud. En estos casos, se especifica un subatributo adicional como campo de filtro de la lista. Este campo de filtro se convierte en un subatributo obligatorio para ese elemento.

Por ejemplo, en el campo phoneNumbers[type eq "home"].value, phoneNumbers representa el <attribute>, value representa el <subattribute>, y type es el <subattribute> extra utilizado para el filtrado. A diferencia de las correspondencias estándar que no necesitan filtro, el subatributo type se utiliza para identificar y vincular la entrada del número de teléfono correcto en la lista. Con el tipo de subatributo extra, el elemento JSON utilizado para el mapeo se valida de la siguiente manera:

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