PureCloud champs SCIM et PureCloud
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.dateHire | UserProfile.hr.hireDate.[0].value | Date d'embauche dans le format AAAA-MM-JJ. Accepte le format ISO8601, mais renvoie toujours la partie DATE au format AAAA-MM-JJ. URN complet : urn:ietf:params:scim:schemas : extension:enterprise:2.0: User:dateHire |
| 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 : 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 : Note: Voir Champs d'attributs multivalués. |
| scimUserExtensions. routageLangues.[].nom |
{API des langages de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : Note: Voir Champs d'attributs multivalués. |
| scimUserExtensions. routageLangues.[].compétence |
{API des langages de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : 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>
Où <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"
}
]
}
