PureCloud champs SCIM et PureCloud

Remarque :  Cet article s’applique à PureCloud SCIM (gestion des identités).

Ce tableau montre les champs SCIM que PureCloud SCIM (Identity Management) mappe aux champs PureCloud. Ces champs SCIM sont ensuite mappés à des champs dans les applications des participant tiers. 

Champ SCIM Champ Genesys Cloud Notes
identifiant UserProfile.Id
Nom d’utilisateur UserProfile.contactInfo.email_main.[0].value
État UserProfile.state vrai eq 'actif' faux eq 'inactif'
Afficher un nom UserProfile.general.name.[0].value
titre UserProfile.general.title.[0].value
scimEnterpriseUser.manager.value UserProfile.relationsships.manager.[0].value URN complet : urn:ietf:params:scim:schemas :
extension:entreprise:2.0:
Utilisateur : manager.value
scimEnterpriseUser.department UserProfile.general.department.[0].value URN complet : urn:ietf:params:scim:schemas :
extension:entreprise:2.0:
User.department
scimEnterpriseUser.division UserProfile.divisionId URN complet : urn:ietf:params:scim:schemas :
extension:entreprise:2.0:
Utilisateur.division
e-mails[type eq "autre"].valeur UserProfile.contactInfo.email_main.[0].value Ce champ est identique à userName. Ce champ est en lecture seule. 
Remarque : Voir Filtrer les attributs multivalués.
e-mails[type eq "travail"].valeur UserProfile.contactInfo.email_work.[0].value Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "work<"].value UserProfile.contactInfo.[0].phone_work.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "work2"].value UserProfile.contactInfo.[0].phone_work_2.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "work3"].value UserProfile.contactInfo.[0].phone_work_3.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "work4"].value UserProfile.contactInfo.[0].phone_work_4.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "home"].value UserProfile.contactInfo.[0].phone_home.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "other"].value UserProfile.contactInfo.[0].phone_other.[0].value.number Note: Voir Filtrer les attributs multivalués.
phoneNumbers[type eq "mobile"].value UserProfile.contactInfo.[0].phone_mobile.[0].value.number Note: Voir Filtrer les attributs multivalués.
meta.location {UserProfile auto-URL}
meta.version (ETag) UserProfile.version
meta.lastModified UserProfile.dateModified
ID externe {API d'identification externe}
rôles. [].valeur {API rôles utilisateur} Note: Voir Champs d'attributs multivalués.
nom.nom donné Non pris en charge actuellement par Genesys Cloud.
nom.familleName Non pris en charge actuellement par Genesys Cloud.
adresses[type eq "travail"].code postal Non pris en charge actuellement par Genesys Cloud. 
adresses[type eq "autre"].Formaté Non pris en charge actuellement par Genesys Cloud.
adresses[type eq "travail"].Adresse de la rue Non pris en charge actuellement par Genesys Cloud.
e-mails[type eq "{taper}"].primaire UserProfile.primaryContactInfo.email.[0].value.fieldPath

Ce champ est défini sur une constante booléenne "vrai" dans la cartographie des fournisseurs.

Note: Voir Filtrer les attributs multivalués.

Numéros de téléphone[type eq "{taper}"].primaire UserProfile.primaryContactInfo.voice.[0].value.fieldPath

Ce champ désigne le numéro de téléphone associé au champ comme numéro de téléphone principal dans les coordonnées de l'utilisateur. Ce champ correspond à la constante booléenne "true" dans le mappage du fournisseur.

Note: Voir Filtrer les attributs multivalués.

groupes UserProfile.groups[type eq official] + {groupes où l'utilisateur est propriétaire}
mot de passe Des profils d’utilisateurs Le mot de passe ne peut pas être retourné mais peut être mis à jour avec PUT ou PATCH. 
scimEnterpriseUser.employeeNumber UserProfile.hr.empId.[0].value URN complet : urn:ietf:params:scim:schemas :
extension:entreprise:2.0:
Utilisateur.employeeNumber
scimUserExtensions.
RoutingSkills.[].name
{API de compétences de routage utilisateur}

URN complet : urn:ietf:params:scim:schemas :
extension:genesys:purecloud:2.0:
Utilisateur : compétences de routage.[].nom

Note: Voir Champs d'attributs multivalués.

scimUserExtensions.
Compétences de routage.[].compétence
{API de compétences de routage utilisateur}

URN complet : urn:ietf:params:scim:schemas :
extension:genesys:purecloud:2.0:
Utilisateur:routingSkills.[].proficiency

Note: Voir Champs d'attributs multivalués.

scimUserExtensions.
routageLangues.[].nom
{API des langages de routage utilisateur}

URN complet : urn:ietf:params:scim:schemas :
extension:genesys:purecloud:2.0:
Utilisateur:routingLanguages.[].name

Note: Voir Champs d'attributs multivalués.

scimUserExtensions.
routageLangues.[].compétence
{API des langages de routage utilisateur}

URN complet : urn:ietf:params:scim:schemas :
extension:genesys:purecloud:2.0:
Utilisateur:routingLanguages.[].proficiency

Note: Voir Champs d'attributs multivalués.

Champs d'attributs à valeurs multiples

Le tableau de correspondance des champs SCIM et Genesys Cloud ne répertorie que les sous-attributs essentiels requis pour chaque correspondance. Bien que des sous-attributs supplémentaires soient disponibles, tels que définis dans RFC 7643 Section 2.4, seuls les sous-attributs essentiels sont énumérés dans le tableau. Pour obtenir une liste complète des sous-attributs d'un attribut à valeurs multiples, il convient de se référer à la spécification SCIM.

Les champs SCIM à attributs multiples suivent ce format :

<attribute>.[].<subattribute>

<attribute> fait référence aux éléments de la liste d'attributs multivalués et <subattribute> indique le sous-attribut spécifique de chaque élément qui est requis pour la mise en correspondance.

Le schéma JSON générique pour ce format est le suivant :

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

Utilisez l'un des validateurs de schéma JSON en ligne pour valider le schéma JSON pour les références d'attributs multivalués dans le mappage du tableau. Par exemple, dans la correspondance roles.[].value, roles représente <attribute> et value représente <subattribute>.

 L'élément JSON pour le mappage roles.[].value est donc validé comme suit :

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

Filtrer les attributs à valeurs multiples

Certains attributs SCIM à valeurs multiples nécessitent la mise en correspondance d'un élément de liste spécifique avec un champ Genesys Cloud. Dans ce cas, un sous-attribut supplémentaire est spécifié comme champ de filtrage pour la liste. Ce champ de filtre devient un sous-attribut obligatoire pour cet élément.

Par exemple, dans le champ phoneNumbers[type eq "home"].value, phoneNumbers représente le <attribute>, value représente le <subattribute>, et type est le <subattribute> supplémentaire utilisé pour le filtrage. Contrairement aux correspondances standard qui ne nécessitent pas de filtre, le sous-attribut type est utilisé pour identifier et lier l'entrée du numéro de téléphone correct dans la liste. Avec le type de sous-attribut supplémentaire, l'élément JSON utilisé pour le mappage est validé comme suit :

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