Transformationen

  • Artikel

Mit einer Transformation können Sie das Standardverhalten der Synchronisierung eines Attributs mit Microsoft Entra ID unter Verwendung der Cloudsynchronisierung ändern.

Dazu müssen Sie das Schema bearbeiten und es dann über eine Webanforderung erneut übermitteln.

Weitere Informationen zu Cloudsynchronisierungsattributen finden Sie unter Grundlegendes zum Microsoft Entra-Schema.

Abrufen des Schemas

Führen Sie zum Abrufen des Schemas die Schritte in Anzeigen des Synchronisierungsschemasaus.

Benutzerdefinierte Attributzuordnung

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Attributzuordnung hinzuzufügen.

  1. Kopieren Sie das Schema in einen Text-Editor oder Code-Editor, z. B. Visual Studio Code.

  2. Suchen Sie das Objekt, das Sie im Schema aktualisieren möchten.

    Screenshot des Objekts im Schema.

  3. Suchen Sie den Code für ExtensionAttribute3 unter dem Benutzerobjekt.

                            {
                            "defaultValue": null,
                            "exportMissingReferences": false,
                            "flowBehavior": "FlowWhenChanged",
                            "flowType": "Always",
                            "matchingPriority": 0,
                            "targetAttributeName": "ExtensionAttribute3",
                            "source": {
                                "expression": "Trim([extensionAttribute3])",
                                "name": "Trim",
                                "type": "Function",
                                "parameters": [
                                    {
                                        "key": "source",
                                        "value": {
                                            "expression": "[extensionAttribute3]",
                                            "name": "extensionAttribute3",
                                            "type": "Attribute",
                                            "parameters": []
                                        }
                                    }
                                ]
                            }
                        },

  4. Bearbeiten Sie den Code so, dass das company-Attribut ExtensionAttribute3 zugeordnet ist.

                                     {
                                     "defaultValue": null,
                                     "exportMissingReferences": false,
                                     "flowBehavior": "FlowWhenChanged",
                                     "flowType": "Always",
                                     "matchingPriority": 0,
                                     "targetAttributeName": "ExtensionAttribute3",
                                     "source": {
                                         "expression": "Trim([company])",
                                         "name": "Trim",
                                         "type": "Function",
                                         "parameters": [
                                             {
                                                 "key": "source",
                                                 "value": {
                                                     "expression": "[company]",
                                                     "name": "company",
                                                     "type": "Attribute",
                                                     "parameters": []
                                                 }
                                             }
                                         ]
                                     }
                                 },

  5. Kopieren Sie das Schema wieder zurück in den Graph-Tester, ändern Sie den Anforderungstyp in PUT, und wählen Sie Abfrage ausführen aus.

    Ausführen der Abfrage

  6. Navigieren Sie im Portal zur Konfiguration der Cloudsynchronisierung, und wählen Sie Bereitstellung erneut starten aus.

  7. Überprüfen Sie nach einiger Zeit, ob die Attribute gefüllt werden, indem Sie die folgende Abfrage im Graph-Tester ausführen: https://graph.microsoft.com/beta/users/{Azure AD user UPN}.

  8. Der Wert sollte nun angezeigt werden.

    Der Wert wird angezeigt.

Benutzerdefinierte Attributzuordnung mit Funktionen

Für komplexere Zuordnungen können Sie Funktionen verwenden, mit denen Sie entsprechend den Anforderungen Ihrer Organisation die Daten bearbeiten und Werte für Attribute erstellen können.

Führen Sie dazu die oben beschriebenen Schritte aus, und bearbeiten Sie dann die Funktion, über die der endgültige Wert erstellt wird.

Informationen zur Syntax und Beispiele für Ausdrücke finden Sie unter Schreiben von Ausdrücken für Attributzuordnungen in Microsoft Entra ID.

Nächste Schritte