ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースへのクライアントアクションの移行

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：3分

    • クライアントアクションを構成して、リストアクションを ITSM エージェントワークスペースから ITSM のサービスオペレーションワークスペースに移行します。

    始める前に

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

    必要なロール：admin

    このタスクについて

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

    手順

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

      このステップは 1 回だけ実行します。

      { 
            "route": "record", 
            "fields": { 
                "table": "{{table}}", 
                "sysId": "-1" 
            }, 
            "params": { 
                "query": "{{query}}", 
                "parentTable": "{{parentTable}}", 
                "parentRecordSysId": "{{parentRecordSysId}}" 
            }, 
            "parent_table": "{{parentTable}}", 
            "additional_data": { 
                "query": "{{query}}" 
            } 
        }
    13. ITEM_SELECTED および PREVIEW_RECORD リストレコード用に作成されたクライアントアクションを変更します。

      クライアントアクションを変更する場合は、ペイロードに基づいて、アクション属性のペイロードマップを変換する必要があります。

      移行プロセスでは、次のテーブルが使用されます。
      • M2M アクションアサインの UX アクション構成 [sys_ux_m2m_action_assignment_action_config]
      • アクションペイロード定義 [sys_declarative_action_payload_definition]
      注:
      ITEM_SELECTED および PREVIEW_RECORD アクションは、ITSM エージェントワークスペースでは機能しますが、SOW では機能しません。そのため、「CREATE_NEW_RECORD」という名前のアクションペイロードが SOW に導入されました。他のアクションペイロードが正しく機能しない可能性がありますが、リストのベースシステムクライアントアクションは、移行後の SOW でも引き続き効果的に機能します。