Erstellen Sie eine SCIM-ETL-Definition

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer
  • Verwenden Sie die SCIM-ETL-Definitionen, um die anwenderdefinierten Attribute den Tabellen „sys_user“ oder „sys_user_Group“ zuzuordnen.

    Vorbereitungen

    Erforderliche Rolle: scim_admin

    Warnung:
    Gewähren Sie diese Rolle sorgfältig. Die Rolle „scim_admin“ bedeutet, dem Anwender die Administratorrolle zu geben, wobei die Rolle „scmin_admin“ neue Datensätze in die Tabellen einfügen kann, die Geschäftslogik oder ACL-Schutz umgehen können.
    Hinweis:
    • SCIM-Gruppen- und SCIM-Anwender-ETL-Definitionen sind Teil des Basissystems für die Ressourcenzuordnung. Sie können dieselben Ressourcenzuordnungen verwenden und die Kriterien nach Bedarf ändern oder neue Ressourcenzuordnungen erstellen.
    • Es gibt keine Unterstützung für [*]-Felder über RTE in der SCIM-Zuordnung.

    Prozedur

    1. Befolgen Sie die Anweisungen in Erstellen Sie ETL-Definitionen (Extrahieren Transformationsladen) .
    2. Öffnen Sie den neu erstellten Datensatz, und zeigen Sie die Details an.
    3. Erstellen Sie im Abschnitt „ETL-Entitäten“ eine Entität, indem Sie auf klicken Neu .
      Sie müssen Entitäten für die folgenden Anwender erstellen:
      • scim-Anwender: Für die Felder, die aus SCIM stammen.
      • Anwender (sys_user) oder Gruppe (sys_user_Group) Tabelle: Für die Felder, die Sie aus der Datenbanktabelle mit SCIM zuordnen möchten. Zum Anpassen von Anwenderdetails über SCIM können Sie beispielsweise die Tabelle „sys_user“ verwenden.
      1. Füllen Sie im Formular die Felder aus.
        Tabelle : 1. ETL-Entitätsformular
        Feld Beschreibung
        Name Name der ETL-Entität.
        Anwendung Anwendungsbereich für diesen Datensatz.
        Tabelle Zieltabelle für die ETL-Entität.
        Definition Ausgewählte ETL-Entität.
        Pfad Eindeutiger Pfad für diese Entität. Geben Sie keinen Pfad für die Entität an, die die Importsatztabelle darstellt. Wenn eine Entität eine Sammlung darstellt, muss der Pfad mit einem Sternchen [*] enden. Diese Anforderung gilt für Zwischeneinträge und die Zieltabellenentität.
        Einfügungen synchronisieren Option, um sicherzustellen, dass nur ein Datensatz mit eindeutigen zusammengefügten Feldwerten durch Synchronisieren von Datensatzeinfügungen gewährleistet wird.
        Business-Regeln ausführen Option zum Ausführen von Business-Regeln.
      2. Klicken Sie auf Absenden.

        Die ETL-Entitäten werden für scim-Anwender- und Anwendertabellen erstellt. Sie müssen ETL-Entitätsfelder innerhalb dieser ETL-Entitäten erstellen und beide Entitäten zuordnen, indem Sie eine RTE-Entitätszuordnung erstellen.

        ETL-Entität
    4. Erstellen Sie die Entitäten, und ordnen Sie sie zu.
      1. Öffnen Sie den übermittelten Datensatz (scim-Anwender und Anwender).
      2. Fügen Sie in den ETL-Entitätsfeldern die Felder hinzu, indem Sie auf klicken Neu .
      3. Füllen Sie im Formular die Felder aus.
        Tabelle : 2. ETL-Entitätsformular
        Feld Beschreibung
        Name Name der ETL-Entitätsfelddefinition.
        Anwendung Ausgewählte ETL-Entität, zu der diese Felddefinition gehört.
        Feld/Pfad Dieses Feld ist entweder eine Spalte oder ein Pfad.
        • Das Feld ist ein Spaltenname, wenn die Entität die Import- oder Zieltabelle ist.
        • Das Feld ist ein Pfad, wenn das Feld über geschachtelte Strukturen verfügt.
        Entität Entität, für die dieser Vorgang gilt. Wählen Sie die Entität mithilfe des Suchsymbols aus.
        Zwangsaktion Was das System tun soll, wenn eine Referenz oder Auswahl nicht gefunden werden konnte. Folgende Optionen sind verfügbar:
        • Erstellen : Erstellen Sie eine neue Referenz oder Auswahl. Weisen Sie dem aktuellen Datensatz die Referenz oder Auswahl zu.
        • Ablehnen : Speichern Sie nicht den gesamten Datensatz in der Datenbank.
        • Ignorieren : Legt den aktuellen Wert als leer fest.
        Definition Ausgewählte ETL-Entität, zu der diese Felddefinition gehört.
        Zusammenfügen Option zum Abfragen der vorhandenen Datensätze.
        ETL-Entitätsfeld
      4. Übermitteln Sie die Einträge, indem Sie auf klicken Übermitteln .

        Sie können je nach Anforderung mehrere Einträge als ETL-Entitätsfeld hinzufügen.

        Die scim-Anwender-ETL-Entität kann Entitäten mit der Kernerweiterung (Anwender) haben ServiceNowErweiterung oder anwenderdefinierte Erweiterung.

        SCIM-Anwenderentitäten

        Die Anwender-ETL-Entität kann Entitäten aus der Datenbanktabelle haben. Beispiel: Tabelle „sys_user“.

        Anwenderentitäten
        Hinweis:
        Um einen Filter in den eingehenden SCIM-Feldern hinzuzufügen, verwenden Sie einen Unterstrich ( _ ). Dieser Unterstrich wird in einen EQ-Filter übersetzt. Beispiel: Das Attribut email.type_work.valueWendet den SCIM-Filter der E-Mail an [type eq “work”].value.

        Nachdem die Felder sowohl in den scim-Anwender- als auch in den ETL-Entitätsdatensätzen des Anwenders erstellt wurden, müssen Sie einen RTE-Entitätszuordnungsdatensatz erstellen. Sie müssen dann die Quell- und Zieldefinition angeben, um beide Felder zuzuordnen.

    5. Erstellen Sie im Abschnitt „RTE-Entitätszuordnungen“ eine Entitätszuordnung, indem Sie auf klicken Neu
    6. Füllen Sie die Felder im Formular aus.
      Feld Beschreibung
      Name Name der Zuordnung.
      Quellentität Quellentität für die Zuordnung.
      Zielentität Zielentität für die Zuordnung.
      Bestellung Reihenfolge, in der die Zuordnung verarbeitet werden soll.
      Ist bedingt Option zum Festlegen der Zuordnung als bedingt.
      Bedingungsskript Skript, das die Bedingungen definiert, die für die Zuordnung erfüllt werden müssen.
      Anwendung Anwendungsbereich für diesen Datensatz.
      Definition Ausgewählte ETL-Entität, zu der diese Zuordnung gehört.
      Ignorieren Option zum Festlegen, ob diese ETL-Entitätszuordnung ignoriert werden soll, wenn Datenintegrationen mit der robusten Importsatztransformation (RTE) ausgeführt werden.
      RTE-Entitätszuordnung
    7. Klicken Sie auf Absenden.

      Das folgende Beispiel zeigt einen Datensatz, der für die Zuordnung sowohl der scim-Anwender- als auch der Anwender-ETL-Entitätsdatensätze erstellt wurde.

      scim-user-Zuordnungen
    8. Öffnen Sie den übermittelten Datensatz (scim-user-Mappings), und erstellen Sie eine Zuordnung zwischen den scim-user- und Anwender-ETL-Entitätsdatensätzen.
      1. Klicken Sie im Abschnitt „RTE-Feldzuordnungen“ auf Neu .
      2. Füllen Sie im Formular die Felder aus.
        Tabelle : 3. ETL-Entitätsfelder
        Feld Beschreibung
        Quellfeld Anwendungsbereich für diesen Datensatz.
        Anwendung Ausgewählte ETL-Entität, zu der diese Felddefinition gehört.
        Zielfeld ETL-Feld für den Vorgang ausgeben, wenn der Vorgang eine einzelne Ausgabe verwendet.
        Entitätszuordnung Entitätszuordnung, für die dieser Vorgang gilt.
        Referenzierte Entität Entität, auf die verwiesen wird, und der Vorgang, für den sie gilt.
        Definition Ausgewählte ETL-Entität, zu der diese Felddefinition gehört.
        Bestellung Reihenfolge, in der der Vorgang für die Entität ausgeführt wird.
        RTE-Feldzuordnung

        Das Quellfeld Privatadresse: Land (scim-user-ETL-Entität) ordnet das Zielfeld zu Land (Anwender-ETL-Entität).

      3. Übermitteln Sie die Einträge, indem Sie auf klicken Übermitteln .

        Sie können je nach Anforderung mehrere Einträge als RTE-Entitätszuordnungen hinzufügen.

        RTE-Entitätszuordnungen

        Die Quellfelder und Zielfelder werden wie konfiguriert zugeordnet. Wenn Sie CRUD-Vorgänge mit SCIM ausführen, werden die anwenderdefinierten Werte in der entsprechenden Tabelle aktualisiert.

    Ergebnisse

    Mit diesen ETL-Definitionen und -Zuordnungen können Sie Daten aus einer Quelltabelle extrahieren, die Daten nach Bedarf umwandeln und die Daten in eine Zieltabelle laden.