桌面流程動作記錄設定
此頁提供桌面流程記錄的設定指南，該記錄位於 Power Platform 系統管理中心的環境功能區段下。
重要
- 此功能僅適用於從雲端流程啟動的桌面流程，尚不適用於從 Power Automate 電腦版進行本機有人參與的運作。
執行動作記錄的啟用狀態設定定義何時應擷取桌面流程執行動作記錄，甚至可讓您將其完全關閉。
| 啟用狀態 | 描述 |
|---|---|
| 已啟用 (預設) | 對於照常擷取記錄的現有環境和新環境，此選項是預設選項。 |
| 執行失敗時 | 此選項僅在出現執行階段錯誤時擷取桌面流程動作記錄。 這代表記錄並非每次執行都可用，而僅在發生錯誤時才可用。 但是，如果確實發生錯誤，則該特定執行的所有記錄都可用，包括成功和失敗的動作。 |
| 停用 | 此選項可有效地完全停用桌面流程執行動作記錄。 |
注意
變更其中任何設定都可能對執行失敗疑難排解和稽核等功能產生重大影響。 在繼續操作之前，請考慮變更這些設定所帶來的影響。
必要條件
設定桌面流程動作記錄版本
動作記錄版本可讓您選擇 V1、V2 或兩者皆選。
| 記錄版本 | 說明 |
|---|---|
| V1 - 儲存在 FlowSession 實體的 AdditionalContext 欄位中 | 這是預設選項。 記錄儲存在流程工作階段資料表的 AdditionalContext 欄位中，該表是在 Microsoft Dataverse 中以 Blob 形式儲存的檔案屬性。 記錄 V1 耗用 Dataverse 檔案容量。 |
| V2 - 儲存在 FlowLogs 實體中 | 此選項可讓您將記錄儲存在流程記錄資料表中，該表儲存在彈性資料表中。 記錄 V2 耗用 Dataverse 資料庫容量。 |
| 兩者 | 此設定可讓將記錄儲存在「流程工作階段」資料表和「流程記錄」資料表的傳統 AdditionalContext 欄位中。 此功能會耗用 Dataverse 檔案和資料庫容量。 此設定用於偵錯或測試目的，因為它會耗用 Dataverse 資料庫和檔案容量。 |
FlowLogs 實體的存續時間 (以分鐘為單位) 值決定動作記錄應在流程記錄彈性資料表中保留多久。 Dataverse 會自動刪除早於指定時間範圍的記錄。 為了方便您使用，以下是一些範例值。
| 天 | 分鐘 |
|---|---|
| 一天 | 1,440 分鐘 |
| 三天 | 4,320 分鐘 |
| 七天 | 10,080 分鐘 |
| 14 天 | 20,160 分鐘 |
| 28 天 | 40,320 分鐘 |
| 60 天 | 86,400 分鐘 |
| 90 天 | 129,600 分鐘 |
| 180 天 | 259,200 分鐘 |
| 365 天 | 525,600 分鐘 |
| 永久 | 小於或等於 0 (零) 分鐘 |
注意
在啟用記錄 V2 之前，請確保您有足夠的 Dataverse 資料庫容量來支援資料保留設定，並符合您的容量規劃、權利，並根據需要進行調整。 有關一些大小調整範例，請參閱下方的記錄 V2 的 Dataverse 容量需求計算範例區段。
桌面流程記錄 V1 和 V2 的主要區別
下表描述了桌面流程記錄 V1 和 V2 之間的差異：
| 功能 | 記錄 V1 | 記錄 V2 | 描述 |
|---|---|---|---|
| 自動資料保留 | 無法使用 | 可提供服務 | V2 使用彈性資料表，該表由 Azure Cosmos DB 提供支援，並具有用於自動資料保留的內建存留時間功能。 |
| 支援較大的記錄大小 | 大約最多 50,000 到 80,000 個動作記錄 (最多) | 大約是 V1 動作記錄 (最初) 數量的兩倍 | 理論上，V2 將來每次執行最多可以擴展到十億位元組的動作記錄，而 V1 只能擴展到此資料表中指定的量。 |
| 支援建立報告和治理 | 無法使用 | 可提供服務 | 在 V1 中，AdditionalContext 屬性是一種檔案類型，在 Dataverse 中儲存為 Blob，這使得解析報告和治理控制變得具有挑戰性。 V2 中的記錄更容易存取。 |
| 支援 Azure Synapse Link for Dataverse 整合 | 無法使用 | 可提供服務 | 在 V1 中，AdditionalContext 屬性是一種檔案類型，在 Dataverse 中儲存為 Blob，不支援同步到 Azure Synapse。 |
| 支援 Dataverse 稽核功能 | 無法使用 | 可提供服務 | 在 V1 中，AdditionalContext 屬性是一種檔案類型，在 Dataverse 中儲存為 Blob，但在 Dataverse 稽核功能中不支援。 |
| 支援 Dataverse 長期保留 | 無法使用 | 計劃 | 在 V1 中，AdditionalContext 屬性是一種檔案類型，在 Dataverse 中儲存為 Blob，但在 Dataverse 長期保留中不支援。 |
| 根據 Dataverse 角色型存取控制 (RBAC) | 可提供服務 | 可提供服務 | 兩個版本都使用 Dataverse RBAC，從其上層流程工作階段記錄繼承動作記錄權限。 |
與先前的版本 V1 相比，記錄 V2 提供了大幅增強的功能。 V2 使用彈性資料表功能，該功能非常適合處理大量資料 (如動作記錄場景)，並內建資料保留 (TTL)。 非常適合需要存取大量資料以進行報告、治理和與自動資料保留控制整合的組織。
記錄 V2 的 Dataverse 容量需求計算
下表顯示了使用記錄 V2 時，每個桌面流程執行的 Dataverse 資料庫儲存耗用的估算範例。 它概述了不同數量動作的大致儲存需求，假設每個動作平均有 3 KB 的儲存空間。
| 動作數目 | 每個動作的儲存需求 (KB) | 總儲存耗用量 (MB) |
|---|---|---|
| 1,000 | 3 | 2.93 |
| 10,000 | 3 | 29.3 |
| 30,000 | 3 | 87.9 |
| 60,000 | 3 | 175.8 |
| 100,000 | 3 | 293 |
| 160,000 | 3 | 480 |
重要
上表中顯示的數字只是估計值，實際儲存耗用量可能會有很大差異。 確切的儲存需求將取決於每個動作記錄的具體細節和複雜性。 因此，應將這些數字當做瞭解潛在儲存需求，並據此規劃儲存需求的初步指南。
查詢記錄 V2 資料
可以透過使用傳統 API 呼叫語法或使用新的 ExecuteCosmosSqlQuery 方法，對 Dataverse 後端進行 API 呼叫來存取桌面流程動作記錄資料 此方法可讓您對 Dataverse 執行 SQL 查詢，從而擷取和篩選資料。
記錄 V2 的資料模型基於流程工作階段和流程記錄資料表之間的上下層關係。 每則記錄都會從其上層流程工作階段記錄繼承權限。 若要查詢特定桌面流程執行的動作記錄，您可以使用以下查詢語法。
傳統 Dataverse API 呼叫語法
以下 API 呼叫會根據其識別碼 (9d51aa1f-315e-43ab-894f-bc445dfb049b) 擷取特定流程工作階段，然後使用 flowsession_flowlog_parentobjectid 關係存取關聯的動作記錄。
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
使用 FlowLogs 資料表的新 ExecuteCosmosSqlQuery API 呼叫語法
[Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
@p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
@p2: 'flowlog'
@p3: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
@p4: 50
詳細瞭解如何查詢彈性資料表中的 JSON 資料行。
將呼叫分解為單別部分
- 基本 URL (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) 是 Dataverse Web API 的端點。
- ExecuteCosmosSqlQuery 是呼叫的方法。 此方法可對 Dataverse 執行 SQL 查詢。
- ExecuteCosmosSqlQuery 方法的參數在方法名稱後面的括弧中提供：
QueryText=@p1：要執行的 SQL 查詢。 在本例中，查詢從類型為 100000001 (桌面流程動作記錄類型) 的資料表中選擇各種屬性，並根據 startTime 屬性按降序對結果進行排序。EntityLogicalName=@p2：此區段儲存動作記錄的資料表 (flowlog) 的邏輯名稱。QueryParameters=@p3：此區段是指定查詢參數的 JSON 物件。 在前面的範例中，它指定了一個索引鍵/值組，其中索引鍵為@referencingParentId和@referencingParentLogicalName，值為flowsessionid(GUID) 和資料表flowsession類型。PageSize=p4：此區段是查詢頁面大小。
已知限制
- 記錄 V2 僅適用於透過桌面流程連接器動作從雲端流程啟動的桌面流程執行。
- 流程記錄表目前不支援批次刪除作業。
- 尚無法在 Maker Portal (make.powerapps.com) 的表格部分中查看流程記錄。
- 變更動作記錄版本不會將先前的桌面流程動作記錄移轉到新的記錄儲存類型。