変換マップ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • 変換マップは、インポートセットのフィールドと、インシデント [incident] やユーザー [sys_user] などの既存の ServiceNow テーブルのフィールドとの関係を決定するフィールドマップのセットです。

    図 : 1. インポートプロセス変換
    インポートプロセス変換

    変換マップを作成したら、それを再利用して、別のインポートセットのデータを同じテーブルにマッピングできます。

    アドミニストレーターは、[変換マップ] モジュールを使用して、任意のテーブルにインポートされたデータの格納先を定義できます。変換マッピングは、インポートセットテーブルのソースフィールドと任意のテーブルの宛先フィールド間のリンクを指定するドラッグアンドドロップ操作と同じくらい簡単です。変換マッピングを使用して、ソースフィールドと宛先フィールドを動的にマッピングします。

    変換の考慮事項

    自動マッピング
    システムが自動的にマッピングするフィールドが実際に必要であることを再確認します。たとえば、暗号化されたパスワードはマッピングしないでください。
    参照フィールドのマッピング
    参照フィールドデータをマッピングするときに sys_id が存在しない場合、sys_id が DisplayValue としてターゲットレコードに表示される可能性があり、これは望ましくない可能性があります。
    多数の参照フィールドをマッピングすると、フィールドレベルで選択アクションを実行する前に参照先の sys_id が実際に存在するかどうかがチェックされるため、追加のパフォーマンスオーバーヘッドが発生します。
    注:
    onBefore などの変換スクリプトを使用すると、パフォーマンスのオーバーヘッドをバイパスできます (参照フィールドのインポートを検証する要件がないことが前提)。たとえば、target.<field_name> = source.<field_name> です。

    複数の変換マップを使用する

    単一のデータソースに複数の変換マップを適用できます。

    変換マップごとに 1 つのインポートセット行が作成されるため、大量の一時レコードが生成される可能性があります。
    注:
    同じインポートセットに対して複数の変換マップを使用すると、変換によってインポートセットテーブルに複数のエントリが作成されます。

    単一のインポートセットから複数の変換を実行する

    ユーザーは、データのインポート中に複数の変換マップを選択できます。

    選択した変換マップは、指定された順序で同じインポートセットで実行されます。

    図 : 2. マルチマップ変換
    マルチマップ変換

    変換マップスクリプト

    変換マップスクリプトを使用すると、強力なプログラミングインターフェイスを使用してインポート操作をカスタマイズし、高度なロジックを導入できます。

    変換マップスクリプトは、インポートセットが ServiceNow テーブルに変換されるときにイベントとして実行されます。変換マップのスクリプティングは ServiceNow スクリプティング環境に完全に統合されています。変換マップスクリプトには次の 2 つのタイプがあります。
    • マッピング関係を明示的に定義する明示的な変換マップスクリプト
    • 変換のさまざまなステージでイベントの処理を変更する変換イベントスクリプト