モバイル移行スクリプトの結果の一般的な問題の解決
モバイル移行スクリプトを実行した後の一般的な問題の解決策を見つけることができます。
エラーメッセージをログに記録
モバイル移行スクリプトは、エラーが発生するとログ [syslog] テーブルにエントリーを追加します。これらのログを確認するには、次の場所に移動します。 . モバイル移行スクリプトによってログに追加される可能性があるエラーがここにリストされます。
| エラーメッセージ | 解決 |
|---|---|
| 無効なインスタンススコープが指定されました | このメッセージが表示された場合は、移行スクリプトが中断されています。移行スクリプトを再度実行して、移行を完了します。移行スクリプトを再実行するには、 スタジオ を再度開いてスコープを選択します。 |
| 移行する前に、まず com.glide.mobile-employee を有効にしてください。 | 移行スクリプトを実行するには、 ServiceNow NowMobile App Screens and Applet Launcher [com.glide.mobile-employee] プラグインを有効にする必要があります。このプラグインがアクティブであることを確認します。このメッセージが表示された場合は、移行スクリプトが中断されています。移行スクリプトを再度実行して、移行を完了します。 |
| カスタマイズされたレコードでは移行タスクを実行できません。 | このエラーの原因となっているレコードは、このメッセージの直後に表示されます。このレコードをカスタマイズしたため、移行スクリプトでこのファイルを変更できなくなりました。移行スクリプトはこのファイルをスキップし、実行を続行します。名前付きファイルは スタジオ ではアクセスできません。 |
競合
New York 以降のバージョンにアップグレードする前にカスタマイズしたベースシステムアプリケーションで競合が発生する可能性があります。移行スクリプトで競合が検出された場合は、スクリプトの実行完了後に競合を確認するように求められます。
[ 競合の表示 ] ボタンをクリックすると、アップグレードの詳細 [sys_upgrade_history_log] レコードのフィルター済みリストが表示されます。このリストには、アップグレードプロセスがスキップした現在のスコープ内のレコードが表示されます。競合を解決するには、このリストのレコードをクリックしてレコードを開き、[ 競合の解決 ] ボタンをクリックします。
競 合の解決 フォームには、カスタマイズされたバージョンと一緒にレコードのベースシステムバージョンが表示されます。バージョン間で異なるフィールドは、暗い背景で強調表示されます。
) を使用します。変更を行った後、[結合を 保存 ] ボタンをクリックして変更を保存します。[ ベースシステムに戻る ] ボタンをクリックしてカスタマイズを破棄し、未変更のバージョンのレコードを使用することもできます。一般的な競合の問題はマスター詳細 [sys_sg_master_detail_screen] レコードです。マスター詳細レコードは、 New York リリース以降、モバイルスキーマの一部ではなくなりました。これらのレコードは、新しいリスト [sys_sg_list_screen] およびフォーム [sys_sg_form_screen] 画面レコードに置き換えられます。通常はアップグレードプロセスの一環として削除されますが、カスタマイズされている場合、スクリプトによって自動的に削除されることはありません。たとえば、ベースシステムアプリケーションの名前を変更した場合、この種の競合が発生する可能性があります。
この問題を解決するには、モバイルスタジオをチェックして、アプレットがまだ使用可能で、期待どおりに動作していることを確認してください。アプレットが利用可能であることを確認したら、メイン詳細レコードを削除できます。
一般的な移行の問題
- アプレットがありません
- 移行後、アプレットがナビゲーションバーの [アプリケーション ] タブに表示されます。アプレットが表示されない場合は、これらのアプレットを手動で移行できます。
- スタジオで、 アプリケーションエクスプローラーで、アプレットが欠落しているアプリを選択します。
- [ ナビゲーションタブ ] 関連リストで、[ アプリケーション ] ナビゲーションタブをクリックします。
- [アプリケーション] タブに関連付けられているアプレットランチャーを確認します。
- スタジオで、 をクリックし、最後のステップでメモしたアプレットランチャーを開きます。
- アプレットランチャーフォームで、移行前に欠落しているアプレットが配置されていたフォルダーと同じ名前の UI セクションを選択します。
- 「 すべてのアプレット 」リストで不足しているアプレットを見つけて、「 選択されたアプレット 」リストに移動します。
- [保存] をクリックします。
- アプレットに関連リストがありません
- この問題は、関連リストマッピング [sys_sg_related_list_map] テーブルの古い参照が原因である可能性があります。関連リストの 宛先画面 を再関連付けて、問題を解決できます。
- [スタジオ] で、次に移動します。 をクリックし、欠落しているセグメントを持つアプレットを選択します。
- [ フォーム画面 ] タブをクリックします。
- [ 本文] をクリックします。
- [ 関連リスト ] ボタンをクリックします。
- 宛 先画面 値が空のアイテムのリストを確認します。
- リストアイテムをクリックし、[ 宛先画面] フィールドで値を選択します。
- ユーザーは、 フィールドサービス管理 (FSM) アプレットまたは ITSM アプレットに入力パラメーターを入力するように求められない
- 通常、パラメーター化されたアプレットは、ユーザーに値の入力を求めます。移行後にこのプロンプトが表示されなくなった場合は、次の手順を使用して問題を修正してください。
- インスタンスのフィルターナビゲーターに「 sys_sg_ui_parameter.list 」と入力して、UI パラメーター [sys_sg_ui_parameter] リストを開きます。
- ユーザーへのプロンプトを生成していないパラメーターを見つけます。
- [ 画面 ] フィールドの値を確認します。このフィールドが空の場合、マスター詳細画面の [sys_sg_master_detail_screen] レコードを指している可能性があります。
- このパラメーターで使用されるアプレット [sys_sg_screen] レコードを選択して、フィールドを更新します。
- カスタマイズされた フィールドサービス管理 (FSM) または ITSM アプレットの結果が正しくありません。
- この問題は、顧客パラメーターをベースシステムに追加した場合に発生する可能性があります。
- インスタンスのフィルターナビゲーターに「 sys_sg_screen_param_map.list 」と入力して、[画面パラメーターマッピング [sys_sg_screen_param_map] リストを開きます。
- データアイテムに追加したアイテムパラメーターに一致する [アイテムパラメーター ] フィールドを持つレコードを検索します。
- [ 画面 ] フィールドの値を確認します。このフィールドが空の場合、未使用のマスター詳細画面 [sys_sg_master_detail_screen] レコードを指している可能性があります。
- このパラメーターで使用されるアプレット [sys_sg_screen] レコードを選択して、フィールドを更新します。