使用即時監視器來疑難排解模型導向應用程式行為

即時監視器是一種可以幫助應用程式製作者偵錯和診斷問題的工具,從而幫助他們建立更快、更可靠的應用程式。 即時監視器提供應用程式執行時所有活動的記錄,讓您深入了解應用程式的運作情況。

為了協助您隔離某些模型導向應用程式功能,您可以依照特定類別進行篩選,例如表單或 Copilot 控制項。

建立即時監視器工作階段

登入 Power Apps,在左側導覽窗格中選擇解決方案,打開包含要監視的應用程式的解決方案,選擇該應用程式,然後在命令列上選擇即時監視。

在即時監視器頁面上,在命令列上選擇播放模型導向應用程式。 有關建立即時監視器工作階段的更多資訊,請前往使用即時監視器解決模型導向應用程式中的頁面行為問題。

在即時監視器中對模型導向應用程式表單相關事件進行篩選可以在應用程式執行時提供有關即時監視器中表單上的相關表、表、控制項和元件的資訊。

在許多情況下,即時監視器可以幫助製作者了解表單以某種方式表現的原因。 許多表單問題是根據系統管理員和決策者所設定的商務規則、JavaScript、表單事件或用戶端 API 而定。 即時監視器可以幫助確定所遇到的問題是出於現成的設計,還是自訂造成的。 它提供了有助於回答以下問題的詳細資料:

  1. 在執行即時監視器的瀏覽器視窗中,選擇類別列,然後選擇篩選依據。

    在即時監視器中篩選表單事件。

  2. 從下拉清單中選擇等於或包含,然後在方塊中輸入 formchecker。 選取套用。

    輸入表單檢查工具篩選器
  3. 現在類別已經過篩選。 選取並按住資料行的右側,然後向右拖曳,作業資料行即可展開,以查看所追蹤事件的全名。 當您使用應用程式並開啟和使用表單時,即時監視器會更新事件清單。

    顯示的受監視表單事件。

  4. 當應用程式在受監視的工作階段中執行時,在模型導向應用程式中執行與應用程式的正常使用一致的動作。 例如,使用資料表表單打開及變更資料。

使用即時監視器了解表單行為

對於即時監視器的每一行,可以查看有關表單事件的詳細資訊。 例如,假設您對表單中發生的錯誤有疑問。 您可以在應用程式中移至該表單,並選取適當的表單元件。 然後返回啟用即時監視器的瀏覽器並查看帶有或不帶篩選的結果。 在此案例中,複合控制項上有一個錯誤。 透過展開詳細資料的區域,您就可以深入了解事件本身。

監視相關功能表。

受監視的事件種類很多,包括標準表單事件 (例如,onload、onsave 和 onclose)。

當您繼續使用被監控的應用程式時,即時監視器會更新事件清單中的資訊。 對於表單,有許多不同的案例可以疑難排解,並在目前正在處理的表單、控制項或表格上尋找其他資訊。

資料表檢查區域和活動

表單監視的領域包括以下內容。

應用程式區域 描述
控制項狀態 載入表單時,控制項可見、已啟用及標籤來源狀態的詳細資料。
相關功能表 相關功能表項目狀態的詳細資料。 範例:
為何無法顯示功能表項目?
功能表項目從何而來?
索引標籤/區段/控制項狀態變更 關於誰 (透過呼叫堆疊) 導致表單元件 (如索引標籤、區段或控制項) 變更元件的可見度與已啟用狀態的詳細資料。
瀏覽 通過追蹤以下 Xrm.Navigation 用戶端 API 方法的呼叫堆疊來詳細說明造成導覽或意外對話方塊的原因:openAlertDialog(), openConfirmDialog(), openDialog(), openErrorDialog(), navigateTo(), openForm(), openTaskFlow(), openUrl(), openWebResource()
不支援的自訂 表單準備完成之前,不支援的用戶端 API 存取的詳細資料。 範例:
完全載入表單之前,請先存取 iFrame 中的 parent.Xrm.Page。
使用 Xrm.Page 在表單處理程序內容之外的表單 Web 資源中存取 window.setTimeout(),以定期呼叫表單用戶端 API。
在 Power Apps Control Framework 控制程式碼的 Xrm.Page 方法中存取 updateView()。

即時監視器支援的表單相關事件範例包括:

  • FormEvents.onsave
  • XrmNavigation
  • FormEvents.onload
  • FormControls
  • TabStateChange.visible
  • RelatedMenu
  • ControlStateChange.disabled
  • ControlStateChange.visible
  • SectionStateChange.visible
  • UnsupportedClientApi
  1. 在執行即時監視器的瀏覽器視窗中,選擇類別列,然後選擇篩選依據。
  2. 從下拉清單中選擇等於或包含,然後在方塊中輸入 CopilotEvent。 選取套用。

Copilot 控制項事件

Copilot 控制監視的事件包括以下內容。

事件名稱 描述
AdaptiveCardActionData 傳送資料以提交調適型卡片的動作
adaptiveCardContent 調適型卡片的內容
AISummarize 如果匯總功能關閉並記錄 fcb 狀態,則會記錄此訊息
AutoTriggerSummarizeHandler.isAutoTriggeredSummaryEnabled 告知是否啟用了自動觸發程序
ClientActionCalled 記錄用戶端動作的名稱和傳遞給它的酬載
CopilotResponse 副手的回應
DVCopilotAction isDVChatEnabled:是否為組織啟用 dv 聊天
DynamicContextSentToBot 傳送給機器人的動態內容
EnvironmentHostedBotSchemaName 記錄環境機器人結構描述名稱
ExecutingAction 調適型卡片動作正在執行
isSummaryEnabledForEntity 告知是否為實體啟用匯總
queryStructuredDataRequest 傳送請求以查詢結構資料
queryStructuredDataResponse 查詢結構資料的回應
SessionContextSentToBot 工作階段上下文傳送到機器人
SummarizeResponse 記錄摘要的回應
UserPrompt 使用者輸入的提示

關閉監視工作階段

若要關閉監視工作階段,請關閉正在播放受監視模型導向應用程式的瀏覽器標籤。

後續步驟

有關如何疑難排解模型驅動應用程式中表單問題,請參閱疑難排解模型導向應用程式中的表單問題。

了解即時監視器作為 Power Apps 工具