Trace 函式
適用於：
畫布應用程式 模型導向應用程式 Power Platform CLI
應用程式幕後通常會有許多邏輯在運作。 影響有時很明顯 (例如控制項的值或色彩變更)，確認邏輯在正確運作。 不過，有時並不明顯，可能很難具體呈現和了解應用程式中發生的情況。 使用 Trace 函式，可從幕後記錄診斷資訊，並建立實際發生情況的時間表，進一步了解應用程式的運作情形，以及協助對問題進行偵錯。
將 Trace 用於 Power Apps 時，其輸出會與其他應用程式活動一起出現在 Power Apps 監視器工具中。 如果您已允許應用程式將遙測資料傳送至 Azure Application Insights，則同樣可以使用 Trace 函式將資訊傳送至 Application Insights 資源。 Trace 只能在行為公式中使用。
與 Test Studio 搭配使用時，Trace 是選用運算式，可用來提供 OnTestCaseComplete 事件所傳回測試結果中的其他資訊。 追蹤事件訊息會與 TestCaseResult 記錄之 Traces 資料表中的已通過及失敗判斷提示訊息一起合併。 Traces 資料表有 Message 和 Timestamp 這兩個屬性。 測試中所使用的追蹤資訊也會記錄在 Application Insights 中。 從 Power Apps Studio 播放應用程式時，監視器會連接至應用程式，因此將無法在監視器工具中使用測試追蹤資訊。
語法
Trace( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )
- Message - 必要。 要追蹤的資訊。 數字、日期、布林值以及任何其他可強制轉型成文字的資料類型。
- TraceSeverity – 選用。 追蹤的嚴重性等級會記錄在監視器和 Application Insights 中。 選項有 TraceSeverity.Information (預設)、TraceSeverity.Warning、TraceSeverity.Error 或 TraceSeverity.Critical。
- CustomRecord – 選用。 包含要記錄在監視器或 Application Insights 中的自訂資料的記錄。
- TraceOptions – 選用。 選項有 TraceOptions.None (預設) 和 TraceOptions.IgnoreUnsupportedTypes (這會忽略 CustomRecord 中無法序列化的資料類型)。
範例
- 在 Power Apps Studio 中建立按鈕控制項。
- 將 OnSelect 公式設定為公式：
Set( x, x+1 );
Trace( x );
- 在另一個瀏覽器視窗中開啟 Power Apps 監視器，方法是選取左窗格中的 [進階工具] 圖示，然後選取 [開啟監視器]：
- 返回原始工作室瀏覽器視窗，並選取按鈕四次。 如果是在設計模式中，請使用滑鼠按住 Alt 鍵再按一下。
- 檢視 Power Apps 監視器。
- 監視器的網格會包含每個按鈕按一下的事件和每次呼叫 Trace 的事件，這將顯示變數在每次遞增後的值。 在右窗格中切入追蹤事件，以查看開始執行 Trace 的位置，以及用於訊息的運算式：
