Power Pages DevTools 延伸模組
Microsoft Edge DevTools 的 Power Pages 延伸模組是一個開發人員工具，旨在增強在 Power Pages 網站上工作的製作者和管理員的開發和疑難排解體驗。 它提供了諸如顯示 Liquid 追蹤訊息和伺服器端錯誤訊息之類的功能。 使用此工具，製作者和管理員可以有效地識別、診斷和解決 Power Pages 環境中的問題。 透過在 Liquid 程式碼中啟用記錄記錄和追蹤功能，以及提供對錯誤場景的清晰見解，該 Power Pages 延伸模組可促進更順暢的開發工作流程，並提高 Power Pages 網站的整體品質。
注意
開發人員工具延伸模組目前僅適用於 Microsoft Edge。
若要使用開發人員工具，您需要：
- 安裝瀏覽器延伸模組。
- 啟用診斷設定。
- 查看伺服器端錯誤並遵循緩解詳細資訊。
- 查看使用 Liquid 程式碼新增的自訂記錄訊息。
安裝瀏覽器 DevTools 延伸模組
若要安裝 Power Pages 的 DevTools 延伸模組：
啟用診斷設定
注意
如果網站可見性狀態為「私人」，則預設情況下會啟用診斷設定。
若要為公共網站啟用診斷設定，請執行以下操作：
- 開啟 Power Pages Management App。
- 使用名稱 UserTrace/Debug 新增或更新網站設定。
- 將值設為 True。
檢閱伺服器端錯誤訊息
啟用診斷設定時，平台將記錄伺服器上發生的任何錯誤。 若要擷取這些伺服器錯誤訊息，您需要：
開啟 Microsoft Edge 網頁瀏覽器。
瀏覽至您的 Power Pages 網站。
開啟瀏覽器 DevTools。
選取 Power Pages 索引標籤。
重現遇到錯誤的場景。
該工具會顯示所有伺服器端錯誤訊息的清單以及可能的解決方案。
注意
目前，您可能只能看到數量有限的失敗錯誤訊息。 但是，之後的版本都將納入針對各種失敗類型的附加錯誤訊息。
以下是一些錯誤訊息範例：
如果入口網站連絡人的 LogonEnabled 屬性為 False，則本機登入提供者發生錯誤。
搜尋外部實體設定不正確。
使用 Liquid 記錄自訂訊息
製作者可以在其 Liquid 程式碼中新增記錄陳述式。 當 Power Pages 網站執行時，製作者在 Liquid 程式碼中新增的記錄將顯示在 Power Pages 開發人員工具延伸模組中。 製作者能夠將記錄陳述式合併到他們的 Liquid 程式碼中。 啟用診斷設定時，這些由製作者嵌入的記錄將顯示在開發人員工具延伸模組中。
可以在 Liquid 程式碼中使用以下語法來記錄自訂訊息：
{% log message:'Custom message' level:'Warning' %}
| 參數 | Description |
|---|---|
| 記錄 | Liquid 物件名稱 |
| 訊息 | 表示要記錄的任何自訂訊息的字串 |
| 層級 | 將訊息記錄為「資訊」、「警告」或「錯誤」 |
範例:
{% 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 %}