SCIM ETL 定義の作成

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む6読むのに数分
  • SCIM ETL 定義を使用して、カスタム属性を sys_user または sys_user_group テーブルにマッピングします。

    始める前に

    必要なロール:scim_admin

    警告:
    このロールは慎重に付与してください。scim_adminロールは、ユーザーに admin ロールを付与することと同じです。ここで、scmin_adminロールは、ビジネスロジックまたは ACL 保護をバイパスできるテーブルに新しいレコードを挿入できます。
    注:
    • SCIM グループと SCIM ユーザー ETL 定義は、リソースマッピングのベースシステムの一部です。同じリソースマッピングを使用して、必要に応じて基準を変更することも、新しいリソースマッピングを作成することもできます。
    • SCIM マッピングでは、RTE を介した [*] フィールドはサポートされていません。

    手順

    1. 抽出変換ロード (ETL) 定義を作成する」の指示に従います。
    2. 新しく作成されたレコードを開いて詳細を表示します。
    3. [ETL エンティティ] セクションで、[新規] をクリックしてエンティティを作成します。
      エンティティを作成する必要があるユーザーは次のとおりです。
      • scim-user:SCIM のフィールド用。
      • ユーザー (sys_user) またはグループ (sys_user_group) テーブル:SCIM を使用してデータベーステーブルからマッピングするフィールド用。たとえば、SCIM を使用してユーザーの詳細をカスタマイズするには、sys_user テーブルを使用します。
      1. フォームのフィールドに入力します。
        表 : 1. [ETL エンティティ] フォーム
        フィールド 説明
        名前 ETL エンティティの名前。
        アプリケーション このレコードのアプリケーションスコープ。
        テーブル ETL エンティティのターゲットテーブル。
        定義 選択された ETL エンティティ。
        パス このエンティティの一意のパス。インポートセットテーブルを表すエンティティのパスを指定しないでください。エンティティがコレクションを表す場合、パスはアスタリスク (*) で終わる必要があります。この要件は、中間エントリとターゲットテーブルエンティティに適用されます。
        挿入を同期する レコード挿入を同期することで一意の結合フィールド値のある 1 つのレコードのみを保証するオプション。
        ビジネスルールを実行 ビジネスルールを実行するオプション。
      2. [送信] をクリックします。

        scim-user および user テーブルに対して ETL エンティティが作成されます。この ETL エンティティ内に ETL エンティティフィールドを作成し、RTE エンティティマッピングを作成して両方のエンティティをマッピングする必要があります。

        ETL エンティティ
    4. エンティティを作成してマッピングします。
      1. 送信されたレコード (scim-user と user) を開きます。
      2. [ETL エンティティ] の各フィールドで、[新規] をクリックしてフィールドを追加します。
      3. フォームのフィールドに入力します。
        表 : 2. [ETL エンティティ] フォーム
        フィールド 説明
        名前 [ETL エンティティ] フィールド定義の名前。
        アプリケーション このフィールド定義が属する選択された ETL エンティティ。
        フィールド/パス このフィールドは列またはパスです。
        • エンティティがインポートテーブルまたはターゲットテーブルの場合、フィールドは列名です。
        • フィールドにネストされた構造がある場合、フィールドはパスです。
        エンティティ この操作が適用されるエンティティ。検索アイコンを使用してエンティティを選択します。
        強制アクション 参照または選択肢が見つからない場合にシステムで行われる必要がある操作です。オプションは次のとおりです。
        • 作成:新しい参照か選択肢を作成します。現在のレコードに参照または選択肢を割り当てます。
        • 却下:レコード全体をデータベースに保存しません。
        • 無視:現在の値を空に設定します。
        定義 このフィールド定義が属する選択された ETL エンティティ。
        結合 既存のレコードをクエリするオプション。
        [ETL エンティティ] フィールド
      4. [送信] をクリックしてエントリを送信します。

        要件に基づいて、複数のエントリを [ETL エンティティ] フィールドとして追加できます。

        scim-user の ETL エンティティには、コア拡張 (user)、ServiceNow 拡張、またはカスタム拡張を持つエンティティを含めることができます。

        scim-user エンティティ

        user の ETL エンティティには、データベーステーブルのエンティティを含めることができます。たとえば sys_user テーブルなどです。

        user エンティティ
        注:
        受信する SCIM のフィールドにフィルターを追加するには、アンダースコア (_) を使用します。このアンダースコアは EQ フィルターに変換されます。たとえば、属性 email.type_work.value はメールの SCIM フィルター [type eq “work”].value を適用します。

        scim-user と user の [ETL エンティティ] レコードの両方でフィールドを作成したら、RTE エンティティのマッピングレコードを作成する必要があります。その後、ソースとターゲットの定義を指定して、両方のフィールドをマッピングする必要があります。

    5. [RTE エンティティマッピング] セクションで、[新規] をクリックしてエンティティマッピングを作成します。
    6. フォームの各フィールドに入力します。
      フィールド 説明
      名前 マッピングの名前。
      ソースエンティティ マッピングのソースエンティティ。
      ターゲットエンティティ マッピングのターゲットエンティティ。
      順番 マッピングを処理する順序。
      条件つき マッピングを条件付きとして指定するオプション。
      条件スクリプト マッピングのために満たす必要のある条件を定義するスクリプト。
      アプリケーション このレコードのアプリケーションスコープ
      定義 このマッピングが属する選択された ETL エンティティ。
      無視 強力なインポートセット変換 (RTE) を使用してデータを統合するときに、この ETL エンティティマッピングを無視するかどうかを指定するオプション。
      RTE エンティティマッピング
    7. [送信] をクリックします。

      次の例は、[ETL エンティティ] の scim-user と user の両レコードをマッピングするために作成されたレコードを示しています。

      scim-user-mappings
    8. 送信済みのレコード (scim-user-mappings) を開き、[ETL エンティティ] の scim-user と user のレコード間のマッピングを作成します。
      1. [RTE フィールドマッピング] セクションで、[新規] をクリックします。
      2. フォームのフィールドに入力します。
        表 : 3. ETL エンティティフィールド
        フィールド 説明
        ソースフィールド このレコードのアプリケーションスコープ。
        アプリケーション このフィールド定義が属する選択された ETL エンティティ。
        ターゲットフィールド 操作が単一の出力を受け取る場合は、操作の ETL フィールドを出力します。
        エンティティマッピング この操作が適用されるエンティティマッピング。
        参照エンティティ 参照されるエンティティとそれが適用される操作。
        定義 このフィールド定義が属する選択された ETL エンティティ。
        順番 エンティティで実行される操作の順序。
        RTE フィールドマッピング

        ソースフィールドの [自宅住所 - 国] (scim-user の ETL エンティティ) は、ターゲットフィールドを [国] (user の ETL エンティティ) としてマッピングします。

      3. [送信] をクリックしてエントリを送信します。

        要件に基づいて、複数のエントリを RTE エンティティマッピングとして追加できます。

        RTE エンティティマッピング

        ソースフィールドとターゲットフィールドが設定どおりにマッピングされています。SCIM を使用して CRUD 操作を実行すると、カスタマイズした値がそれぞれのテーブルで更新されます。

    タスクの結果

    このように ETL の定義とマッピングを設定することで、ソーステーブルからデータを抽出し、必要に応じてデータを変換して、データをターゲットテーブルにロードすることが可能になります。