ITSM モバイルエージェント 5.0.3 への移行

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

    • ITSM モバイルエージェント 5.0.3 に移行すると、ネクストエクスペリエンス テーマとアクセシビリティコンプライアンスが ITSM モバイルエージェント で有効になります。

    この移行には次のコンポーネントの変更が含まれます。
    • 従来のアイコンセクションから新しいアイコンセクションへの移行。オンコールスケジューリングとインシデントのアイコンセクションが、アイコンの色変数を伴ってより適切にグループ化されます。
    • 従来の UI パラメーターから新しい入力フォーム画面への移行。パラメーターの定義方法を簡素化し、入力フォーム画面でテーマを設定できるようにし、モバイルプラットフォーム によるアクセシビリティ拡張をサポートします。
    • 従来のカードビューからモバイルビューへの移行。テーマごとに色変数を使用できます。
    • すべてのスタイル変更は、UI スタイルではなく UI ルールを使用して行うことができます。
    • ポジティブアクションを実行するボタンの強調表示が、プライマリからポジティブに変更されました。
    顧客が古いバージョンから ITSM モバイルエージェント 5.0.3 に移行すると、次の手順が自動的に実行されます。
    • ITSM モバイルエージェント (sn_itsm_mobile_agt) アプリケーションに対して plugin.upgraded イベントがトリガーされると、Run clean upgrade for ITSM Mobile Agent スクリプトアクションが実行されます。
    • このスクリプトアクションは、次のアップグレード API を呼び出します。
      • 従来のアイコンセクションから新しいナビゲーションセクションへの移行には、sn_itsm_mobile_agt.MobileUtahUpgradeEngine スクリプトインクルードの cleanUpgradeIconSections() メソッド。
      • 古い UI パラメーターから新しい入力フォーム画面への移行には、sn_itsm_mobile_agt.MobileUtahUpgradeEngine スクリプトインクルードの cleanUpgradeBoxInstance() メソッド。
      • 従来のカードから新しいモバイルビューへの移行には、sn_itsm_mobile_agt.MobileUtahUpgradeEngine スクリプトインクルードの cleanUpgradeIconSections() メソッド。
      • キーと値のペアを持つマップ、sn_itsm_mobile_agt.MobileIconSectionMigrationConstant が導入されます。キーは従来のデフォルト構成の sys_id であり、値はアップグレードプロセスで導入された対応する新しいデフォルト構成のメタデータのカンマ区切りリストを持つオブジェクトです。
    • スクリプトアクションが実行されて必要なすべてのアクションが実行されると、今後のアップグレードで再度実行されないように非アクティブ化されます。

    従来のアイコンセクションからナビゲーションセクションへの移行

    この場合、sn_itsm_mobile_agt.MobileIconSectionMigrationConstants スクリプトインクルードには次のキーと値のペアが含まれます。
    • キー：従来のデフォルト sys_sg_icon_section レコードの sys_id。
    • 値：sys_sg_navigation_section および sys_sg_applet_launcher_m2m_section レコードの sys_id のカンマ区切りリストを持つオブジェクト。
    [ITSM モバイルエージェントのクリーンアップグレードを実行 (Run clean upgrade for ITSM Mobile Agent)] スクリプトアクションのアップグレードスクリプトが実行され、マップ内の各キーに対して次の手順が実行されます。
    1. 次のレコードのカスタマイズを確認してください。
      • 従来のデフォルト sys_sg_icon_section レコード。
      • 新しいデフォルトアイコンセクションと比較して、従来のデフォルトアイコンセクションに新しい sys_sg_applet_launcher_m2m_section レコードが少なくとも 1 つあるか、またはレコードが 1 つ少ないかを比較します。
    2. カスタマイズに基づいて、次のいずれかの手順が実行されます。
      • 上記のレコードのいずれかがカスタマイズされている場合、スクリプトは新しいデフォルト sys_sg_navigation_section レコードを非アクティブにします。
      • 上記のレコードのどれもカスタマイズされていない場合、スクリプトは従来のデフォルト sys_sg_icon_section レコードを非アクティブにします。
    注:
    • デフォルトで利用できないカスタムアイコンセクションは引き続き機能しますが、ネクストエクスペリエンス テーマとアクセシビリティコンプライアンスをサポートしない可能性があります。エクスペリエンスを向上させるために、顧客はそれらをナビゲーションセクションに移行する必要があります。
    • デフォルトで利用可能なカスタマイズされたアイコンセクションについては、顧客はまだアクティブである従来のデフォルトアイコンセクションを手動でレビューし、カスタマイズを新しいデフォルトナビゲーションセクションに移動する必要があります。
    • カスタマイズされたアイコンセクションが新しいナビゲーションセクションに移行されない場合、新しい ネクストエクスペリエンス テーマと完全には互換性がないエクスペリエンスが混在する可能性があり、アクセシビリティの問題が発生することがあります。

    UI パラメーターの入力フォーム画面への移行

    この場合、sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants スクリプトインクルードには次のキーと値のペアが含まれます。
    • キー：従来のデフォルト sys_sg_button_instance レコードの sys_id。
    • 値：sys_sg_button_instance レコードおよびその他のメタデータの sys_id のカンマ区切りリストを持つオブジェクト。
    [ITSM モバイルエージェントのクリーンアップグレードを実行 (Run clean upgrade for ITSM Mobile Agent)] スクリプトアクションのアップグレードスクリプトが実行され、マップ内の各キーに対して次の手順が実行されます。
    1. 次のレコードのカスタマイズを確認してください。
      • 従来のデフォルト sys_sg_button_instance レコード。
      • sys_sg_button_instance レコードに関連付けられている sys_sg_button レコード
      • sys_sg_button レコードに関連付けられている sys_sg_ui_parameter レコードと sys_sg_action_param_map レコード
      • sys_sg_button レコードに関連付けられている sys_sg_write_back_action_item レコード
    2. カスタマイズに基づいて、次のいずれかの手順が実行されます。
      • 上記のレコードのいずれかがカスタマイズされている場合、スクリプトは新しいデフォルト sys_sg_button_instance レコードを非アクティブにします。
      • 上記のレコードのどれもカスタマイズされていない場合、スクリプトは従来のデフォルト sys_sg_button_instance レコードを非アクティブにします。
    注:
    • デフォルトで利用できないカスタムボタンのインスタンスフロー (UI パラメータ) は引き続き機能しますが、ネクストエクスペリエンス テーマとアクセシビリティコンプライアンスをサポートしない可能性があります。エクスペリエンスを向上させるために、顧客はそれらを入力フォーム画面に移行する必要があります。
    • デフォルトで利用可能なカスタムボタンのインスタンスフロー (UI パラメーター) について、顧客はまだアクティブな従来のデフォルト sys_sg_button_instance レコードを手動でレビューし、カスタマイズを新しい sys_sg_button_instance フローに移動する必要があります (マップ sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants を参照)。モバイルでの入力フォーム画面の設定方法については、「入力フォーム画面」を参照してください。
    • カスタマイズされた UI パラメーターが新しい入力フォーム画面に移行されない場合、新しい ネクストエクスペリエンス テーマと完全には互換性がないエクスペリエンスが混在する可能性があり、アクセシビリティの問題が発生することがあります。

    新しいモバイルカードへのアイテムビューの移行

    この場合、sn_itsm_mobile_agt.MobileIconSectionMigrationConstants スクリプトインクルードには次のキーと値のペアが含まれます。
    • キー：従来のデフォルト sys_sg_item_view レコードの sys_id。
    • 値：従来のカード (つまりアイテムビュー) が参照される、sys_sg_form_screen レコードおよび sys_sg_master_item レコードの sys_id のカンマ区切りリストを持つオブジェクト。
    [ITSM モバイルエージェントのクリーンアップグレードを実行 (Run clean upgrade for ITSM Mobile Agent)] スクリプトアクションのアップグレードスクリプトが実行され、マップ内の各キーに対して次の手順が実行されます。
    1. 次のレコードのカスタマイズを確認してください。
      • 従来のデフォルト sys_sg_item_view レコード。
      • sys_sg_item_view レコードに関連付けられているすべての sys_sg_ui_style レコード。
    2. 前述のレコードのいずれかがカスタマイズされている場合、スクリプトはこれらのレコードがカスタマイズされていない場合にのみ sys_sg_form_screen レコードと sys_sg_master_item レコードを前の状態に戻します。
    注:
    • デフォルトで利用できないカスタムアイテムビューは引き続き機能しますが、ネクストエクスペリエンス テーマとアクセシビリティコンプライアンスをサポートしない可能性があります。エクスペリエンスを向上させるために、顧客はそれらを入力フォーム画面に移行する必要があります。
    • デフォルトで利用可能なカスタムアイコンセクションについては、顧客はまだアクティブである古いデフォルトフローを手動でレビューし、カスタマイズを新しいフローに移動する必要があります。モバイルでのカードの設定方法については、「モバイルカードビルダーを使用した画面のカスタマイズ」を参照してください
    • カスタマイズされたアイテムビューが新しいモバイルカードに移行されない場合、新しい ネクストエクスペリエンス テーマと完全には互換性がないエクスペリエンスが混在する可能性があり、アクセシビリティの問題が発生することがあります。