Erstellen Sie eine SCIM ETL-Definition

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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 mit Bedacht. Die Rolle „scim_admin“ entspricht dem Gewähren der Rolle „admin“, 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 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 Anwender erstellen:
      • scim-user: Für die Felder, die aus SCIM stammen.
      • Tabelle „user“ (sys_user) oder „group“ (sys_user_group): Für die Felder, die Sie aus der Datenbanktabelle mit SCIM zuordnen möchten. Beispielsweise können Sie zur Anpassung von Benutzerdetails über SCIM die Tabelle sys_user verwenden.
      1. Füllen Sie die Felder des Formulars aus.
        Tabelle : 1. Formular „ETL-Entität“.
        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 Synchronisierung von Datensatzeinfügungen zu garantieren, dass nur ein Datensatz mit eindeutigen zusammengefügten Feldwerten vorhanden ist.
        Business-Regeln ausführen Option zum Ausführen von Business-Regeln.
      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 Feldern ETL-Entität die Felder hinzu, indem Sie auf Neuklicken.
      3. Füllen Sie die Felder des Formulars aus.
        Tabelle : 2. Formular „ETL-Entität“.
        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 geschachtelte 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 kann. Die Optionen sind wie folgt:
        • Erstellen: Erstellt eine neue Referenz oder Auswahl. Weisen Sie die Referenz oder Auswahl dem aktuellen Datensatz zu.
        • Ablehnen: Der gesamte Datensatz wird nicht in der Datenbank gespeichert.
        • 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. Senden 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 anwenderdefinierten Erweiterung aufweisen.

        SCIM-Benutzerentitäten

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

        Anwenderentitäten
        Hinweis:
        Verwenden Sie einen Unterstrich (_), um einen Filter in den eingehenden SCIM-Feldern hinzuzufügen. 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. Anschließend müssen Sie 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 Quellenentitä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 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 Datensätzen „scim-user“ und „ETL-Entität des Anwenders“.
      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 ETL-Ausgabefeld für den Vorgang, wenn der Vorgang eine einzelne Ausgabe erfordert.
        Entitätszuordnung Entitätszuordnung, für die dieser Vorgang gilt.
        Referenzierte Entität Entität, auf die verwiesen wird, und der Vorgang, auf den sie sich bezieht.
        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 Entity) ordnet das Zielfeld als Land (user ETL Entity) zu.

      3. Senden 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 angepassten 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 in eine Zieltabelle laden.