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 Usuario.Id
nombre de usuario User.contactInfo.email_main.[0].value
estado Usuario.estado true eq 'activo' false eq 'inactivo'
nombre para mostrar Usuario.general.nombre.[0].valor
título User.general.title.[0].value
scimEnterpriseUser.manager.value Usuario.relaciones.gestor.[0].valor URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: manager.value
scimEnterpriseUser.dateHire User.hr.hireDate.[0].value Fecha de contratación en el formato AAAA-MM-DD. Acepta el formato ISO8601, pero siempre devuelve la parte DATE en formato AAAA-MM-DD.
Full URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
User:dateHire
scimEnterpriseUser.department Usuario.general.departamento.[0].valor URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: departamento
scimEnterpriseUser.division Usuario.divisionId URN completo: urn: ietf: params: scim: esquemas:
extensión: empresa: 2.0:
Usuario: division
correos electrónicos [escriba eq "otro"].valor User.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 User.contactInfo.email_work.[0].value Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work<"].value User.contactInfo.[0].phone_work.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work2"].value User.contactInfo.[0].phone_work_2.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work3"].value User.contactInfo.[0].phone_work_3.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "work4"].value User.contactInfo.[0].phone_work_4.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "home"].value User.contactInfo.[0].phone_home.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "other"].value User.contactInfo.[0].phone_other.[0].value.number Nota: Véase Filtrar atributos multivaluados.
phoneNumbers[type eq "mobile"].value User.contactInfo.[0].phone_mobile.[0].value.number Nota: Véase Filtrar atributos multivaluados.
meta.location {Usuario auto URL}
meta.version (ETag) Usuario.versión
meta.lastModified Usuario.fechaModificado
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 User.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 Usuario.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 User.groups[type eq official] + {grupos donde el usuario es el propietario}
contraseña Perfil del usuario La contraseña no se puede devolver, pero se puede actualizar con PUT o PATCH. 
scimEnterpriseUser.employeeNumber User.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" 
     }
   ]
 }