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

  • リリースバージョン: Australia
  • 更新日 2025年07月31日
  • 所要時間：4分

    • Microsoft Excel のサービスグラフコネクタを使用して、ステージングテーブルにカスタムフィールドを追加し、そのカスタムフィールドを構成アイテム (CI) フィールドにマッピングします。

    始める前に

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

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

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

    手順

    1. ステージング [sg_ot_excel_staging] テーブルにカスタム列を追加します。
    2. [すべて] に移動し、[フィルター] フィールドに sg_ot_excel_staging.list を追加します。
    3. キーボードの Enter キーを押します。
    4. 必要に応じて、[ 新規] を選択してレコードを手動で作成します。
    5. 移動先 すべて > 産業用ワークスペースアドミン > OT マネージャー > OT デバイスのインポート：スクリプトインクルード をクリックし、 SGOTAssetImportExcelConstants スクリプトインクルードを選択します。
    6. スクリプトで、ステージングテーブルの新しい列名と、 SGOTAssetImportExcelConstants.importSetColumnsVsStagingColumnsMap オブジェクト内の新しい ETL 列名を「<ETL 列名>」:「<ステージングテーブルからの列名>」の形式で更新します。

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

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

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

      たとえば、[ コメント] フィールドはハードウェア [cmdb_ci_hardware] クラスにあります。フィールドがマッピングされた後、その行のステージングテーブルの [コメント] 列の値が空でない場合は、ハードウェア子クラスの [ コメント ] フィールドが更新されます。

      存在しない新しいフィールド、またはハードウェア cmdb_ci_hardware クラスに固有ではなく、オペレーショナルテクノロジー (cmdb_ci_ot) クラスのフィールドであるフィールドのマッピングを追加する場合は、オペレーショナルテクノロジー (OT) 1 スタブにフィールドマッピングを追加できます。

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