Power Pages DevTools 拡張機能
Microsoft Edge DevTools 用 Power Pages 拡張機能は、Power Pages サイトで作業するメーカーや管理者の開発およびトラブルシューティング体験を向上させるために設計された開発者ツールです。 Liquid トレース メッセージやサーバーサイド エラー メッセージの表示などの機能を提供します。 このツールを使用することで、作成者や管理者は Power Pages 環境内の問題を効率的に特a定、診断、解決することができます。 Liquid コードのログ記録とトレース機能を有効にし、エラー シナリオの明確な分析情報を提供することで、Power Pages 拡張機能はよりスムーズな開発ワークフローを促進し、Power Pages サイトの全体的な品質を向上させます。
注意Note
開発者ツール拡張機能は、現在 Microsoft Edge でのみ利用可能です。
開発者ツールを使用するには、次のことが必要です。
- ブラウザ拡張機能をインストールします。
- 診断設定の有効化。
- サーバー サイド エラーの確認と緩和策の詳細。
- Liquid コードを使用して追加されたカスタム ログ メッセージを表示します。
DevTools 拡張機能をインストールする
Power Pages 用 DevTools 拡張機能をインストールする方法:
- Microsoft Edge 用 Microsoft Power Pages 拡張機能にアクセスします。
- 取得 を選択します。
診断設定の有効化
注意Note
サイトの表示 ステータスがプライベートの場合、診断設定は既定で有効になっています。
公開 Web サイトの診断設定を有効にする方法:
- Power Pages Management アプリ を開きます。
- サイト設定 を UserTrace/Debug という名前で追加または更新します。
- 値に 真 を設定します。
サーバーサイド エラー メッセージのレビュー
診断設定を有効にすると、プラットフォームはサーバー上で発生したすべてのエラーをログに記録します。 これらのサーバー エラー メッセージをキャプチャするには、次の手順を実行する必要があります:
Microsoft Edge Web ブラウザーを開きます。
Power Pages Web サイトに移動します。
DevTools ブラウザーを開きます。
Power Pages タブを選択します。
エラーが発生したシナリオを再現します。
このツールは、サーバーサイドのすべてのエラー メッセージと、考えられる解決策のリストを表示します。
注意Note
現在、表示される失敗エラー メッセージの数は限られています。 しかし、その後の各リリースには、さまざまな種類の不具合/エラーに対するエラーメッセージが追加されます。
エラー メッセージの例を次に示します:
ポータルの取引先担当者の LogonEnabled 属性が False の場合、ローカル サインイン プロバイダでエラーが発生します。
外部エンティティの検索が正しく構成されていません。
Liquid でカスタム メッセージを記録する
作成者は、Liquid コードにログ ステートメントを追加できます。 Power Pages サイトが実行中の場合、Liquid コードでメーカーによって追加されたログが、Power Pages 開発者ツール拡張機能に表示されます。 作成者は、Liquid コード内にログ ステートメントを組み込むことができます。 作成者が埋め込んだこれらのログは、診断設定が有効になっている場合、開発者ツールの拡張機能に表示されます。
Liquid コードでカスタム メッセージをログに記録するには、次の構文を使用できます:
{% log message:'Custom message' level:'Warning' %}
| パラメーター | プロパティ |
|---|---|
| ログ | Liquid オブジェクト名 |
| message | ログに記録するカスタムメッセージを表す文字列 |
| level | メッセージを情報、警告、またはエラーとして記録する |
例:
{% log message: 'Log from Home page' %}
{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}
{% assign contacts = query.results.entities %}
{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %}
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}