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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月07日
  • 読む5読むのに数分

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

    始める前に

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

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

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

    手順

    1. ステージングテーブルにカスタム列が作成されたら、次に移動します。 すべて > Industrial Workspace 管理者 > OT マネージャー > OT デバイスのインポート:ステージングテーブル.
    2. Excel テンプレートをダウンロードします。
      詳細については、「 Excel テンプレートのダウンロード」を参照してください。

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

    3. Excel テンプレートを準備します。
      詳細については、「 Service Graph Connector インポート用のインポート前 OT ワークシートエントリーレビューツールの準備」を参照してください。
    4. Excel テンプレートをインポートします。
      詳細については、「 Excel テンプレートのインポート」を参照してください。
    5. 移動先 すべて > Industrial Workspace 管理者 > 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. 移動先 すべて > 構成 > IntegrationHub ETL.
    9. CMDB アプリケーション:SG-OT Excel インポート ETL を選択します。
    10. [無効なマッピング データが検出されました] ページが表示された場合は、[ 閉じる] を選択します。
    11. ETL 変換マップアシスタントのガイド付き設定の [基本的な詳細を指定] セクションで、[ ソースデータをインポート] を選択し、[基本的な詳細を入力] を選択します。
      [ステップ 1: ETL 変換マップの基本情報を指定する (step 1: Provide basic information for the ETL Transform Map)] を選択します。
    12. [ サンプルインポートセット ] フィールドで、[ 新しいインポートセットを自動プル] を選択します。
      サンプルインポートセットフィールドで、[Auto-pull a new import set] を選択します。
    13. [Save (保存)] を選択します。
      [基本情報が正常に保存されました (Basic information saved successfully)] バナーが表示されます。
    14. [完了としてマーク] を選択します。
    15. [ETL 変換マップアシスタント] ページの [マッピング用のソースデータの準備] セクションで、[ データのプレビューと準備] を選択します。
      データをプレビューして準備します。
      列が表示されない場合は、手順 11 〜 14 を繰り返します。
    16. [完了としてマーク] を選択します。
    17. [ETL 変換マップアシスタント] ページの [データを CMDB にマップし、関係性を追加] セクションで、[ ソースデータをマップする CMDB クラス] を選択します。
    18. 列をターゲットクラスと属性にマップします。

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

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