のステージングテーブルにカスタムフィールドマッピングを追加する サービスグラフ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • ステージングテーブルにカスタムフィールドを追加し、Excel SGC を介してステージングテーブルのカスタムフィールドを CI フィールドにマッピングします。

    始める前に

    フォームレイアウトを構成するには、「 フォームレイアウトの構成」を参照してください。

    ステージングテーブルにカスタムフィールドを作成するには、「 テーブルのフィールドを追加およびカスタマイズする」を参照してください。

    必要なロール：
    • アドミン:スクリプトインクルードの変更、クラスまたはフィールドマッピングの追加、ETL の変更を行うことができます。
    • cmdb_inst_admin:新しいクラスまたはフィールドマッピングの追加と ETL の変更のみを行うことができます。

    手順

    1. ステージングテーブルにカスタム列が作成されたら、 All (すべて) > 産業用ワークスペースアドミン > OT Manager (OT マネージャー) > OT デバイスのインポート:ステージングテーブル.
    2. Excel テンプレートをダウンロードします。
      詳細については、「 Excel テンプレートのダウンロード」を参照してください。

      ステージングテーブルにレコードが存在する場合は、既存のレコードの列の値を編集できます。

    3. Excel テンプレートを準備します。
      詳細については、「 サービスグラフコネクタをインポートするためのインポート前 OT ワークシートエントリレビューツールの準備」を参照してください。
    4. Excel テンプレートをインポートします。
      詳細については、「 Excel テンプレートのインポート」を参照してください。
    5. 次のように移動する。 All (すべて) > 産業用ワークスペースアドミン > OT Manager (OT マネージャー) > OT デバイスのインポート：スクリプトインクルード をクリックし、 SGOTAssetImportExcelConstants スクリプトインクルードを選択します。
    6. スクリプトで、ステージングテーブルの新しい列名を更新し、 SGOTAssetImportExcelConstants.importSetColumnsVsStagingColumnsMap オブジェクト内の新しい ETL 列名を「<ETL 列名>」: 「<ステージングテーブルの列名>」の形式で更新します。

      この例では、コロン (:) の前の「u_my_custom_field」は ETL 列名 (ETL プレビューステップでは列として表示) を示し、コロンの後の「u_my_custom_field」はステージングテーブルの列名を示します。

      新しい行の上の行の最後にカンマ (,) が追加されていることを確認してください。この例では、"custom_fields": "custom_fields" 行の後にコンマが追加されています。

      SGOTAssetImportExcelConstants で ETL 列名を更新しました。
    7. [更新] を選択して、変更を保存します。
    8. 次のように移動する。 All (すべて) > 構成 > IntegrationHub ETL.
    9. CMDB アプリケーション:SG-OT Excel インポート ETL を選択します。
    10. [無効なマッピングデータが検出されました] ページが表示された場合は、[ 閉じる] を選択します。
    11. ETL 変換マップアシスタントのガイド付きセットアップの [基本的な詳細を指定] セクションで、[ ソースデータをインポートして基本的な詳細を入力] を選択します。
      [ステップ 1:ETL 変換マップの基本情報を入力する] を選択します。
    12. [ サンプルインポートセット ] フィールドで、[ 新しいインポートセットを自動プル] を選択します。
      [サンプルインポートセット] フィールドで、[新しいインポートセットを自動プル] を選択します。
    13. [Save (保存)] をクリックする。
      [基本情報が正常に保存されました] バナーが表示されます。
    14. [Mark as Complete (完了としてマーク)] を選択します。
    15. [ETL 変換マップアシスタント] ページの [マッピング用のソースデータの準備] セクションで、[ データのプレビューと準備] を選択します。
      データをプレビューして準備します。
      列が表示されない場合は、手順 11 〜 14 を繰り返します。
    16. [Mark as Complete (完了としてマーク)] を選択します。
    17. [ETL 変換マップアシスタント] ページの [データを CMDB にマップし、関係性を追加] セクションで、[ ソースデータをマップする CMDB クラス] を選択します。
    18. 列をターゲットクラスと属性にマッピングします。

      たとえば、「コメント」フィールドは Hardware cmdb_ci_hardware クラスにあります。このフィールドがマップされた後、その行のステージングテーブルの「コメント」列の値が空でない限り、ハードウェアの子クラスの「コメント」フィールドも更新されます。存在しない新しいフィールド、またはハードウェア cmdb_ci_hardware クラス固有ではなく、オペレーショナルテクノロジー (cmdb_ci_ot) クラスのフィールドであるフィールドのマッピングを追加する場合は、オペレーショナルテクノロジー (OT) 1 スタブにフィールドマッピングを追加します。

      1. ハードウェア 1 クラスにフィールドマッピングを追加します。
      2. ハードウェア 1 クラスの場合は、[ マッピングの編集] を選択します。
        ソースデータをマップする CMDB クラスを選択
    19. 表示される [属性を追加] ダイアログボックスで、[ 属性 ] リストから [コメント] を選択します。
      [ハードウェア 1 クラスのマッピング - 属性の追加] ダイアログボックス
    20. [Save (保存)] をクリックする。
      [コメント] という名前の新しいフィールドが表示されます。フィールドを表示するためにスクロールする必要がある場合があります。
      新しいコメントフィールドが追加されました。
    21. [データ] ペインから、データピルを [コメント ソース列 ] フィールドにドラッグします。
      ハードウェアにマッピングします。
      ソース列アイコン ( ソース列アイコン ) を選択して、そのデータマッピングフィールドを選択することもできます。
      [ソース列] にはデータピルが含まれます。
      データピルが入力された [ソース列] フィールド。
    22. [ETL 変換マップアシスタント] ページの [CMDB にデータをマッピングし、関係性を追加] セクションの [CMDB クラスにソースデータをマッピング する] に戻ります。
      [ソースデータをマップする CMDB クラス] ページに戻ります。
    23. [Mark as Complete (完了としてマーク)] を選択します。
    24. 次の手順に従って、新しいフィールドマッピングを確認します。
      1. ETL 変換マップアシスタントのホームページに移動します。
      2. ガイド付きセットアップの [サンプル統合結果のプレビューとインポートのスケジュール] セクションで、[ テストとロールバックの統合結果] を選択します。
        ETL 変換マップアシスタント - テストとロールバックの統合結果。
      3. [ 統合を実行] を選択します。
      4. 実行が正常に完了したら、コメント値を指定した CI の [コメント] フィールドがステージングテーブルで更新されていることを確認します。
      5. [Mark as Complete (完了としてマーク)] を選択します。
        テストとロールバックの統合結果が正常に実行されたら、Excel シートが更新されていることを確認します。
      6. [ ロールバックの実行] を選択します。
        [ロールバックの実行] を選択します。
      7. ETL がアクティブ化されていない場合は、[ アクティブ化] を選択します。
      新しい列フィールドマッピングが正常に追加され、検証されました。