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

  • リリースバージョン: Yokohama
  • 更新日 2025年07月17日
  • 所要時間：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. [保存] をクリックします。
      基本情報が正常に保存されましたバナーが表示されます。
    14. [完了としてマーク] を選択します。
    15. [ETL 変換マップアシスタント] ページの [マッピング用のソースデータの準備] セクションで、[ データのプレビューと準備] を選択します。
      データをプレビューして準備します。
      列が表示されない場合は、手順 11 から 14 を繰り返します。
    16. [完了としてマーク] を選択します。
    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. [保存] をクリックします。
      [コメント] という名前の新しいフィールドが表示されます。
      新しいコメントフィールドが追加されました。
    21. [データ] ペインから、データピルを [コメント ソース列 ] フィールドにドラッグします。
      ハードウェアにマップします。
      ソース列アイコン ( ソース列アイコン) を選択して、そのデータマッピングフィールドを選択することもできます。
      ソース列にはデータピルが含まれます。
      データピルが入力された [ソース列] フィールド。
    22. [ETL 変換マップアシスタント] ページの [データを CMDB にマップし、リレーションシップを追加] セクションの [ ソースデータをマップする CMDB クラス ] に戻ります。
      [ソースデータをマップする CMDB クラス] ページに戻ります。
    23. [完了としてマーク] を選択します。
    24. 新しいフィールドマッピングを確認するには、次の手順に従います。
      1. ETL 変換マップアシスタントのホームページに移動します。
      2. ガイド付きセットアップの [サンプル統合結果のプレビューおよびインポートのスケジュール] セクションで、[ 統合結果のテストとロールバック] を選択します。
        ETL 変換マップアシスタント - テストとロールバックの統合結果。
      3. [ 統合を実行] を選択します。
      4. 実行が正常に終了したら、コメント値を指定した CI の [コメント] フィールドがステージングテーブルで更新されていることを確認します。
      5. [完了としてマーク] を選択します。
        テストとロールバックの統合結果が正常に実行されたら、Excel シートが更新されたことを確認します。
      6. [ ロールバックの実行] を選択します。
        [ロールバックの実行] を選択します。
      7. ETL がアクティブ化されていない場合は、[ アクティブ化] を選択します。
      新しい列フィールドマッピングが正常に追加され、検証されました。