共用方式為

Microsoft Dataverse [已棄用]

提供對環境資料庫的訪問 Microsoft Dataverse。

此連接器在以下產品和地區提供：

Service 類別 地區
副駕駛工作室 進階 全部 Power Automate
邏輯應用 標準 所有 Logic Apps 區域
Power Apps - 無法使用
Power Automate（自動化服務） 進階 全部 Power Automate
連絡人​​
姓名 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
連接器元數據
發行者 Microsoft
網站 https://powerapps.microsoft.com/common-data-service/

注意

Microsoft Dataverse （舊版）連接器將受 Microsoft 支援，直到該 Microsoft Dataverse 連接器 支援邏輯應用。

要使用此連接器， Power Apps請瞭解更多關於如何使用 此連接器的資訊 Power Apps。

已知問題與限制

  1. 有時，CDS 觸發器在管理模式設置為 「on」 的 Production 環境中不起作用。 如果您遇到此問題，解決方法是在Power Platforms Admin Center 中關閉管理員模式。
  2. 如果為使用的環境（沙盒或生產）啟用了管理模式， Power Automate 則在修改記錄時，不會觸發具有 When a record is modified 觸發器的流。 有關如何設置管理模式的更多詳細資訊，請參閱 此頁面。
  3. 當您在流程中使用「選擇記錄時」觸發器，並在其後有一個 If 條件步驟時，如果條件中的屬性具有 null 值，您將收到錯誤。 您將看到的錯誤訊息是 “'Invalid type. 預期的 String 但得到 Null。 建議的解決方法是在「當選擇記錄時」和「If 條件」步驟之間插入「獲取行」作。 通過在條件中使用 「Get Row」作的輸出，您將能夠避免此錯誤。

Power Apps 資料類型對應

Power Apps Microsoft Dataverse (舊版)
選擇 選項，是/否
日期時間 日期時間，日期與時間，只有日期
影像 影像
號碼 浮點數，貨幣，小數，期間，語言，時區，整數
文字 電子郵件，多行文字，電話，文字，文字區域，股票看板代號，URL
GUID 唯一識別碼

Dataverse 的 Power Apps 可委派函數和作業

對於指定的資料類型，這些 Power Apps 作業可能會委派給 Dataverse 處理 (而不是在 Power Apps 中進行本機處理)。

Item 數 [1] 發簡訊 [2] 選擇 日期時間 [3] GUID
篩選器 .是 .是 .是 .是 .是
分類 .是 .是 否 .是 -
SortByColumns .是 .是 否 .是 -
查閱 .是 .是 .是 .是 .是
=、<> .是 .是 .是 .是 .是
<， <=， >， >= .是 .是 否 .是 -
和/或/不是 .是 .是 .是 .是 .是
StartsWith - .是 - - -
IsBlank 是 [4] 是 [4] 否 [4] 是 [4] .是
加總，最小，最大，平均 是 [5] - - 否 -
  1. 帶有算術表達式的數值（例如，Filter（table， field + 10 > 100） ）是不可委派的。 語言和時區不可委派。
  2. 不支援 Trim[Ends] 或 Len。 支援其他函數，例如 Left、Mid、Right、Upper、Lower、Replace、Replace、Substitute等等。
  3. 除了日期時間函數 Now() 和 Today() 之外，日期時間通常是可委派的。
  4. 支援比較。 例如 Filter(TableName, MyCol = Blank())。
  5. 彙總函式僅限於 50,000 個資料列的集合。 如果需要，請使用 Filter 函式，從一個大型集合選取 50,000 個資料列，然後再使用彙總函式。

注意

只有使用新版本的連接器，才支援 Dataverse 的選項、GUID 和彙總函數。 根據您使用的 Power Apps 版本，使用標題為以下名稱的「預覽」參數啟用此連接器：

  • 關係數據、選擇項和其他新功能 Dataverse
    或此實驗性參數：
  • Dataverse 使用連接器
    要查找這些開關，請打開 File （檔案） 選單，然後選擇App settings （應用程式設置 ） 高級設置>。

連接器深度

有關連接器的更多資訊，請參閱 深入部分。

創建連接

連接器支援以下身份驗證類型：
用戶端憑證驗證 使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證 所有地區 可共用
奧特 奧特 所有地區 可共用
服務主體 使用用戶端識別碼和秘密提供 Microsoft Entra ID 認證 所有地區 可共用
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 所有地區 不可共用

用戶端憑證驗證

驗證 ID：CertOauth

適用：所有地區

使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

姓名 類型 Description 為必填項目
租戶 字串 對
用戶端識別碼 字串 Microsoft Entra ID 應用程式的用戶端識別碼 對
用戶端憑證密碼 客戶憑證 此應用程式允許的用戶端憑證密碼 對

奧特

驗證 ID：Oauth

適用：所有地區

奧特

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

服務主體

驗證識別碼：ServicePrincipalOauth

適用：所有地區

使用用戶端識別碼和秘密提供 Microsoft Entra ID 認證

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

姓名 類型 Description 為必填項目
用戶端識別碼 字串 Microsoft Entra ID 應用程式的用戶端 （或應用程式） 識別碼。 對
用戶端密碼 securestring Microsoft Entra ID 應用程式的用戶端密碼。 對
租戶 字串 Microsoft Entra ID 應用程式的租用戶識別碼。 對

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

這不是可共享的連接。 如果 Power App 與其他使用者共享，系統將提示其他使用者顯式創建新連接。

節流限制

名稱 呼叫 續約期間
每個連接的 API 呼叫 1000 60 秒鐘

動作

列出行 [已棄用]

此作業會取得表格的列
刪除行（舊版）[已棄用]

此作業會從表格集合刪除列
從表中獲取一行 [已棄用]

從表格中取得列
新增行 [已棄用]

此作業會新增資料表的新資料列
更新行 [已棄用]

此作業會更新表格現有的列
更新行（舊版）[已棄用]

此作業會更新表格現有的列
添加新行（舊版）[已棄用]

此作業會新增資料表的新資料列
清單行（舊版）[已棄用]

此作業會取得表格的列
獲取行（舊版）[已棄用]

此作業會擷取表格的指定列

列出行 [已棄用]

作業識別碼：
GetItems

此作業會取得表格的列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
篩選器查詢
 $filter string

ODATA 篩選查詢可限制傳回的項目 (例如 stringColumn eq 'string' OR numberColumn lt 123)。
排序方式
 $orderby string

ODATA orderBy 查詢可指定項目的順序。
最高計數
 $top integer

要擷取的總項目數 (預設 = 全部)。
擴展查詢
 $expand string

要包含在要求項目的相關項目 (預設 = 無)

傳回

此作業會輸出隨機的結果。

刪除行（舊版）[已棄用]

作業識別碼：
DeleteItem

此作業會從表格集合刪除列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
項標識碼
 id True string

列的識別碼

從表中獲取一行 [已棄用]

作業識別碼：
GetItem

從表格中取得列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
項標識碼
 id True string

列的識別碼

傳回

此作業會輸出隨機的結果。

新增行 [已棄用]

作業識別碼：
PostItem

此作業會新增資料表的新資料列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
資料列項目
 item True dynamic

要建立的資料列

傳回

此作業會輸出隨機的結果。

更新行 [已棄用]

作業識別碼：
PatchItem

此作業會更新表格現有的列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
列識別碼
 id True string

列的識別碼
資料列項目
 item True dynamic

要更新的資料列

傳回

此作業會輸出隨機的結果。

更新行（舊版）[已棄用]

作業識別碼：
PatchItem_V2

此作業會更新表格現有的列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
列識別碼
 id True string

列的識別碼
資料列項目
 item True dynamic

要更新的資料列

傳回

此作業會輸出隨機的結果。

添加新行（舊版）[已棄用]

作業識別碼：
PostItem_V2

此作業會新增資料表的新資料列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
資料列項目
 item True dynamic

要建立的資料列

傳回

此作業會輸出隨機的結果。

清單行（舊版）[已棄用]

作業識別碼：
GetItems_V2

此作業會取得表格的列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
彙總轉換
 $apply string

OData 彙總轉換的順序
篩選器查詢
 $filter string

ODATA 篩選查詢可限制傳回的項目 (例如 stringColumn eq 'string' OR numberColumn lt 123)。
排序方式
 $orderby string

ODATA orderBy 查詢可指定項目的順序。
最高計數
 $top integer

要擷取的總項目數 (預設 = 全部)。
擴展查詢
 $expand string

要包含在要求項目的相關項目 (預設 = 無)

傳回

此作業會輸出隨機的結果。

獲取行（舊版）[已棄用]

作業識別碼：
GetItem_V2

此作業會擷取表格的指定列

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格
項標識碼
 id True string

列的識別碼

傳回

此作業會輸出隨機的結果。

觸發程序

修改行時 [DEPRECATED]

在修改 Dataverse行時觸發流。
修改行時 （僅限管理員） [已棄用]

修改行時觸發流 Dataverse
修改行時 （僅限管理員） [已棄用]

修改行時觸發流 Dataverse
刪除行時 [DEPRECATED]

在刪除 Dataverse行時觸發流。
刪除行時（僅限管理員）[已棄用]

在中刪除行時觸發流 Dataverse
新增行時 [已棄用]

在添加 Dataverse行時觸發流。
添加行時（僅限管理員）[已棄用]

在添加行時觸發流 Dataverse
添加行時（僅限管理員）[已棄用]

在添加行時觸發流 Dataverse
選取資料列時

當從命令列中的 [流程] 功能表選取資料列時觸發流程。 （僅適用於 Power Automate。

修改行時 [DEPRECATED]

作業識別碼：
SubscribeOnUpdatedItems

在修改 Dataverse行時觸發流。

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境。
資料表名稱
 table True string

選取資料表。
Scope
 scope True string

範圍。
欄篩選
 AttributeFilters array of string

資料行篩選

傳回

此作業會輸出隨機的結果。

修改行時 （僅限管理員） [已棄用]

作業識別碼：
GetOnUpdatedItems_V2

修改行時觸發流 Dataverse

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格

傳回

此作業會輸出隨機的結果。

修改行時 （僅限管理員） [已棄用]

作業識別碼：
GetOnUpdatedItems

修改行時觸發流 Dataverse

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格

傳回

此作業會輸出隨機的結果。

刪除行時 [DEPRECATED]

作業識別碼：
SubscribeOnDeletedItems

在刪除 Dataverse行時觸發流。

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境。
資料表名稱
 table True string

選取資料表。
Scope
 scope True string

範圍。

傳回

此作業會輸出隨機的結果。

刪除行時（僅限管理員）[已棄用]

作業識別碼：
GetOnDeletedItems

在中刪除行時觸發流 Dataverse

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格

傳回

此作業會輸出隨機的結果。

新增行時 [已棄用]

作業識別碼：
SubscribeOnNewItems

在添加 Dataverse行時觸發流。

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境。
資料表名稱
 table True string

選取資料表。
Scope
 scope True string

範圍。

傳回

此作業會輸出隨機的結果。

添加行時（僅限管理員）[已棄用]

作業識別碼：
GetOnNewItems

在添加行時觸發流 Dataverse

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格

傳回

此作業會輸出隨機的結果。

添加行時（僅限管理員）[已棄用]

作業識別碼：
GetOnNewItems_V2

在添加行時觸發流 Dataverse

參數

名稱 機碼 必要 類型 Description
Environment
 dataset True string

選取環境
資料表名稱
 table True string

選取表格

傳回

此作業會輸出隨機的結果。

選取資料列時

作業識別碼：
OnItemSelected

當從命令列中的 [流程] 功能表選取資料列時觸發流程。 （僅適用於 Power Automate。

參數

名稱 機碼 必要 類型 Description
operationId
 operationId True string
主持人
 host object
參數
 parameters True object
結構描述
 schema True object
headers架構
 headersSchema object

傳回

名稱 路徑 類型 Description
資料列
 body.rows array of object
項目
 body.rows object
使用者識別碼
 headers.x-ms-user-id-encoded guid

在 AAD 中觸發流程之使用者的唯一識別碼。
使用者電子郵件
 headers.x-ms-user-email-encoded byte

觸發流程之使用者的電子郵件地址。
使用者名
 headers.x-ms-user-name-encoded byte

觸發流程之使用者的顯示名稱。
TimeStamp
 headers.x-ms-user-timestamp string

觸發流程的時間。