Créer une définition SCIM ETL

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 5 minutes de lecture

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

    Avant de commencer

    Rôle requis : scim_config_admin

    Avertissement :
    Accordez ce rôle avec soin. Le rôle scim_config_admin équivaut à donner à l’utilisateur le rôle administrateur, où le rôle scim_config_admin peut insérer de nouveaux enregistrements dans les tables qui peuvent contourner la logique métier ou la protection des 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 [*] via RTE ne sont pas pris en charge dans le mappage SCIM.

    Procédure

    1. Suivez les instructions dans les définitions de création d’extraction et de chargement (ETL).
    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 de l’utilisateur (sys_user) ou du 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 la personnalisation des détails de l’utilisateur via SCIM, vous pouvez utiliser la table sys_user.
      1. Remplissez les champs du formulaire.
        Tableau 1. Formulaire de l’entité ETL
        Champ Description
        Nom Nom de l’entité ETL.
        Application 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 de l’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.
        • 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 n’a pas pu être trouvé. 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 : ne pas enregistrer l’enregistrement entier dans la base de données.
        • Ignorer : définir 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 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 (utilisateur), l’extension ou l’extension ServiceNow personnalisée.

        Entités d’utilisateurs 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 la messagerie [type eq “work”].value.

        Une fois les champs créés dans les enregistrements d’entité scim-user et d’utilisateur ETL, vous devez créer un enregistrement de mappage d’entité RTE. Vous devez ensuite spécifier la définition de la source et de la 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 à remplir pour le mappage.
      Application 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 de données à importer (RTE).
      Mappage d’entités RTE
    7. Cliquez sur Envoyer.

      L’exemple suivant montre un enregistrement créé pour mapper à la fois les enregistrements scim-user et user ETL Entity.

      scim-mappages d’utilisateurs
    8. Ouvrez l’enregistrement soumis (scim-user-mappings) et créez un mappage entre les enregistrements scim-user et l’utilisateur de l’entité ETL.
      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 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 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 comme 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 mappages et définitions ETL vous permettent d’extraire les données d’une table source, de transformer les données comme vous le souhaitez et de les charger dans une table cible.