Erstellen Sie eine SCIM-ETL-Definition

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 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 dieser Rolle sorgfältig. Die Rolle „scim_admin“ entspricht der Zuweisung der Administratorrolle, 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 Sie können 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 (Extract Transform Load) .
    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-user: Für die Felder, die aus SCIM stammen.
      • Tabelle „Anwender“ (sys_user) oder „Gruppe“ (sys_user_Group): 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 durch Synchronisieren von Datensatzeinfügungen nur einen Datensatz mit eindeutigen zusammengefügten Feldwerten zu garantieren.
        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-user und user).
      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. Die Optionen sind wie folgt:
        • 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 : Legen Sie 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 ETL-Entität scim-user kann Entitäten mit der Kernerweiterung (Anwender) haben ServiceNow Erweiterung 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 Feldern für eingehende SCIM hinzuzufügen, verwenden Sie einen Unterstrich ( _ ). Dieser Unterstrich wird in einen EQ-Filter übersetzt. Zum Beispiel das Attribut email.type_work.valueWendet den SCIM-Filter der E-Mail an [type eq “work”].value.

        Nachdem die Felder sowohl in den Datensätzen „scim-user“ als auch „Anwender-ETL-Entitätszuordnung“ 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 Feldzuordnung.
      Quellentität Quellentität für die Zuordnung.
      Zielentität Zielentität für die Zuordnung.
      Reihenfolge Reihenfolge, in der die Zuordnung verarbeitet werden soll.
      Ist bedingt Option, um die Zuordnung als bedingt festzulegen.
      Bedingungsskript Skript, das die Bedingungen definiert, die für die Zuordnung erfüllt sein 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) durchgeführt werden.
      RTE-Entitätszuordnung
    7. Klicken Sie auf Absenden.

      Das folgende Beispiel zeigt einen Datensatz, der für die Zuordnung der Datensätze scim-user und Anwender-ETL-Entität erstellt wurde.

      scim-user-Zuordnungen
    8. Öffnen Sie den übermittelten Datensatz (scim-user-Mappings), und erstellen Sie eine Zuordnung zwischen den Datensätzen der scim-user- und ETL-Entität des Anwenders.
      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 Feld „ETL-Ausgabe“ für den Vorgang, 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.
        Reihenfolge 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.