計画立案ツール統合のカスタムフィールドの追加

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • 計画立案ツールの統合にカスタムフィールドを追加して、構成可能性を向上させ、ビジネス固有の情報にアクセスすることで、より多くの情報に基づいた意思決定を容易にします。

    始める前に

    必要なロール: sn_devops.admin

    このタスクについて

    レコードトランスフォーマーを使用して、カスタムフィールドを計画立案ツールの統合に追加できます。ツールアクションごとにレコードトランスフォーマーを作成し、レコードトランスフォーマールールを追加してツールのフィールドを DevOps データモデルのフィールドにマッピングします。たとえば、インポート プロセス中に Azure DevOps 作業アイテム ID が "adoid" として定義されているシナリオを考えてみましょう。ServiceNow 作業アイテム ID に合わせる場合は、インポートアクションのレコードトランスフォーマーを作成することで実現できます。このトランスフォーマー内で、「adoid」フィールドを対応する ServiceNow 作業アイテム ID フィールドにマップするルールを確立する必要があります。フィールドマッピングが作成されると、Azure DevOps から受信イベントを受信して作業アイテムを取り込むたびに、データは構成されたトランスフォーマーを介して変換済みペイロードに処理されます。
    注:
    ServiceNow アジャイル開発 2.0 を除いて、この機能は、ベースシステム計画タイプのツール統合でのみ使用できます。

    手順

    1. 移動先 ワークスペース > DevOps 変更ワークスペース > アドミニストレーション.
    2. [リスト] タブから [統合] > [ツール統合] を選択します。
    3. カスタムフィールドを追加する計画立案ツール統合を選択し、[フィールドマッピングを編集] を選択します。ツール統合レコード
      注:
      アプリケーションスコープが [DevOps 統合 (DevOps Integrations)] として選択されていることを確認します。
    4. [フィールドマッピングを編集] ページで、[計画機能の変換 (Planning capability transformation)] セクションの [レコードトランスフォーマーを作成] ボタンを選択します。
      注:
      ツールアクションごとにレコードトランスフォーマーを作成する必要があります。この手順では、インポートアクションのレコードトランスフォーマーが作成されます。
      1. [新しいレコードトランスフォーマーを作成 (Create New Record Transformer)] ページで、[トランスフォーマーシーケンスを作成] を選択します。新しいレコードトランスフォーマーを作成 (Create New Record Transformer)
      2. [新しいレコードトランスフォーマールールシーケンスを作成 (Create New Record Transformer Rule Sequence)] ページで、ルールシーケンスの名前を [名前] フィールドに入力し、シーケンスのタイプを [タイプ] フィールドで選択します。新しいレコードトランスフォーマールールシーケンスを作成 (Create New Record Transformer Rule Sequence)
      3. [保存] を選択します。
    5. トランスフォーマーレコードページに移動し、[レコードトランスフォーマールール] タブを選択して [新規] を選択します。レコードトランスフォーマーレコードの [レコードトランスフォーマールール] タブ
    6. [新しいレコードトランスフォーマールールを作成 (Create New Record Transformer Rule)] ページで、次のフィールドに入力します。[新しいレコードトランスフォーマールールを作成 (Create New Record Transformer Rule)] ページ
      表 : 1. 新しいレコードトランスフォーマールールを作成 (Create New Record Transformer Rule)
      フィールド 説明
      名前 シーケンス内のルールの名前。
      記号 カスタムフィールド値の抽出先となる、変換済みペイロード内のフィールドの名前。
      パス カスタムフィールド値の取得元のペイロードパス。
      順序 ルールを順番に実行する必要がある順序。
      説明 ルールを説明するテキスト。
      注:
      JSON ペイロードからカスタム列に複数のルールを追加することもでき、さらに多くのフィールドをマップできます。追加されたすべての変換は、変換済みペイロードで考慮されます。
    7. [保存] を選択します。
    8. トランスフォーマーレコードの [詳細] セクションに移動し、次のフィールドに入力します。
      表 : 2. レコードトランスフォーマー
      フィールド 説明
      名前 レコードトランスフォーマーの名前。
      ベースパス 受信ペイロードの読み取り元のパス。
      説明 レコードトランスフォーマーを説明するテキスト。
      レコードのパス 変換されたペイロードの書き込み先のパス。
      レコードトランスフォーマールールのシーケンス このレコードトランスフォーマーに関連付けるルールシーケンス。
      アクティブ レコードトランスフォーマーをアクティブにするオプション。
    9. [保存] を選択します。
    10. [フィールドマッピングを編集] ページに移動し、[マッピングを追加] を選択します。[フィールドマッピングを編集] ページ
      1. ツールアクションのレコードトランスフォーマーを選択します。
      2. レコードのマッピングが処理される順序を [順序] フィールドに設定します。
      3. レコードトランスフォーマーをさまざまなエンティティにマッピングする場合は、記号を選択します。
        注:
        ここでの [記号] フィールドは、ステップ 6 の [新しいレコードトランスフォーマールールを作成 (Create New Record Transformer Rule)] フォームの [記号] フィールドとは異なります。
      4. [保存] を選択します。
      注:
      要件に応じて、アクションに複数のフィールドマッピングを追加できます。