Créer une définition SCIM ETL

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • Utilisez les définitions SCIM ETL pour mapper les attributs personnalisés sur les tables sys_user ou sys_user_group.

    Avant de commencer

    Rôle requis : scim_admin

    Avertissement :
    Accordez ce rôle avec soin. Le rôle scim_admin équivaut à attribuer à l’utilisateur le rôle administrateur, où le rôle scmin_admin peut insérer de nouveaux enregistrements dans les tables afin de contourner la logique métier ou la protection ACL.
    Remarque :
    • Les définitions de groupe SCIM et d’utilisateur SCIM ETL font partie du système de base pour le mappage des ressources. Vous pouvez utiliser les mêmes mappages de ressources et modifier les critères au besoin, ou créer de nouveaux mappages de ressources.
    • Il n’existe aucune prise en charge des champs [*] via RTE dans le mappage SCIM.

    Procédure

    1. Suivez les instructions dans les définitions Créer une charge de transformation d’extraction (ETL).
    2. Ouvrez l’enregistrement nouvellement créé et consultez les détails.
    3. Dans la section Entités ETL, créez une entité en cliquant sur Nouveau.
      Vous devez créer des entités pour les utilisateurs suivants :
      • scim-user : pour les champs qui proviennent de SCIM.
      • table utilisateur (sys_user) ou groupe (sys_user_group) : pour les champs que vous souhaitez mapper à partir de la table de base de données avec SCIM. Par exemple, pour personnaliser les détails de l’utilisateur via SCIM, vous pouvez utiliser la table sys_user.
      1. Renseignez les champs du formulaire.
        Tableau 1. Formulaire Entité ETL
        Champ Description
        Nom Nom de l’entité ETL.
        Application Le périmètre de l'application pour cet enregistrement.
        Table Table cible de l’entité ETL.
        Définition Entité ETL sélectionnée.
        Chemin d'accès Chemin d’accès unique pour cette entité. Ne spécifiez aucun chemin d’accès pour l’entité représentant la table de jeux d’importation. Lorsqu’une entité représente une collection, le chemin d’accès doit se terminer par un astérisque [*]. Cette exigence s’applique aux entrées intermédiaires et à l’entité de table cible.
        Synchroniser les insertions Option permettant de garantir un seul enregistrement avec des valeurs de champ fusionnées uniques en synchronisant les insertions d’enregistrement.
        Exécuter les règles métier Option pour exécuter des règles métier.
      2. Cliquez sur Envoyer.

        Les entités ETL sont créées pour les tables scim-user et user. Vous devez créer des champs d’entité ETL au sein de ces entités ETL et mapper les deux entités en créant un mappage d’entités RTE.

        Entité ETL
    4. Créez les entités et mappez-les.
      1. Ouvrez l’enregistrement soumis (scim-user et utilisateur).
      2. Dans les champs Entité ETL, ajoutez les champs en cliquant sur Nouveau.
      3. Renseignez les champs du formulaire.
        Tableau 2. Formulaire Entité ETL
        Champ Description
        Nom Nom de la définition de champ de l’entité ETL.
        Application Entité ETL sélectionnée à laquelle appartient cette définition de champ.
        Champ/chemin d'accès Ce champ est soit une colonne, soit un chemin d’accès.
        • Le champ est un nom de colonne lorsque l’entité est la table d’importation ou la table cible.
        • Le champ est un chemin d’accès lorsqu’il possède des structures imbriquées.
        Entité Entité à laquelle cette opération s’applique. Choisissez l’entité à l’aide de l’icône de recherche.
        Action de forçage Ce que le système doit faire si une référence ou un choix est introuvable. Les options sont les suivantes :
        • Créer : créer une référence ou un choix. Affectez la référence ou le choix à l’enregistrement actuel.
        • Rejeter : n’enregistre pas l’enregistrement complet dans la base de données.
        • Ignorer : définit la valeur actuelle sur vide.
        Définition Entité ETL sélectionnée à laquelle appartient cette définition de champ.
        Fusion Option permettant d’interroger les enregistrements existants.
        Champ Entité ETL
      4. Soumettez les entrées en cliquant sur Soumettre.

        Vous pouvez ajouter plusieurs entrées en tant que champ Entité ETL en fonction de vos besoins.

        L’entité ETL scim-user peut avoir des entités avec l’extension principale (utilisateur), l’extension ou l’extension ServiceNow personnalisée.

        Entités utilisateur Scim

        L’entité ETL utilisateur peut avoir des entités de la table de base de données. Par exemple, sys_user table.

        Entités utilisateur
        Remarque :
        Pour ajouter un filtre dans les champs SCIM entrants, utilisez un trait de soulignement (_). Ce trait de soulignement se traduit par un filtre d’égalisation. Par exemple, l’attribut email.type_work.value applique le filtre SCIM de l’e-mail [type eq “work”].value.

        Une fois les champs créés dans les enregistrements d’entité ETL scim-user et utilisateur, vous devez créer un enregistrement de mappage d’entité RTE. Vous devez ensuite spécifier les définitions source et cible pour mapper les deux champs.

    5. Dans la section Mappages d’entités RTE, créez un mappage d’entités en cliquant sur Nouveau
    6. Renseignez les champs du formulaire.
      Champ Description
      Nom Nom du mappage.
      Entité source Entité source pour le mappage.
      Entité cible Entité cible pour le mappage.
      Ordre Ordre dans lequel le mappage doit être traité.
      Est conditionnel Option permettant de désigner le mappage comme conditionnel.
      Script de condition Script qui définit les conditions devant être remplies pour le mappage.
      Application Le périmètre de l'application pour cet enregistrement.
      Définition Entité ETL sélectionnée à laquelle ce mappage appartient.
      Ignorer Option à indiquer si ce mappage d’entités ETL doit être ignoré lors de l’exécution d’intégrations de données à l’aide de la transformation de jeux d’importation robuste (RTE).
      Mappage d’entités RTE
    7. Cliquez sur Envoyer.

      L’exemple suivant montre un enregistrement créé pour le mappage des enregistrements d’entité ETL utilisateur et utilisateur scim.

      SCIM - Mappages utilisateur
    8. Ouvrez l’enregistrement soumis (scim-user-mappings) et créez un mappage entre les enregistrements de l’entité ETL scim-user et user.
      1. Dans la section Mappages de champs RTE, cliquez sur Nouveau.
      2. Renseignez les champs du formulaire.
        Tableau 3. Champs de l'entité ETL
        Champ Description
        Champ source Le périmètre de l'application pour cet enregistrement.
        Application Entité ETL sélectionnée à laquelle appartient cette définition de champ.
        Champ cible Champ ETL de sortie pour l’opération si l’opération utilise une seule sortie.
        Mappage d'entités Mappage d’entités auquel cette opération s’applique.
        Entité référencée Entité référencée et opération à laquelle elle s’applique.
        Définition Entité ETL sélectionnée à laquelle appartient cette définition de champ.
        Ordre Ordre dans lequel l’opération s’exécute sur l’entité.
        Mappage de champs RTE

        Le champ source Adresse du domicile – Pays (entité ETL scim-user) mappe le champ cible en tant que Pays (entité ETL utilisateur).

      3. Soumettez les entrées en cliquant sur Soumettre.

        Vous pouvez ajouter plusieurs entrées en tant que mappages d’entités RTE en fonction de vos besoins.

        Mappages d’entités RTE

        Les champs sources et les champs cibles sont mappés tels que configurés. Lorsque vous effectuez des opérations CRUD à l’aide de SCIM, les valeurs personnalisées sont mises à jour dans la table respective.

    Résultats

    Ces définitions et mappages ETL vous permettent d’extraire les données d’une table source, de transformer les données selon vos besoins et de charger les données dans une table cible.