使用 Live Monitor 對模型驅動應用行為進行故障排除
Live Monitor 是一種工具,可以説明應用程式製作者調試和診斷問題,從而説明他們構建更快、更可靠的應用程式。 Live Monitor 透過提供應用程式運行時所有活動的日誌,提供應用程式運行方式的深入視圖。
為了協助您隔離某些模型導向應用程式功能,您可以依照特定類別進行篩選,例如表單或 Copilot 控制項。
創建即時監控器會話
登入 Power Apps,在左側導覽窗格中選擇解決方案,打開包含要監視的應用程式的解決方案,選擇該應用程式,然後在命令列上選擇即時監視。
在即時監視器頁面上,選擇 命令欄上的播放模型驅動 應用。 有關創建實時監控器會話的更多資訊,請轉到 使用即時監控器對模型驅動應用中的頁面行為進行故障排除。
篩選 Live monitor 以查找表單相關問題
在即時監控器中篩選模型驅動應用表單相關事件可以在應用運行時提供有關實時監控器中表單上的相關表、表、控件和元件的資訊。
在許多情況下,Live Monitor 可以幫助製作者瞭解表單為何以某種方式運行。 許多表單問題是根據系統管理員和決策者所設定的商務規則、JavaScript、表單事件或用戶端 API 而定。 實時監視器還可以幫助確定遇到的問題是現成的,還是由於自定義造成的。 它提供了有助於回答以下問題的詳細資料:
- 為何資料列無法在資料表的相關功能表中顯示?
- 為何控制項為停用/啟用或顯示/隱藏
- 為何資料列處於唯讀狀態?
在運行實時監控器的瀏覽器視窗上,選擇 Category 列,然後選擇 Filter by。
從下拉清單中選擇等於或包含,然後在方塊中輸入
formchecker
。 選取套用。現在類別已經過篩選。 選取並按住資料行的右側,然後向右拖曳,作業資料行即可展開,以查看所追蹤事件的全名。 當您使用應用程式並打開和使用表單時,Live Monitor 會更新事件清單。
當應用程式在受監視的工作階段中執行時,在模型導向應用程式中執行與應用程式的正常使用一致的動作。 例如,使用資料表表單打開及變更資料。
使用 Live Monitor 瞭解表單行為
對於具有實時監控器的每一行,可以查看有關表單事件的詳細資訊。 例如,假設您對表單中發生的錯誤有疑問。 您可以在應用程式中移至該表單,並選取適當的表單元件。 然後返回到啟用了 Live Monitor 的瀏覽器,並查看結果 (無論是否進行篩選)。 在此案例中,複合控制項上有一個錯誤。 透過展開詳細資料的區域,您就可以深入了解事件本身。
受監視的事件種類很多,包括標準表單事件 (例如,onload
、onsave
和 onclose
)。
當您繼續使用正在監控的應用程式時,Live Monitor 會更新事件清單中的資訊。 對於表單,有許多不同的案例可以疑難排解,並在目前正在處理的表單、控制項或表格上尋找其他資訊。
資料表檢查區域和活動
表單監視的領域包括以下內容。
應用程式區域 | 描述 |
---|---|
控制項狀態 | 載入表單時,控制項可見、已啟用及標籤來源狀態的詳細資料。 |
相關功能表 | 相關功能表項目狀態的詳細資料。 範例: 為何無法顯示功能表項目? 功能表項目從何而來? |
索引標籤/區段/控制項狀態變更 | 關於誰 (透過呼叫堆疊) 導致表單元件 (如索引標籤、區段或控制項) 變更元件的可見度與已啟用狀態的詳細資料。 |
瀏覽 | 通過追蹤以下 Xrm.Navigation 用戶端 API 方法的呼叫堆疊來詳細說明造成導覽或意外對話方塊的原因:openAlertDialog(), openConfirmDialog(), openDialog(), openErrorDialog(), navigateTo(), openForm(), openTaskFlow(), openUrl(), openWebResource() |
不支援的自訂 | 表單準備完成之前,不支援的用戶端 API 存取的詳細資料。 範例: 完全載入表單之前,請先存取 iFrame 中的 parent.Xrm.Page 。 使用 window.setTimeout() 在表單處理程序內容之外的表單 Web 資源中存取 Xrm.Page ,以定期呼叫表單用戶端 API。 在 Power Apps Control Framework 控制程式碼的 updateView() 方法中存取 Xrm.Page 。 |
Live Monitor 中支持的表單相關事件示例包括:
- FormEvents.onsave
- XrmNavigation
- FormEvents.onload
- FormControls
- TabStateChange.visible
- RelatedMenu
- ControlStateChange.disabled
- ControlStateChange.visible
- SectionStateChange.visible
- UnsupportedClientApi
篩選 Live Monitor 中與 Copilot 控件相關的問題
- 在運行實時監控器的瀏覽器視窗上,選擇 Category 列,然後選擇 Filter by。
- 從下拉清單中選擇等於或包含,然後在方塊中輸入
CopilotEvent
。 選取套用。
Copilot 控制項事件
Copilot 控制監視的事件包括以下內容。
事件名稱 | 描述 |
---|---|
AdaptiveCardActionData | 傳送資料以提交調適型卡片的動作 |
adaptiveCardContent | 調適型卡片的內容 |
AISummarize | 如果匯總功能關閉並記錄 fcb 狀態,則會記錄此訊息 |
AutoTriggerSummarizeHandler.isAutoTriggeredSummaryEnabled | 告知是否啟用了自動觸發程序 |
ClientActionCalled | 記錄用戶端動作的名稱和傳遞給它的酬載 |
CopilotResponse | 副手的回應 |
DVCopilotAction | isDVChatEnabled:是否為組織啟用 dv 聊天 |
DynamicContextSentToBot | 傳送給機器人的動態內容 |
EnvironmentHostedBotSchemaName | 記錄環境機器人結構描述名稱 |
ExecutingAction | 調適型卡片動作正在執行 |
isSummaryEnabledForEntity | 告知是否為實體啟用匯總 |
queryStructuredDataRequest | 傳送請求以查詢結構資料 |
queryStructuredDataResponse | 查詢結構資料的回應 |
SessionContextSentToBot | 工作階段上下文傳送到機器人 |
SummarizeResponse | 記錄摘要的回應 |
UserPrompt | 使用者輸入的提示 |
關閉監視工作階段
若要關閉監視工作階段,請關閉正在播放受監視模型導向應用程式的瀏覽器標籤。
後續步驟
有關如何疑難排解模型驅動應用程式中表單問題,請參閱疑難排解模型導向應用程式中的表單問題。