ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースへの新規レコードメニューアイテムの移行

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

    • ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースへの新規レコードメニューアイテムの移行には、必要なテーブルの識別、移行対象の新規レコードメニューアイテムの識別、および移行プロセスが含まれます。

    システムプロパティ

    sys_property: sn_sow_migration.itsm_aw_migration_tables

    これらのテーブルのみに対応するレコードは、ITSM エージェントワークスペースからサービスオペレーションワークスペースに移行されます。

    移行に使用されるテーブル

    新規レコードメニューアイテム [sys_aw_new_menu_item]：ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースに移行するアクティブなレコードが含まれています。

    移行ユーティリティで移行対象の新規レコードメニューアイテムを識別する方法

    サービスオペレーションワークスペース移行ユーティリティは、移行する新規レコードメニューアイテムを以下の情報に基づいて識別します。
    • 新規レコードメニューアイテム [sys_aw_new_menu_item] テーブルで指定された ITSM エージェントワークスペーステーブルのアクティブなレコード。
    • サービスオペレーションワークスペースの新規レコードメニューアイテム構成に既に挙げられているテーブルのレコードは、重複を避けるために移行されません。

    新しいレコードメニューアイテム [sys_aw_new_menu_item] テーブルに重複するアクティブなレコードが指定されている場合は、アクティブなレコードのコピーのみが移行されます。

    移行の仕組み

    サービスオペレーションワークスペース移行ユーティリティは、次の順序で新規レコードメニューアイテムを ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースに移行します。これらのアクションはすべてユーティリティによって実行されます。

    1. サービスオペレーションワークスペースの現在の新規レコードメニューアイテム構成を検索します。

      以下について UX ページプロパティ [sys_ux_page_property] テーブルのクエリを実行します。

      • サービスオペレーションワークスペースページ (aa881cad73c4301045216238edf6a716 はサービスオペレーションワークスペースページレコードの sysId)。
      • chrome_tab (サービスオペレーションワークスペースの新規レコードメニューアイテムを保存する UX ページプロパティレコードの名前)
    2. ステップ 1 で取得したレコードを使用して、サービスオペレーションワークスペースの新規レコードメニューアイテムに既に含まれているテーブルを検索します。
    3. 重複を避けるために、移行中は既存のテーブルを無視します。
    4. フィールド値が以下のように設定されている新規レコードメニューアイテム [sys_aw_new_menu_item] テーブルのレコードを検索します。
      • active が true
      • workspace が Agent Workspace
      • table が sn_sow_migration.itsm_aw_migration_tables のいずれか

      レコードごとに、テーブル名が既存のテーブルの一部ではなく同じテーブル名が以前に処理されていない場合は、移行ユーティリティによって JSON オブジェクトが作成されます。

    5. 次のように、各レコードに対応するデータを含む JSON オブジェクトを作成します。
      { 
                    "label": { 
                        "translatable": true, 
                        "message": "New " + tableLabel 
                    }, 
                    "routeInfo": { 
                        "route": "record", 
                        "fields": { 
                            "table": table, 
                            "sysId": "-1" 
                        }, 
                        "multiInstField": "sysId" 
                    }, 
                    "condition": { 
                        "tableDescription": { 
                            "table": table, 
                            "canCreate": true 
                        } 
                    } 
};
    6. 新規レコードメニューの既存の chrome_tab JSON 値にコードを追加します。