ウィジェット診断
ウィジェットのカスタマイズレベルを特定し、ポータルページから直接ウィジェットコードを確認することで、サービスポータル ページの問題を解決します。
ポータルページが期待どおりに機能しない場合は、ウィジェットコードのバグが原因である可能性があります。ページを診断するには、ページのウィジェットを診断してみてください。
- ウィジェットのカスタマイズレベルの特定
- 各ウィジェットで使用されているコードの確認
カスタマイズレベルの特定
| カスタマイズレベル | 説明 |
|---|---|
| ベースシステム | インスタンスオプションを設定したウィジェットを含む、未変更のベースシステムウィジェット。 |
| クローン作成日 | ベースシステムウィジェットからクローンしたウィジェット。 |
| 新規 | 作成したウィジェット。 |
| カスタマイズ済み | 次のいずれかの方法で設定したベースシステムウィジェット。
|
ポータル・ページ上のウィジェットのカスタマイズ・レベルを識別するには、ウィジェット・コンテキスト・メニューを開き、「 ウィジェットのカスタマイズを表示」を選択します。ウィジェットは次のように色分けされています。
|
ウィジェットコードの確認
ポータルページでウィジェットのカスタマイズレベルを特定したら、各ウィジェットのコードを確認します。
ポータルページからウィジェットコードを表示するには、ウィジェットの情報アイコン () をクリックします。
- ポータルページからのウィジェットレコードの表示
ポータルページから移動することなく、ウィジェットレコードの中の潜在的に問題のあるコードを表示および識別します。
- 関連レコードの表示
ウィジェットの依存関係、角度プロバイダ、およびウィジェットが使用している ng-templates の中の、潜在的に問題のあるコードを表示および識別します。
- 関連レコードに対する変更の比較
Angular プロバイダーまたは ng-template を以前のバージョンと比較して、最新のコード変更によってポータルページで問題が発生しているかどうかを確認します。
- カスタマイズ済みウィジェットに対する変更の比較
カスタマイズされたウィジェットの最新の更新を以前のバージョンと比較し、最近の変更によってポータルページで問題が発生しているかどうかを確認します。
- カスタマイズ済みウィジェットのベースシステムとの比較
ベースシステムウィジェットのカスタマイズされた箇所を特定します。これによって、カスタマイズされたウィジェットを元に戻し、ポータルページで問題を解決できるようになります。
ウィジェットの診断に関する推奨事項
4 つのカスタマイズレベルのうち、最も優先度の高い問題はカスタマイズ済みウィジェットです。これらのウィジェットは、システムアップグレードではサポートされていません。アップグレード中にページの問題が発生している場合は、ポータルページにカスタマイズ済みウィジェットがあることが原因である可能性があります。
カスタマイズ済みウィジェットによって発生する可能性があるページの問題を解決するには、ウィジェットコードのカスタマイズされた部分を特定します。その後、コードを元の構成に戻します。これらのコードの違いを識別する方法の詳細については、「カスタマイズ済みウィジェットのベースシステムとの比較」を参照してください。
カスタマイズ済みウィジェットを元に戻してもページの問題が解決しない場合は、次に新しいウィジェットおよびクローンしたウィジェットを確認してください。
新しいウィジェットでは、最新のコード変更がポータルページで問題を引き起こしている可能性があります。最新の変更を特定することでコードをデバッグできるようするには、「関連レコードに対する変更の比較」の手順に従います。
システムアップグレード前にウィジェットをクローンした場合は、クローン済みウィジェットがベースシステムウィジェットと同じ更新コードを受信していない可能性があります。この場合は、ウィジェットを再度クローンしてカスタマイズをクローンに追加することをお勧めします。
ベースシステムウィジェットがページの問題を引き起こす可能性はほとんどありません。他のウィジェットを確認し終えてもページの問題が引き続き発生する場合は、ベースシステムウィジェットをページから削除して、ウィジェットオプションを設定せずに再度追加してください。また、代わりに、ベースシステムウィジェットを別のページに追加することもできます。
制限事項
- ウィジェットコードを表示して比較できますが、コードを直接修正したり元に戻したりはできません。ポータルから移動してコードを変更します。
- ウィジェット診断の使用中に別のポータルページに移動すると、ツールが無効になります。
- このツールは色を使用してウィジェットを分類しているため、視覚障害のあるユーザーはアクセスできない場合があります。
- ポータルページにリストされているウィジェットの依存関係には、第 1 レベルの依存関係のみが反映されます。第 1 レベルよりも深くネストされている依存関係は含まれません。ウィジェットのトラブルシューティングをさらに進めるには、ウィジェットレコードでネストされた依存関係を確認します。
- ウィジェットの依存関係を削除した後で、依存関係を追跡する方法はありません。