Créer une définition SCIM ETL

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 5 minutes de lecture

    • Utilisez les définitions SCIM ETL pour mapper les attributs personnalisés aux 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 à donner à l’utilisateur le rôle administrateur, où le rôle scmin_admin peut insérer de nouveaux enregistrements dans les tables qui peuvent contourner la logique métier ou la protection ACL.
    Remarque :
    • Les définitions ETL de groupe SCIM et d’utilisateur SCIM 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 selon vos besoins, ou créer de nouveaux mappages de ressources.
    • Les champs [*] ne sont pas pris en charge via RTE dans le mappage SCIM.

    Procédure

    1. Suivez les instructions de la section Créer des définitions ETL (Extraire/Transformer Charger).
    2. Ouvrez l’enregistrement nouvellement créé et affichez 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 d’utilisateur (sys_user) ou de 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. Remplissez les champs du formulaire.
        Tableau 1. Formulaire d’entité ETL
        Champ Description
        Nom Nom de l’entité ETL.
        Application Le périmètre de l'application pour cet enregistrement.
        Table Table cible pour 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 uniquement un enregistrement avec des valeurs de champ fusionnées uniques en synchronisant les insertions d’enregistrement.
        Exécuter les règles métier Option permettant d’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é RTE.

        Entité ETL
    4. Créez les entités et mappez-les.
      1. Ouvrez l’enregistrement soumis (utilisateur scim et utilisateur).
      2. Dans les champs Entité ETL, ajoutez les champs en cliquant sur Nouveau.
      3. Remplissez les champs du formulaire.
        Tableau 2. Formulaire d’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 lorsque le champ 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 n’a pas pu être trouvé. Les options sont les suivantes :
        • Créer : créez une nouvelle référence ou un nouveau choix. Affectez la référence ou le choix à l’enregistrement actuel.
        • Rejeter : ne pas enregistrer l’enregistrement entier dans la base de données.
        • Ignorer : définir la valeur actuelle comme vide.
        Définition Entité ETL sélectionnée à laquelle appartient cette définition de champ.
        Fusion Option permettant d’interroger les enregistrements existants.
        Champ de l’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 (user), l’extension ou l’extension ServiceNow personnalisée.

        Entités Scim-user

        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é SCIM-user et ETL d’utilisateur, vous devez créer un enregistrement de mappage d’entité RTE. Vous devez ensuite spécifier la définition source et la définition cible pour mapper les deux champs.

    5. Dans la section Mappages d’entités RTE, créez un mappage d’entité 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 permettant de désigner si ce mappage d’entité ETL doit être ignoré lors de l’exécution d’intégrations de données à l’aide de la transformation robuste des ensembles d’importations (RTE).
      Mappage d’entités RTE
    7. Cliquez sur Envoyer.

      L’exemple suivant montre un enregistrement créé pour mapper à la fois les enregistrements d’entité SCIM-user et d’utilisateur.

      scim-mappages d’utilisateurs
    8. Ouvrez l’enregistrement soumis (scim-user-mappings) et créez un mappage entre les enregistrements scim-user et l’entité ETL de l’utilisateur.
      1. Dans la section Mappages de champs RTE, cliquez sur Nouveau.
      2. Remplissez 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 prend 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 comme mappages d’entités RTE en fonction de vos besoins.

        Mappages d’entités RTE

        Les champs sources et cibles sont mappés tels qu’ils sont 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 des données d’une table source, de transformer les données comme vous le souhaitez et de charger les données dans une table cible.