ウィジェット診断

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

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

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

    ウィジェットの診断には次が含まれます。
    • ウィジェットのカスタマイズレベルの特定
    • 各ウィジェットで使用されているコードの確認

    カスタマイズレベルの特定

    カスタマイズレベルは、ウィジェットが変更または開発された方法を示します。ウィジェットのカスタマイズレベルを特定することで、ウィジェットコードのどの部分を確認することが最重要かを把握できます。ウィジェットのカスタマイズには 4 つのレベルがあります。
    カスタマイズレベル 説明
    ベースシステム インスタンスオプションを設定したウィジェットを含む、未変更のベースシステムウィジェット。
    クローン作成日 ベースシステムウィジェットからクローンしたウィジェット。
    新規 作成したウィジェット。
    カスタマイズ済み 次のいずれかの方法で設定したベースシステムウィジェット。
    • ウィジェットコードの直接変更
    • ウィジェットオプションスキーマの変更
    • ウィジェット依存関係、ng テンプレート、または Angular プロバイダーの変更

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

    カスタマイズレベルの特定
    • 緑 – ベースシステムウィジェット
    • 黄 – クローン済みウィジェット
    • 青 – 新しいウィジェット
    • 赤 – カスタマイズ済みウィジェット

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

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

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

    ウィジェット診断ウィンドウ

    ウィジェット診断ウィンドウから、次のさまざまな方法でウィジェットコードを確認できます。

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

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

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

    ヒント:
    現在、カスタマイズ済みウィジェットがページの問題を引き起こしていない場合でも、後のアップグレード時に問題が発生しないように元のウィジェットに戻すこともできます。

    カスタマイズ済みウィジェットを元に戻してもページの問題が解決しない場合は、次に新しいウィジェットおよびクローンしたウィジェットを確認してください。

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

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

    ベースシステムウィジェットがページの問題を引き起こす可能性はほとんどありません。他のウィジェットを確認し終えてもページの問題が引き続き発生する場合は、ベースシステムウィジェットをページから削除して、ウィジェットオプションを設定せずに再度追加してください。また、代わりに、ベースシステムウィジェットを別のページに追加することもできます。

    制限事項

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