モバイル移行スクリプトの結果の一般的な問題の解決

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:6分
  • モバイル移行スクリプトを実行した後の一般的な問題の解決策を見つけることができます。

    エラーメッセージをログに記録

    モバイル移行スクリプトは、エラーが発生したときにログ [syslog] テーブルにエントリを追加します。これらのログを確認するには、次に移動します: システムログ > システムログ > すべて. 以下のリストは、モバイル移行スクリプトによってログに追加される可能性のあるエラーを示したものです。

    表 : 1. エラーメッセージ
    エラー メッセージ 解決
    無効なインスタンススコープが指定されました このメッセージが表示された場合、移行スクリプトは中断されました。移行スクリプトをもう一度実行して、移行を完了してください。スタジオ を再び開いてスコープを選択することにより、移行スクリプトを再実行できます。
    移行前にまず com.glide.mobile-employee をアクティブ化してください。 移行スクリプトを実行するには、ServiceNow NowMobile アプリ画面とアプレットランチャー [com.glide.mobile-employee] プラグインをアクティブにする必要があります。このプラグインがアクティブであることを確認します。このメッセージが表示された場合、移行スクリプトは中断されました。移行スクリプトをもう一度実行して、移行を完了してください。
    カスタマイズされたレコードで移行タスクを実行することはできません。 このエラーの原因となっているレコードが、このメッセージの直後に表示されます。このレコードはカスタマイズされているため、移行スクリプトはこのファイルを変更できませんでした。移行スクリプトはこのファイルをスキップし、実行を続行します。指定されたファイルに スタジオ でアクセスできません。

    競合

    New York 以降のバージョンにアップグレードする前にカスタマイズしていると、競合がベースシステムアプリケーションで発生する可能性があります。移行スクリプトが競合を検出すると、スクリプトの実行が完了した後にそれらの競合を確認するように求められます。

    モバイル移行競合プロンプト。

    [競合の表示] ボタンをクリックすると、アップグレードの詳細 [sys_upgrade_history_log] レコードのフィルター済みリストが表示されます。このリストには、アップグレードプロセスがスキップした現在のスコープ内のレコードが表示されます。競合を解決するには、このリストのレコードをクリックしてレコードを開き、[競合の解決] ボタンをクリックします。

    [競合の解決] フォームには、レコードのベースシステムバージョンがバージョン間で異なるカスタマイズバージョンの Fields と併せて、暗い背景で強調表示されます。

    競合の解決フォーム。
    矢印ボタン (矢印ボタン) を使用して、値をあるバージョンから別のバージョンに移動します。変更を加えた後に、[統合を保存] ボタンをクリックして変更を保存します。また [ベースシステムに戻す] ボタンをクリックしてカスタマイズを破棄し、変更されていないバージョンのレコードも使用できます。

    一般的な競合の問題は、マスター詳細 [sys_sg_master_detail_screen] レコードです。マスター詳細レコードは New York リリース時点で、モバイルスキーマの一部ではなくなりました。これらのレコードは、新しいリスト [sys_sg_list_screen] およびフォーム [sys_sg_form_screen] 画面レコードに置き換えられます。通常はアップグレードプロセスの一部として削除されますが、カスタマイズされているとスクリプトによって自動で削除されません。たとえば、ベースシステムアプリケーションの名前が変更してあると、この種の競合が発生する可能性があります。

    この問題を解決するには、Mobile Studio をオンにして、アプレットがまだ利用可能で期待どおりに機能していることを確認してください。アプレットが利用可能であることを確認したら、メイン詳細レコードを削除できます。

    移行の一般的な問題

    アプレットがありません
    移行後、ナビゲーションバーの [アプリケーション] タブにアプレットが表示されるようになります。アプレットが表示されない場合、これらのアプレットを手動で移行できます。
    1. スタジオで、次を開きます。 モバイルスタジオ > アプリケーションメニュー アプリケーションエクスプローラーで、アプレットがないアプリを選択します。
    2. [ナビゲーションタブ] 関連リストで、[アプリケーション] ナビゲーションタブをクリックします。
    3. [アプリケーション] に関連付けられた [アプレットランチャー] をメモします。
    4. スタジオで、次を開きます。 モバイルスタジオ > アプレットランチャーをクリックし、最後の手順でメモしたアプレットランチャーを開きます。
    5. アプレットランチャーフォームで、不足しているアプレットが移行前に配置されていたフォルダーと同じ名前の UI セクションを選択します。
    6. [すべてのアプレット] リスト内の欠落しているアプレットを見つけて、[選択したアプレット] リストに移動します。
    7. [保存] をクリックします。
    関連リストがアプレットにありません
    この問題は、関連リストのマッピング [sys_sg_related_list_map] テーブルの期限切れの参照が原因である可能性があります。関連リストの [宛先画面] を再度関連付けて、問題を解決できます。
    1. [スタジオ] で、次に移動します。 モバイルスタジオ > アプレットをクリックし、セグメントが欠落しているアプレットを選択します。
    2. [フォーム画面] タブをクリックします。
    3. [本文] をクリックします。
    4. [関連リスト] ボタンをクリックします。
    5. [宛先画面] の値が空のアイテムのリストを確認します。
    6. リストアイテムをクリックして、[宛先画面] フィールドの値を選択します。
    ユーザーに、フィールドサービス管理 (FSM) または ITSM アプレットに入力パラメーターを入力するプロンプトが表示されません
    通常、パラメーター化されたアプレットは、ユーザーに値を要求します。移行後にこのプロンプトが表示されなくなった場合、以下のステップに従って問題を修正してください。
    1. インスタンスのフィルターナビゲーターに「sys_sg_ui_parameter.list」と入力して、UI パラメーター [sys_sg_ui_parameter] リストを開きます。
    2. ユーザーにプロンプトを表示しないパラメーターを探します。
    3. [画面] フィールドの値を確認します。このフィールドが空の場合、[マスター詳細] 画面 [sys_sg_master_detail_screen] レコードを指している可能性があります。
    4. このパラメーターによって使用されるアプレット [sys_sg_screen] レコードを選択して、フィールドを更新します。
    カスタマイズされた フィールドサービス管理 (FSM) または ITSM アプレットの結果が正しくありません。
    この問題は、顧客パラメーターをベースシステムに追加した場合に発生する可能性があります。
    1. インスタンスのフィルターナビゲーターに「sys_sg_screen_param_map.list」と入力して、画面パラメーターマッピング [sys_sg_screen_param_map] リストを開きます。
    2. データアイテムに追加したアイテムパラメーターと一致する [アイテムパラメーター] フィールドを持つレコードを検索します。
    3. [画面] フィールドの値を確認します。このフィールドが空の場合、未使用の [マスター詳細] 画面 [sys_sg_master_detail_screen] レコードを指している可能性があります。
    4. このパラメーターによって使用されるアプレット [sys_sg_screen] レコードを選択して、フィールドを更新します。