ウィジェット診断

ウィジェットのカスタマイズレベルを特定し、ポータルページから直接ウィジェットコードを確認することで、サービスポータル ページの問題を解決します。

ポータルページが期待どおりに機能しない場合は、ウィジェットコードのバグが原因である可能性があります。ページを診断するには、ページのウィジェットを診断してみてください。

ウィジェットの診断には、以下が含まれます。

• ウィジェットのカスタマイズレベルを特定する
• 各ウィジェットで使用されているコードを確認する

カスタマイズレベルの識別

カスタマイズレベルは 、ウィジェットがどのように変更または開発されたかを示します。ウィジェットのカスタマイズレベルを特定すると、ウィジェットコードのどの部分をチェックすることが最も重要かを知るのに役立ちます。ウィジェットのカスタマイズには 4 つのレベルがあります。

カスタマイズレベル	説明
ベース	ベースシステムまたは他の ServiceNow プラグインとともにインストールされるベースウィジェット。ベースウィジェットに変更はありませんが、インスタンスオプションを設定したウィジェットインスタンスを含めることができます。
クローン作成日	ベースウィジェットからクローンしたウィジェット。
新規	作成したウィジェット。
カスタマイズ済み	次のいずれかの方法で構成したベースウィジェット。 ウィジェットコードの直接変更 ウィジェットオプションスキーマの変更 ウィジェットの依存関係、ng テンプレート、または Angular プロバイダーの変更

ポータルページのウィジェットのカスタマイズレベルを特定するには、ウィジェットコンテキストメニューを開き、[ ウィジェットのカスタマイズを表示] を選択します。ウィジェットは次のように色分けされています。

• 緑:ベースウィジェット
• 黄色:クローンされたウィジェット
• 青:新しいウィジェット
• 赤:カスタマイズされたウィジェット

図 : 1. ポータルページでハイライト表示されたウィジェットのカスタマイズ

ウィジェットコードの確認

ポータルページのウィジェットのカスタマイズレベルを特定したら、各ウィジェットのコードを確認します。

ポータルページからウィジェットコードを表示するには、ウィジェットの情報アイコン ( ) をクリックします。

ウィジェット診断ウィンドウから、いくつかの方法でウィジェットコードを確認できます。

• ポータルページからのウィジェットレコードの表示

  ポータルページから移動することなく、ウィジェットレコードの中の潜在的に問題のあるコードを表示および識別します。

• ウィジェット関連レコードのカスタマイズの特定

  ウィジェットの依存関係、角度プロバイダ、およびウィジェットが使用している ng-templates の中の、潜在的に問題のあるコードを表示および識別します。

• ウィジェット関連レコードのバージョンの比較

  Angular プロバイダーまたは ng-template を以前のバージョンと比較して、最新のコード変更によってポータルページで問題が発生しているかどうかを確認します。

• カスタマイズされたウィジェットのバージョンの比較

  カスタマイズされたウィジェットの最新の更新を以前のバージョンと比較し、最近の変更によってポータルページで問題が発生しているかどうかを確認します。

• クローンまたはカスタマイズされたウィジェットとベースウィジェットの比較

  ウィジェットのカスタマイズされた箇所を特定します。これによって、クローンされたまたはカスタマイズされたウィジェットを元に戻し、ポータルページで問題を解決できるようになります。

ウィジェットの診断に関する推奨事項

4 つのカスタマイズレベルのうち、最も優先度の高い問題はカスタマイズされたウィジェットです。これらのウィジェットは、システムアップグレードではサポートされていません。アップグレード中にページの問題が発生した場合は、ポータルページにカスタマイズされたウィジェットがあることが原因である可能性があります。

カスタマイズされたウィジェットが原因で発生する可能性のあるページの問題を解決するには、ウィジェットコードのどの部分がカスタマイズされているかを特定します。その後、コードを元の構成に戻します。これらのコードの違いを特定する方法の詳細については、「 クローンまたはカスタマイズされたウィジェットとベースウィジェットの比較」を参照してください。

ヒント:

カスタマイズされたウィジェットがページの問題の原因になっていない場合でも、後でアップグレード時に問題が発生するのを防ぐために、元のウィジェットに戻すことができます。

カスタマイズしたウィジェットを元に戻した後もページの問題が解決しない場合は、次に新しいウィジェットとクローンウィジェットを確認します。

新しいウィジェットを使用すると、最新のコード変更によってポータルページで問題が発生している可能性があります。最新の変更を特定してコードをデバッグできるようにするには、「 ウィジェット関連レコードのバージョンの比較」の手順に従います。

システムのアップグレード前にウィジェットのクローンを作成した場合、クローンされたウィジェットはベースウィジェットと同じ更新されたコードを受信しなかった可能性があります。この場合、ウィジェットのクローンを再度作成し、カスタマイズをクローンに追加することをお勧めします。

ベースウィジェットは、ページの問題を引き起こす可能性が最も低くなります。他のウィジェットを既にチェックしてもページの問題が解決しない場合は、ページからベースウィジェットを削除し、ウィジェットオプションを設定せずに再度追加します。代わりに、ベースウィジェットを別のページに追加してみることもできます。

制限事項

ポータルページからウィジェット診断を使用する場合、いくつかの既知の制限があります。

• ウィジェットコードを表示して比較することはできますが、コードを直接修正または元に戻すことはできません。ポータルから離れてコードを変更します。
• ウィジェット診断の使用中に別のポータルページに移動すると、システムはツールを無効にします。
• このツールは色を使用してウィジェットを分類するため、視覚障害のあるユーザーはアクセスできない場合があります。
• ポータルページに表示されるウィジェットの依存関係には、第 1 レベルの依存関係のみが反映されます。第 1 レベルよりも深くネストされた依存関係は含まれません。ウィジェットのトラブルシューティングをさらに行うには、ウィジェットレコードでネストされた依存関係を確認します。
• ウィジェットの依存関係を削除した後に、システムでそれを追跡する方法はありません。