ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースへの UI コンポーネントの移行

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

    • UI コンポーネントを構成して、リストアクションを ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペース (SOW) に移行します。

    始める前に

    移行を実行するときは、ITSM エージェントワークスペース機能の [リストアクション] オプションを選択しておく必要があります。たとえば、リストの [リストアクション] オプションなどです。移行プロセスの詳細については、「ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースへの移行」を参照してください。

    必要なロール：admin

    このタスクについて

    移行プロセスの最後に、確認メッセージにより移行が成功したかどうかが示されます。移行情報を確認し、移行後の手順を実行して、構成またはカスタマイズの移行が成功したことを確認できます。

    手順

    1. [すべて] > [Now Experience フレームワーク] > [宣言アクション] > [リストアクション]に移動します。
    2. [実装方法] が [UI コンポーネント] として設定されていることに基づいてレコードをフィルタリングします。
    3. 移行プロセスで失敗したレコードのログを表示し、[リストアクション] リストからレコードの sys_Id を見つけます。
    4. 対応する sys_id を持つ失敗したレコードを選択します。
    5. ヘッダーを選択して長押し (または右クリック) し、[挿入と維持] を選択します。
    6. [ワークスペース] フィールドと [ビュー] フィールドをクリアします。
    7. [制限されたエクスペリエンス] チェックボックスをオンにします。
    8. [実装方法] フィールドの値を [UXF クライアントアクション] として更新します。
    9. [アクション構成] 関連リストで、[編集] を選択し、 [コレクション] リストから [アクション構成] リストに [SOW アクション (SOW Actions)] を選択します。
    10. [保存] を選択して [アクション構成] リストを保存します。
      注:

      複数レコードアソシエーター (MRA) またはインターセプターをリストに追加することは、有効なシナリオではありません。MRA またはインターセプターを含むカスタマイズを移行する場合は、ベースシステムレコードのアドオンイベントマッピングを確認する必要があります。ベースシステムでは、リスト宣言アクションのアドオンイベントマッピングは指定されていません。

    11. [更新] を選択します。

      移行ユーティリティは、UI コンポーネントタイプの MRA およびインターセプターの宣言アクションのみをサポートします。

    12. MRA の場合は、コードブロックに記載されたとおりにアクションペイロードを作成し、アクション属性の値を ITSM エージェントワークスペース宣言アクションのコンポーネント属性で更新します。

      ITSM エージェントワークスペース宣言アクションレコードに値が入力されていない場合は、値に {{ key }} を入力します。たとえば、コンポーネント属性テーブルが空の場合、ペイロードの値は {{table}} にする必要があります。

      { 
"label": "label", 
                "extensionPoint": "extensionPoint", 
                "userGivenTable": "userGivenTable", 
                "hideSelectAll": "hideSelectAll", 
                "parentRecordSysId": "parentRecordSysId", 
                "table": "table", 
                "referencedFieldName": "referencedFieldName", 
                "type": "type", 
                "parentFieldName": "parentFieldName", 
                "columns": "columns", 
                "view": "view", 
                "relatedListName": "relatedListName" 
        }
    13. インターセプターの場合は、アクションペイロード定義 [sys_declarative_action_payload_definition] テーブルのコードブロックに記載されたとおりにアクションペイロードを作成します。 
      { 
    "table": "target", 
                "sysId": "-1", 
                "parentTable": "{{parentTable}}", 
                "parentSysId": "{{parentRecordSysId}}", 
                "referencedFieldName": "", 
                "pageTitle": "Create " + tableLabel, 
                "pageSubTitle": "Choose one of the following " + tableLabel + " types", 
                "useDomain": false 
}
    14. 移行された宣言アクションにアドオンイベントマッピングを追加します。

      SOW で一致する宣言アクションを検索し、すべてのアドオンイベントマッピングを移行された宣言アクションに追加します。次の手順を使用して、SOW で対応する宣言アクションを検索します。

      1. [すべて] > [sys_ux_addon_event_mapping.list]に移動します。
      2. テーブルをフィルタリングし、移行された tablename と mra または interceptor route を含む [ターゲットペイロードマッピング] を使用します。
      3. レコードが見つかった場合は、宣言アクション sys_id を返します。

        フィルタリングされた宣言アクションのすべてのアドオンイベントマッピングを反復処理し、移行された宣言アクションに追加します。

      4. テーブルでレコードが見つからない場合は、テーブルフィルターを削除し、「targetPayload contains route=mra or interceptor」を検索します。
        [リスト] および [フィールド] デコレーターの場合は、MRA とインターセプターのアドオンイベントマッピングを手動で追加する必要があります。詳細については、「Create a UX add-on event mapping」を参照してください。
      注:

      ITSM エージェントワークスペースの変更要求 [change_request] インターセプターレコードは SOW に存在します。

      宣言アクションのインターセプタータイプのワークスペースのスペースレコードタイプセレクターを移行する場合：
      • ITSM エージェントワークスペーステーブル：ワークスペースレコードタイプセレクター [aw_record_type_selector]
      • SOW テーブル：レコードタイプセレクター [sn_sow_interceptor_record_type_selector]

      値が標準の変更要求 [change_request] テーブルの場合、ITSM エージェントワークスペースから SOW へのレコードの移行時に [アクティブ] は False に設定されます。