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

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

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

    始める前に

    必要なロール：admin

    手順

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

        見つかった DA のすべてのアドオンイベントマッピングを反復処理し、移行された DA に追加します。

      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 に設定されます。