Madrid から New York 以降のリリースへのモバイル移行

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:10分
  • モバイルアプリケーションを New York 以降のリリースに移行し、スタジオ 内で、改善された機能を活用して編集を続行します。

    アップグレード中に行われた変更

    Madrid から New York へのアップグレード中に、Mobile Agent Native Client [agent_native_client] プラグインをアクティブ化することで、新しいモバイル階層へとインスタンスが更新されます。このインストールでは、次の変更が行われます。
    ネイティブクライアント
    ネイティブクライアント [sys_sg_native_client] テーブルを追加します。このテーブルのレコードは、利用可能なネイティブクライアント、モバイルエージェントNow Mobile、および モバイルオンボーディング を表します。
    ナビゲーションバー
    ナビゲーション [sys_sg_navigation] テーブルを追加します。このテーブルのレコードは、各ネイティブクライアントのナビゲーションバーを表しています。移行中にこのテーブルのレコードは、[レガシーアプリケーション] [legacy_application] フィールドが有効になっています。
    通知タブ
    通知タブ [sys_sg_notifications_tab] テーブルを追加します。このテーブルのレコードは、各ナビゲーションバーの通知のタブを表します。
    [設定] タブ
    設定タブ [sys_sg_settings_tab] テーブルを追加します。このテーブルのレコードは、各ナビゲーションバーの設定のタブを表します。
    ニューヨークへのアップグレードで導入された新しい要素

    このアップグレードには、アプリケーションランチャーや構成可能なナビゲーションバーなどの新しい機能が含まれています。インスタンスにインストールされている未変更のベースシステムモバイルアプリケーションは、新しい設計に合わせて自動的に更新されます。また、スタジオ と共にすぐに使用することもできます。New York 以降で使用されるモバイル階層の詳細については、「モバイル階層」を参照してください。

    変更されたベースシステムアプリケーションと、Madrid で作成したアプリケーションは、アップグレード後も引き続き動作します。これらのアプリケーションは、モバイル移行スクリプトを実行するまで スタジオ で構成することはできません。

    アップグレード後の考慮事項

    アップグレード後は次の情報を考慮して、モバイル実装が期待どおりに機能していることと、モバイル移行スクリプトが実行されていることを確認してください。

    変更されたベースシステムアプリケーション
    ServiceNow で提供されているモバイルアプリケーションと作成したすべてのアプリケーションに加えたすべての変更を文書化します。これらの各アプリケーションをテストして、期待どおりに機能し続けることを確認します。
    アップグレードのデバッグ機能を使用する

    アップグレードのデバッグ機能は、アップグレードの問題を迅速に診断する際に役立ちます。この機能の詳細については、「アップグレードのデバッグ」を参照してください。

    このツールのビデオトレーニングコースが利用可能です。このコースを表示するには、「アップグレードをデバッグを使用」を参照してください。

    スキップ済みレコードをレビューする

    カスタマイズが上書きされないようにするため、アップグレードプロセスは変更したレコードを更新しません。代わりにアップグレードプロセスは、このスキップ済みレコードをアップグレードログに記録します。

    スキップ済みレコードを解決するためのビデオトレーニングコースを利用できます。このコースを表示するには、「スキップ済みレコードをアップグレード」を参照してください。

    機能をアップグレード後に確認する
    インスタンスをアップグレードして移行スクリプトを実行すると、回帰テストにより、ユーザーはアップグレード後も期待どおりに動作し続けられるかを確認できます。回帰テストは、アプレット、画面 UI ポリシー、機能をレビューして、意図したとおりに機能していることを確認するものです。

    モバイル移行スクリプトの実行

    このスクリプトは、カスタムアプリケーションとすべての変更されたベースシステムアプリケーションを、New York リリースで利用可能な新しいモバイルスキーマに変換します。スクリプトは、現在のスコープのみを実行時に変更します。スコープ対象のモバイルアプリケーションが複数ある場合、スクリプトをスコープごとに実行する必要があります。

    アップグレード後、移行スクリプトを実行するオプションは、カスタムアプリケーションに最初にアクセスしたときか変更したベースシステムアプリケーションにアクセスしたときに表示されます。たとえば、変更された、またはカスタムのアプレットレコードを開く際などです。スタジオのアプレットピッカーにアクセスしたときに、次の場所を参照して移行プロンプトを表示することもできます モバイルスタジオ > アプレット をクリックし、ポップアウトアイコン( ポップアウトアイコン)をクリックします。移行プロンプトは、ピッカーに表示されるアプレットのいずれかを移行する必要がある場合に表示されます。

    モバイル移行スクリプトプロンプト

    スクリプトが完了した後、移行プロセスによって検出された競合を解決するように求められる場合があります。競合は ServiceNow によって作成されたレコードで、ユーザーが変更を加えたものであり自動ではアップグレードされません。競合は、ベースシステムアプリケーションを New York 以降のリリースにアップグレードする前に変更した場合にのみ発生する可能性があります。

    モバイル移行競合プロンプト
    これらの競合を解決するには、[競合を表示] をクリックします。このプロセスの詳細については、「モバイル移行スクリプトの結果の一般的な問題の解決」を参照してください。

    モバイル移行スクリプトによる変更

    [移行] をクリックすると、現在のスコープの移行スクリプトが開始されます。移行スクリプトは、開いているアプレットだけでなく、スコープ内のすべてのレコードを移行します。

    アプレットランチャーに移行するアプリケーションとフォルダー

    従来の Madrid スキーマでは、モバイルアプリケーションとフォルダーを使用してアプレットを整理していました。Now Mobile スキーマでは、UI セクションに分割されたアプレットランチャー画面を使用します。アプレットランチャーは、アプリケーション画面の下部に表示されるナビゲーションバー内のタブをタップすることでアクセスします。

    図 : 1. New York スキーマのアプリケーションへの変更
    New Yorkスキーマ内のアプリケーションへの変更。

    移行スクリプトは、モバイルアプリケーションレコードごとにアプレットランチャーを作成します。スクリプトは元のモバイルアプリケーションの各フォルダーを、そのアプレットランチャー内の新しい水平アイコンセクションに変換します。次に、スクリプトは、フォルダーの各アプレットのアイコンセクションにアイコンを作成します。非表示の画面は、アイコンセクションには表示されません。次にスクリプトは、新しいアプレットランチャーのそれぞれについて、ナビゲーションバーにタブを追加します。

    サンプルイメージには、移行プロセス後のインシデントアプリケーションが示されています。元のフォルダー ([自分のインシデント] および [グループインシデント]) は、[インシデント] アプレットランチャーの UI セクションとして表示されます。これらの UI セクションは水平方向にスクロールして、必要に応じていくつでもアプレットを表示できます。ナビゲーションバーの [インシデント] タブをタップすると、[インシデント] アプリケーションにアクセスできます。

    移行後、スクリプトは従来のフォルダー [sys_sg_folder] およびモバイルアプリケーション [sys_sg_application] レコードを削除します。

    Madrid アイコンセクションとアイコンに変換された New York アプリケーション。

    ナビゲーションバー、アプレットランチャー、およびその UI セクションの詳細については「ナビゲーションバー」および「ランチャー画面」を参照してください。

    フォームの移行
    フォームアプレットは、Madrid リリースのレコードフォームの表示に使用されるルートの詳細画面に代わるものです。移行により、フォーム画面 [sys_sg_form_screen] レコードが作成されます。このスクリプトは、元の [メイン詳細] 画面の埋め込み画面ごとにセグメントを作成します。元のメイン詳細画面に関連付けられたボタン [sys_sg_button] レコードは、新しいフォームアプレットに関連するように変更されます。
    マップの移行
    マップアプレットでは、 Madrid リリースのマップカードのフィールドを表示するためにアイテムビューを使用しませんでした。移行スクリプトは、元のマップアプレットの [タイトル]、[タグ]、[サブタイトル]、 [情報] の各フィールドを使用して、各マップアプレットのアイテムビュー [sys_sg_item_view] レコードを作成します。
    カレンダーの移行
    移行スクリプトは、各カレンダーの期間アイテムストリーム [sys_sg_time_span_item_stream] レコードを作成して、カレンダーの元のデータアイテムを新しいアイテムストリームに関連付けます。また、移行スクリプトはフォームアプレット [sys_sg_form_screen] レコードを作成して、カレンダーの元の埋め込み画面から新しいフォームにボタンを移行します。
    アイテムストリームとアイテム構成

    ネイティブクライアントのコンポーネント。

    移行スクリプトは、スコープ対象のアプリケーションの各画面でアイテムストリーム [sys_sg_item_stream] レコードを作成します。従来のアプリケーションに関連付けられた元のデータアイテムレコードが変更され、新しいアイテムストリームレコードに関連付けられます。このスクリプトでは、各カレンダー画面のタイムスパンアイテムストリーム [sys_sg_time_span_item_stream] レコードと、マップ画面の場所アイテムストリーム [sys_sg_location_item_stream] レコードが作成されます。これら 2 つのテーブルはアイテムストリームテーブルから拡張されますが、これらの画面タイプにのみ使用されます。

    画面のクリーンアップ
    次のフィールドは、画面レコードでは使用されなくなりました。このスクリプトは、これらのフィールドを画面 [sys_sg_screen] テーブルのコールレコードから削除します。
    • ユーザーロール [application_roles]
    • 順番 [order]
    • 親 [parent]
    • 親テーブル [parent_table]
    • データアイテム [sys_sg_data_item]
    • 非表示 [hidden]
    また、このスクリプトは、マップ画面 [sys_sg_map_screen] レコードの次のフィールドからも値を削除します。
    • データアイテムテーブル [data_item_table]
    • タイトル [title]
    • サブタイトル [subtitle]
    • 情報 [info]
    • 場所 [location]
    • タグ [tag]
    • タグのフォント色 [tag_font_color]
    • タグ背景色 [tag_background_color]
    • タグスタイル [tag_style]
    • 電話 [phone]
    • カラータイプを固定 [pin_color_type]
    • カラーを固定 [pin_color]
    このスクリプトは、アイテム構成 [sys_sg_master_item] レコードの次のフィールドから値を削除します。
    • テーブル [table]
    • 画面 [screen]
    • 条件 [condition]
    • 条件の順序 [condition_order]

    このスクリプトは、詳細画面 [sys_sg_details_screen] レコードの [アイテムビュー [item_view]] フィールドの値を削除します。

    このスクリプトは、リスト画面 [sys_sg_list_screen] レコードの [アイテムビュー [item_view]] フィールドの値を削除します。

    このスクリプトは、アイテムビュー [item_view] レコードの [データアイテム [data_item]] フィールドの値を削除します。

    その他のリソース

    移行プロセスの詳細については、「New York のモバイル移行ガイド」を ServiceNow コミュニティサイトで参照してください。 https://community.servicenow.com/community?id=community_article&sys_id=f5121a33dba7f788fff8a345ca961957