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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

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

    始める前に

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

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

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

    手順

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

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

    3. Excel テンプレートを準備します。
      詳細については、「 サービスグラフコネクタインポート用のインポート前 OT ワークシートエントリーレビューツールの準備」を参照してください。
    4. Excel テンプレートをインポートします。
      詳細については、「 Excel テンプレートのインポート」を参照してください。
    5. 移動先 すべて > 産業用ワークスペースアドミン > OT Manager (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 変換マップの基本情報を指定する (Step 1: Provide basic information for the ETL transform map)] を選択します。
    12. [ サンプルインポートセット ] フィールドで、[ 新しいインポートセットを自動プル] を選択します。
      サンプルのインポートセットフィールドで、[Auto-pull a new import set] を選択します。
    13. [保存] を選択します。
      「基本情報が正常に保存されました」というバナーが表示されます。
    14. [Mark as Complete (完了としてマーク)] を選択します。
    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. フィールドマッピングを Hardware 1 クラスに追加します。
      2. [Hardware 1] クラスで [ Edit Mapping] を選択します。
        ソースデータをマップする CMDB クラスを選択
    19. 表示される [属性の追加] ダイアログ ボックスで、[ 属性] リストから [コメント] を選択します。
      [Map Hardware 1 クラス - 属性を追加]ダイアログ ボックス
    20. [保存] を選択します。
      「コメント」という名前の新しいフィールドが表示されます。スクロールしないとフィールドが表示されない場合があります。
      新しいコメント フィールドが追加されました。
    21. [データ] ペインから、データピルを [コメント ソース列] フィールドにドラッグします。
      ハードウェアにマッピングします。
      ソース列アイコン ( ソース列アイコン ) を選択して、そのデータマッピングフィールドを選択することもできます。
      [ソース] 列にはデータピルが含まれています。
      データピルが入力された [ソース列] フィールド。
    22. [ETL 変換マップアシスタント] ページの [データを CMDB にマップし、関係性を追加する (Map Data to CMDB and Add Relationships)] セクションの [ ソースデータをマップする CMDB クラス (CMDB Classes to Map Source Data )] に移動します。
      [ソースデータをマップする CMDB クラス] ページに戻ります。
    23. [Mark as Complete (完了としてマーク)] を選択します。
    24. 次の手順に従って、新しいフィールドマッピングを確認します。
      1. ETL 変換マップアシスタントのホームページに移動します。
      2. ガイド付きセットアップの [サンプル統合結果のプレビューとインポートのスケジュール] セクションで、[ テストとロールバックの統合結果] を選択します。
        ETL 変換マップアシスタント - 統合結果のテストとロールバック
      3. [ Run Integration (統合の実行)] を選択します。
      4. 実行が正常に終了したら、コメント値を指定した CI の [コメント] フィールドがステージングテーブルで更新されていることを確認します。
      5. [Mark as Complete (完了としてマーク)] を選択します。
        テストとロールバックの統合結果が正常に実行されたら、Excel シートが更新されていることを確認します。
      6. [ ロールバックの実行] を選択します。
        [ロールバックの実行] を選択します。
      7. ETL がアクティブ化されていない場合は、 [アクティブ化] を選択します。
      新しい列フィールドマッピングが正常に追加され、検証されました。