SCIM und Genesys Cloud Feldzuordnungen

Hinweis: Dieser Artikel bezieht sich auf Genesys Cloud SCIM (Identity Management).

Diese Tabelle zeigt die SCIM-Felder, die Genesys Cloud SCIM (Identity Management) auf Genesys Cloud-Felder abbildet. Diese SCIM-Felder werden dann Feldern in Drittanwendungen zugeordnet. 

SCIM-Feld Genesys Cloud Call Notizen
id BenutzerProfil.Id
Benutzername UserProfile.contactInfo.email_main.[0].value
Status UserProfile.state true eq 'aktiv' false eq 'inaktiv'
Anzeigename UserProfile.general.name.[0].value
Titel UserProfile.general.title.[0].value
scimEnterpriseUser.manager.value UserProfile.relationships.manager.[0].value Vollständige URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
Benutzer:manager.wert
scimEnterpriseUser.abteilung UserProfile.general.department.[0].value Vollständige URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
Benutzer:Abteilung
scimEnterpriseUser.division UserProfile.divisionId Vollständige URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
Geschäftsbereich des Benutzers
emails[type eq "andere"].value UserProfile.contactInfo.email_main.[0].value Dieses Feld ist dasselbe wie der Benutzername. Dieses Feld ist schreibgeschützt. 
Hinweis: Sehen Filtern von mehrwertigen Attributen .
emails[type eq "work"].value UserProfile.contactInfo.email_work.[0].value Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " Arbeit< " ].Wert UserProfile.contactInfo.[0].phone_work.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " Arbeit2 " ].Wert UserProfile.contactInfo.[0].phone_work_2.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " Arbeit3 " ].Wert UserProfile.contactInfo.[0].phone_work_3.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " Arbeit4 " ].Wert UserProfile.contactInfo.[0].phone_work_4.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " heim " ].Wert UserProfile.contactInfo.[0].phone_home.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " andere " ].Wert UserProfile.contactInfo.[0].phone_other.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
Telefonnummern[Typ eq " Mobile " ].Wert UserProfile.contactInfo.[0].phone_mobile.[0].value.number Notiz : Sehen Filtern von mehrwertigen Attributen .
meta.standort {Benutzerprofil selbst URL}
meta.version (ETag) BenutzerProfil.Version
meta.lastModified UserProfile.dateModified
externalId {externe ID API}
rollen.[].Wert {Benutzerrollen API} Notiz : Sehen Mehrwertige Attributfelder .
name.givenName Wird derzeit nicht von Genesys Cloud unterstützt.
name.familienname Wird derzeit nicht von Genesys Cloud unterstützt.
addresses[type eq "work"].postalCode Wird derzeit von Genesys Cloud nicht unterstützt. 
adressen[Typ eq "andere"].Formatiert Wird derzeit nicht von Genesys Cloud unterstützt.
addresses[type eq "work"].streetAddress Wird derzeit nicht von Genesys Cloud unterstützt.
emails[type eq "{type}"].primary UserProfile.primaryContactInfo.email.[0].value.fieldPath

Dieses Feld ist in der Anbieterzuordnung auf die boolesche Konstante "true" gesetzt

Notiz : Sehen Filtern von mehrwertigen Attributen .

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

Dieses Feld legt die dem Feld zugeordnete Telefonnummer als primäre Telefonnummer in den Kontaktinformationen des Benutzers fest. Dieses Feld wird auf die Boolesche Konstante gesetzt " WAHR " in der Lieferantenzuordnung.

Notiz : Sehen Filtern von mehrwertigen Attributen .

Gruppen UserProfile.groups[type eq official] + {groups where user is owner}
Kennwort Benutzerprofil Das Passwort kann nicht zurückgegeben werden, kann aber mit PUT oder PATCH aktualisiert werden. 
scimEnterpriseUser.employeeNumber BenutzerProfil.hr.empId.[0].Wert Vollständige URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
Benutzer:MitarbeiterNummer
scimUserExtensions.
routingSkills.[].name
(Benutzer-Routing-Fähigkeiten API)

Vollständige URN: urn:ietf:params:scim:schemas:
erweiterung:genesys:purecloud:2.0:
Benutzer:routingSkills.[].name

Notiz : Sehen Mehrwertige Attributfelder .

scimUserExtensions.
routingSkills.[].proficiency
(Benutzer-Routing-Fähigkeiten API)

Vollständige URN: urn:ietf:params:scim:schemas:
erweiterung:genesys:purecloud:2.0:
Benutzer:routingSkills.[].proficiency

Notiz : Sehen Mehrwertige Attributfelder .

scimUserExtensions.
routingLanguages.[].name
(User Routing Languages API)

Vollständige URN: urn:ietf:params:scim:schemas:
erweiterung:genesys:purecloud:2.0:
Benutzer:routingLanguages.[].name

Notiz : Sehen Mehrwertige Attributfelder .

scimUserExtensions.
routingLanguages.[].proficiency
(User Routing Languages API)

Vollständige URN: urn:ietf:params:scim:schemas:
erweiterung:genesys:purecloud:2.0:
Benutzer:routingLanguages.[].proficiency

Notiz : Sehen Mehrwertige Attributfelder .

Mehrwertige Attributfelder

In der SCIM- und Genesys Cloud-Feldzuordnungstabelle sind nur die wesentlichen Unterattribute aufgeführt, die für jede Zuordnung erforderlich sind. Während zusätzliche Unterattribute verfügbar sind, wie in RFC 7643 Abschnitt 2.4 , in der Tabelle sind nur die wichtigsten aufgeführt. Eine umfassende Liste der Unterattribute für jedes mehrwertige Attribut finden Sie in der SCIM-Spezifikation.

Die SCIM-Felder mit mehrwertigen Attributen folgen diesem Format:

<attribute>.[].<subattribute>

Wo<attribute> bezieht sich auf die Elemente in der mehrwertigen Attributliste und<subattribute> gibt das spezifische Unterattribut jedes Elements an, das für die Zuordnung erforderlich ist.

Das allgemeine JSON-Schema für dieses Format ist:

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

Verwenden Sie einen der Online-JSON-Schema-Validatoren, um das JSON-Schema für die Verweise auf mehrwertige Attributwerte in der Zuordnung in der Tabelle zu validieren. Beispielsweise in derroles.[].value Abbildung,roles repräsentiert<attribute> Undvalue repräsentiert<subattribute> .

 Das JSON-Element für dieroles.[].value Die Zuordnung wird daher wie folgt validiert:

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

Filtern von mehrwertigen Attributen

Einige SCIM-Attribute mit mehreren Werten erfordern die Zuordnung eines bestimmten Listenelements zu einem Genesys Cloud-Feld. In diesen Fällen wird ein zusätzliches Unterattribut als Filterfeld für die Liste angegeben. Dieses Filterfeld wird zu einem obligatorischen Unterattribut für dieses Element.

Beispielsweise in derphoneNumbers[type eq "home"].value Feld,phoneNumbers repräsentieren die<attribute> ,value repräsentiert die<subattribute> , Undtype ist das Extra<subattribute> wird zum Filtern verwendet. Im Gegensatz zu den Standardmappings, die keinen Filter benötigen,type Das Unterattribut wird verwendet, um den richtigen Telefonnummerneintrag in der Liste zu identifizieren und daran zu binden. Mit dem zusätzlichen Unterattributtyp wird das für die Zuordnung verwendete JSON-Element wie folgt validiert:

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