Erstellen Sie eine SCIM ETL-Definition

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Verwenden Sie die SCIM-ETL-Definitionen, um die benutzerdefinierten Attribute den Tabellen „sys_user“ oder „sys_user_group“ zuzuordnen.

    Vorbereitungen

    Erforderliche Rolle: scim_admin

    Warnung:
    Gewähren Sie diese Rolle mit Bedacht. Die Rolle scim_admin ist gleichbedeutend mit der Zuweisung der Rolle admin an den Benutzer, wobei die Rolle scmin_admin neue Datensätze in die Tabellen einfügen kann, die Geschäftslogik oder ACL-Schutz umgehen können.
    Hinweis:
    • ETL-Definitionen für SCIM-Gruppen und SCIM-Benutzer 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.
    • [*]-Felder werden über RTE in der SCIM-Zuordnung nicht unterstützt.

    Prozedur

    1. Befolgen Sie die Anweisungen unter ETL-Definitionen (Extract Transform Load) erstellen.
    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 Neuklicken.
      Sie müssen Entitäten für die folgenden Benutzer erstellen:
      • scim-user: Für die Felder, die aus SCIM stammen.
      • Tabelle „Benutzer“ (sys_user) oder „Gruppe“ (sys_user_group): Für die Felder, die Sie aus der Datenbanktabelle mit SCIM zuordnen möchten. Beispielsweise können Sie für die Anpassung von Benutzerdetails über SCIM die Tabelle sys_user verwenden.
      1. Füllen Sie die Felder des Formulars 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 Import Set-Tabelle 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 vorhanden ist, indem Datensatzeinfügungen synchronisiert werden.
        Business-Regeln ausführen Option zum Ausführen von Business Rules.
      2. Klicken Sie auf Absenden.

        Die ETL-Entitäten werden für die Tabellen scim-user und user 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 Neuklicken.
      3. Füllen Sie die Felder des Formulars aus.
        Tabelle : 2. ETL-Entitätsformular
        Feld Beschreibung
        Name Name der Felddefinition der ETL-Entität.
        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 verschachtelte Strukturen aufweist.
        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 die Referenz oder Auswahl dem aktuellen Datensatz 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 Absendenklicken.

        Sie können basierend auf Ihren Anforderungen mehrere Einträge als ETL-Entitätsfeld hinzufügen.

        Die ETL-Entität scim-user kann Entitäten mit der Core-Erweiterung (Benutzer), der Erweiterung ServiceNow oder der benutzerdefinierten Erweiterung haben.

        scim-user-Entitäten

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

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

        Nachdem die Felder in den ETL-Entitätsdatensätzen scim-user und user 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 Neuklicken
    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 zum Festlegen der Zuordnung als bedingt.
      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, um anzugeben, ob diese ETL-Entitätszuordnung bei Datenintegrationen mit Robust Import Set Transformation (RTE) ignoriert werden soll.
      RTE – Entitätszuordnung
    7. Klicken Sie auf Absenden.

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

      scim-user-mappings
    8. Öffnen Sie den übermittelten Datensatz (scim-user-mappings), und erstellen Sie eine Zuordnung zwischen den ETL-Entitätsdatensätzen scim-user und user.
      1. Klicken Sie im Abschnitt RTE-Feldzuordnungen auf Neu.
      2. Füllen Sie die Felder des Formulars 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 Ausgabe-ETL-Feld für den Vorgang, wenn der Vorgang eine einzelne Ausgabe annimmt.
        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 als Land (user ETL-Entität) zu.

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

        Sie können basierend auf Ihren Anforderungen mehrere Einträge als RTE-Entitätszuordnungen hinzufügen.

        RTE – Entitätszuordnungen

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

    Ergebnisse

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