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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:3分
  • 計画立案ツールの統合にカスタムフィールドを追加して、構成可能性を向上させ、ビジネス固有の情報にアクセスすることで、より多くの情報に基づいた意思決定を容易にします。

    始める前に

    必要なロール:sn_devops.admin

    このタスクについて

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

    手順

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