ウィジェット診断

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:5分
  • ウィジェットのカスタマイズレベルを特定し、ポータルページから直接ウィジェットコードを確認することで、サービスポータル ページの問題を解決します。

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

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

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

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

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

    • 緑:ベースウィジェット
    • 黄:クローンウィジェット
    • 青:新しいウィジェット
    • 赤:カスタマイズされたウィジェット
    図 : 1. ポータルページでハイライト表示されたウィジェットのカスタマイズ
    カスタマイズレベルの特定

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

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

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

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

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

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

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

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

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

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

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

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

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

    制限事項

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