Microsoft Dataverse

提供对 Power Platform 环境的Microsoft Dataverse作和触发器的访问权限。

此连接器在以下产品和地区提供:

Service 区域
Copilot Studio 高级 所有 Power Automate 区域
Power Apps 高级 所有 Power Apps 区域
Power Automate 高级 所有 Power Automate 区域
Contact
客户 Microsoft
URL https://make.powerautomate.com/en-us/support/
连接器元数据
发布服务器 Microsoft
网站 https://make.powerautomate.com/
隐私策略 https://privacy.microsoft.com
类别 数据​

创建连接

连接器支持以下身份验证类型:

客户端证书身份验证 使用 PFX 证书和密码提供Microsoft Entra ID凭据 所有区域 可共享
Oauth Oauth 所有区域 不可共享
服务主体 使用客户端 ID 和机密提供Microsoft Entra ID凭据 所有区域 可共享
默认值 [已弃用] 此选项仅适用于没有显式身份验证类型的较旧连接,并且仅用于向后兼容性。 所有区域 不可共享

客户端证书身份验证

身份验证 ID:CertOauth

适用:所有地区

使用 PFX 证书和密码提供Microsoft Entra ID凭据

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅画布应用的 Connectors 概述 - Power Apps |Microsoft Docs

客户 类型 Description 必选
租户 字符串 True
客户 ID 字符串 Microsoft Entra ID应用程序的客户端 ID True
客户端证书机密 clientCertificate 此应用程序允许的客户端证书机密 True

Oauth

身份验证 ID:Oauth

适用:所有地区

Oauth

这不是可共享的连接。 如果 Power App 与其他用户共享,系统将提示其他用户显式创建新连接。

服务主体

身份验证 ID:ServicePrincipalOauth

适用:所有地区

使用客户端 ID 和机密提供Microsoft Entra ID凭据

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅画布应用的 Connectors 概述 - Power Apps |Microsoft Docs

客户 类型 Description 必选
客户 ID 字符串 Microsoft Entra ID应用程序的客户端(或应用程序)ID。 True
客户端密码 securestring Microsoft Entra ID应用程序的客户端密码。 True
租户 字符串 Microsoft Entra ID应用程序的租户 ID。 True

默认值 [已弃用]

适用:所有地区

此选项仅适用于没有显式身份验证类型的较旧连接,并且仅用于向后兼容性。

这不是可共享的连接。 如果 Power App 与其他用户共享,系统将提示其他用户显式创建新连接。

限制

名称 调用 续订期
每个连接的 API 调用 6000 300 秒

操作

Microsoft Dataverse MCP 服务器(预览版)

提供对 Dataverse 的远程 MCP 服务器访问权限

Microsoft Dataverse MCP 服务器(预览版)(预览版)

通过预览工具提供对 Dataverse 的远程 MCP 服务器访问权限

上传文件或图像

此作允许将文件或图像内容上传到具有兼容列类型的Microsoft Dataverse表。 此连接器以前称为 Common Data Service (current environment)。

下载文件或图像

此作允许从Microsoft Dataverse表中下载文件或图像内容。 此连接器以前称为 Common Data Service (current environment)。

从所选环境中下载文件或图像

从环境中的行 Power Platform 中检索文件或图像数据。

从所选环境中删除行

从环境中的表 Power Platform 中删除一行。

从所选环境中通过 ID 获取行

从环境中的表中 Power Platform 获取一行。

关联行

此作允许将一个Microsoft Dataverse表中的行链接到另一个表(如果表具有一对多或多对多关系)。 此连接器以前称为 Common Data Service (current environment)。

列出所选环境中的行

列出环境中表中 Power Platform 的行。

列表行

此作允许列出与所选选项匹配的Microsoft Dataverse表中的行。 此连接器以前称为 Common Data Service (current environment)。

删除行

此作允许从Microsoft Dataverse表中删除行。 此连接器以前称为 Common Data Service (current environment)。

取消关联行

通过此作,如果表具有一对多或多对多关系,则可以删除一个Microsoft Dataverse表中的行与另一个表之间的链接。 此连接器以前称为 Common Data Service (current environment)。

向所选环境添加新行

在环境中的表中 Power Platform 创建新行。

在所选环境中关联行

在同一环境中关联具有一对多或多对多关系 Power Platform 的表中的各个行。

在所选环境中取消关联行

删除环境中各个行 Power Platform 之间的关联。

在所选环境中执行未绑定的操作

在 Dataverse 环境中运行全局 Power Platform 作,包括自定义作。

在所选环境中执行绑定的操作

Dataverse 运行绑定到环境中的表 Power Platform 的作,包括自定义作。

在所选环境中更新插入行

更新或添加(upsert)环境中表中的行 Power Platform 。

在所选环境中更新行

在 Power Platform 环境内的表中更新行。

将文件或图像上传到所选环境

更新环境中一行 Power Platform 中的文件或图像内容。

执行变更集请求

此作允许将一组Microsoft Dataverse连接器作作为单个事务执行。 如果其中一项操作失败,所有成功操作都将回滚。 此连接器以前称为 Common Data Service (current environment)。

执行后台操作(预览版)

此作允许使用未分类为函数的自定义 API 在后台执行Microsoft Dataverse作。 下拉菜单中列出的 API 列表仅是与此作兼容的 API。

执行未绑定操作

此作允许你执行环境中未与任何表关联的Microsoft Dataverse作。 此连接器以前称为 Common Data Service (current environment)。

执行绑定操作

此作允许你执行与所选表关联的Microsoft Dataverse作。 此连接器以前称为 Common Data Service (current environment)。

按 ID 获取行

此作允许获取与Microsoft Dataverse表中的 ID 匹配的行。 此连接器以前称为 Common Data Service (current environment)。

搜索行(预览版)

此作允许使用相关性搜索搜索Microsoft Dataverse环境,并返回与搜索词最匹配的行。 此连接器以前称为 Common Data Service (current environment)。

更新插入行

此作允许修改Microsoft Dataverse表中的任何选定行,或添加新行(如果不存在)。 此连接器以前称为 Common Data Service (current environment)。

更新行

此作允许修改Microsoft Dataverse表中的任何选定行。 此连接器以前称为 Common Data Service (current environment)。

添加新行

此作允许在所选Microsoft Dataverse表中添加新行。 此连接器以前称为 Common Data Service (current environment)。

Microsoft Dataverse MCP 服务器(预览版)

提供对 Dataverse 的远程 MCP 服务器访问权限

Microsoft Dataverse MCP 服务器(预览版)(预览版)

通过预览工具提供对 Dataverse 的远程 MCP 服务器访问权限

上传文件或图像

此作允许将文件或图像内容上传到具有兼容列类型的Microsoft Dataverse表。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

列名称
fileImageFieldName True string

选择列

内容
item True binary

添加文件或图像内容

内容名称
x-ms-file-name True string

输入文件或图像的名称

下载文件或图像

此作允许从Microsoft Dataverse表中下载文件或图像内容。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

列名称
fileImageFieldName True string

选择列

图像大小
size string

如果已启用,请为整个图像输入“完整”(默认 = 缩略图)

返回

文件或图像的内容

文件或图像内容
binary

从所选环境中下载文件或图像

从环境中的行 Power Platform 中检索文件或图像数据。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

列名称
fileImageFieldName True string

选择列

图像大小
size string

如果已启用,请为整个图像输入“完整”(默认 = 缩略图)

返回

文件或图像的内容

文件或图像内容
binary

从所选环境中删除行

从环境中的表 Power Platform 中删除一行。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

分区 ID
partitionId string

在删除NoSQL表的行时指定 partitionId 的选项

从所选环境中通过 ID 获取行

从环境中的表中 Power Platform 获取一行。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

Environment
organization True string

选择环境

提取敏感度标签
MSCRM.IncludeMipSensitivityLabel boolean

选择是否要提取敏感度标签 ID

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

选择列
$select string

输入以逗号分隔的列唯一名称列表以限制列出的列

展开查询
$expand string

输入 Odata 样式扩展查询以列出相关行

分区 ID
partitionId string

用于在检索NoSQL表的数据时指定 partitionId 的选项

返回

此操作输出是动态内容。

关联行

此作允许将一个Microsoft Dataverse表中的行链接到另一个表(如果表具有一对多或多对多关系)。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

关系
associationEntityRelationship True string

选择关系类型

关联
@odata.id True string

使用上一步中的 OData ID 或键入完整的 URL(例如。 https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

列出所选环境中的行

列出环境中表中 Power Platform 的行。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

Environment
organization True string

选择环境

提取敏感度标签
MSCRM.IncludeMipSensitivityLabel boolean

选择是否要提取敏感度标签 ID

表名
entityName True string

选择表

选择列
$select string

输入以逗号分隔的列唯一名称列表以限制列出的列

筛选行
$filter string

输入 OData 样式筛选表达式以限制列出的行

排序依据
$orderby string

OData orderBy 样式的排序依据列(不包括查找)

展开查询
$expand string

输入 Odata 样式扩展查询以列出相关行

Fetch Xml 查询
fetchXml string

输入 Fetch XML 查询以进行高级自定义

行计数
$top integer

输入要列出的行。 默认值为 2000。 在设置中为更多行启用分页。

跳过标记
$skiptoken string

输入从上一次运行获得的跳过标记以列出下一页中的行

分区 ID
partitionId string

用于在检索NoSQL表的数据时指定 partitionId 的选项

返回

此操作输出是动态内容。

列表行

此作允许列出与所选选项匹配的Microsoft Dataverse表中的行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

表名
entityName True string

选择表

选择列
$select string

输入以逗号分隔的列唯一名称列表以限制列出的列

筛选行
$filter string

输入 OData 样式筛选表达式以限制列出的行

排序依据
$orderby string

OData orderBy 样式的排序依据列(不包括查找)

展开查询
$expand string

输入 Odata 样式扩展查询以列出相关行

Fetch Xml 查询
fetchXml string

输入 Fetch XML 查询以进行高级自定义

行计数
$top integer

输入要列出的行数(默认 = 5000)

跳过标记
$skiptoken string

输入从上一次运行获得的跳过标记以列出下一页中的行

分区 ID
partitionId string

用于在检索NoSQL表的数据时指定 partitionId 的选项

返回

表列表

删除行

此作允许从Microsoft Dataverse表中删除行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

分区 ID
partitionId string

在删除NoSQL表的行时指定 partitionId 的选项

取消关联行

通过此作,如果表具有一对多或多对多关系,则可以删除一个Microsoft Dataverse表中的行与另一个表之间的链接。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

关系
associationEntityRelationship True string

选择关系类型

取消关联
$id True string

使用上一步中的 OData ID 或键入完整的 URL(例如。 https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

向所选环境添加新行

在环境中的表中 Power Platform 创建新行。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

Environment
organization True string

选择环境

表名
entityName True string

选择表

行项
item True dynamic

要创建的行

返回

此操作输出是动态内容。

在所选环境中关联行

在同一环境中关联具有一对多或多对多关系 Power Platform 的表中的各个行。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

关系
associationEntityRelationship True string

选择关系类型

关联
@odata.id True string

使用上一步中的 OData ID 或键入完整的 URL(例如。 https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

在所选环境中取消关联行

删除环境中各个行 Power Platform 之间的关联。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

关系
associationEntityRelationship True string

选择关系类型

取消关联
$id True string

使用上一步中的 OData ID 或键入完整的 URL(例如。 https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

在所选环境中执行未绑定的操作

在 Dataverse 环境中运行全局 Power Platform 作,包括自定义作。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

操作名称
actionName True string

选择操作

操作参数
item dynamic

操作参数

返回

此操作输出是动态内容。

在所选环境中执行绑定的操作

Dataverse 运行绑定到环境中的表 Power Platform 的作,包括自定义作。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

操作名称
actionName True string

选择操作

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

操作参数
item dynamic

操作参数

返回

此操作输出是动态内容。

在所选环境中更新插入行

更新或添加(upsert)环境中表中的行 Power Platform 。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

行项
item True dynamic

要更新的行

返回

此操作输出是动态内容。

在所选环境中更新行

在 Power Platform 环境内的表中更新行。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

行项
item True dynamic

要更新的行

返回

此操作输出是动态内容。

将文件或图像上传到所选环境

更新环境中一行 Power Platform 中的文件或图像内容。

参数

名称 密钥 必需 类型 说明
Environment
organization True string

选择环境

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

列名称
fileImageFieldName True string

选择列

内容
item True binary

添加文件或图像内容

内容名称
x-ms-file-name True string

输入文件或图像的名称

执行变更集请求

此作允许将一组Microsoft Dataverse连接器作作为单个事务执行。 如果其中一项操作失败,所有成功操作都将回滚。 此连接器以前称为 Common Data Service (current environment)。

执行后台操作(预览版)

此作允许使用未分类为函数的自定义 API 在后台执行Microsoft Dataverse作。 下拉菜单中列出的 API 列表仅是与此作兼容的 API。

参数

名称 密钥 必需 类型 说明
动态项
item True dynamic

动态项

目录
catalog True string

选择用于筛选表和操作的目录。

类别
category True string

选择用于筛选表和操作的类别。

操作名称
actionName True string

选择操作。

返回

包含后台操作状态代码和状态代码的操作响应对象。

执行未绑定操作

此作允许你执行环境中未与任何表关联的Microsoft Dataverse作。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
操作名称
actionName True string

选择操作

object

返回

响应
object

执行绑定操作

此作允许你执行与所选表关联的Microsoft Dataverse作。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
表名
entityName True string

选择表

操作名称
actionName True string

选择操作

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

object

返回

响应
object

按 ID 获取行

此作允许获取与Microsoft Dataverse表中的 ID 匹配的行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

选择列
$select string

输入以逗号分隔的列唯一名称列表以限制列出的列

展开查询
$expand string

输入 Odata 样式扩展查询以列出相关行

分区 ID
partitionId string

用于在检索NoSQL表的数据时指定 partitionId 的选项

返回

响应
object

搜索行(预览版)

此作允许使用相关性搜索搜索Microsoft Dataverse环境,并返回与搜索词最匹配的行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
搜索词
search True string

输入搜索词,例如。 Contoso. 布尔运算符、通配符、模糊搜索、邻近搜索等搜索修饰符需要搜索类型 full

搜索类型
searchtype string

输入是应当使用简单搜索语法还是完全搜索语法(默认为简单)

搜索模式
searchmode string

输入是必须与任何还是所有搜索词匹配(默认为任何)

行计数
top integer

输入要列出的搜索结果数(默认 = 50)

行筛选器
filter string

输入 Odata 样式筛选表达式以缩小搜索范围

表筛选器
entities array of string

输入要搜索的表的逗号分隔列表(默认为所有表)

排序依据
orderby array of string

输入以逗号分隔的列唯一名称(后跟 asc 或 desc)的列表

Facet 查询
facets array of string

输入用逗号分隔的 Facet 查询列表以缩小搜索范围

跳过行
skip integer

输入要跳过的搜索结果数

返回行计数
returntotalrecordcount boolean

选择选项

返回

搜索输出。

更新插入行

此作允许修改Microsoft Dataverse表中的任何选定行,或添加新行(如果不存在)。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

object

返回

响应
object

更新行

此作允许修改Microsoft Dataverse表中的任何选定行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

表名
entityName True string

选择表

行 ID
recordId True string

输入行的全局唯一标识符(GUID)

object

返回

响应
object

添加新行

此作允许在所选Microsoft Dataverse表中添加新行。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
返回完整元数据
x-ms-odata-metadata-full boolean

客户选择在响应中返回完整 odata 元数据的标头参数。

表名
entityName True string

选择表

object

返回

响应
object

触发器

执行操作时

完成Microsoft Dataverse作时触发。

添加、修改或删除行时

此触发器允许在Microsoft Dataverse表中添加、修改或删除行时启动流,使其与所选选项匹配。 此连接器以前称为 Common Data Service (current environment)。

执行操作时

完成Microsoft Dataverse作时触发。

参数

名称 密钥 必需 类型 说明
目录
catalog True string

选择用于筛选表和操作的选项。

类别
category True string

选择用于筛选表和操作的选项。

表名
entityname True string

选择表以筛选操作。

操作名称
sdkmessagename True string

选择操作。

返回

操作和表项。

添加、修改或删除行时

此触发器允许在Microsoft Dataverse表中添加、修改或删除行时启动流,使其与所选选项匹配。 此连接器以前称为 Common Data Service (current environment)。

参数

名称 密钥 必需 类型 说明
更改类型
message True integer

选择流触发时间

表名
entityname True string

选择表

Scope
scope True integer

选择范围以限制可以触发流的行

选择列
filteringattributes string

输入以逗号分隔的列唯一名称列表。 流在更新有效负载中存在任何列时触发,而不考虑是否修改数据

筛选行
filterexpression string

用于限制可以触发流的行的 Odata 表达式,例如 statecode eq 0

延迟截止时间
postponeuntil string

输入用于延迟触发评估的时间,例如 2020-01-01T10:10:00Z

运行方式
runas integer

选择在其中使用调用程序连接的步骤的运行用户

返回

表项。

定义

实体项目列表

表列表

名称 路径 类型 说明
value
value array of EntityItem

项列表

下一个链接
@odata.nextLink string

用于提取下一页数据的 URL。

实体项

表项

名称 路径 类型 说明
dynamicProperties(动态属性)
dynamicProperties object

Object

WebhookNotificationContent

表项。

名称 路径 类型 说明
架构
schema Object

搜索输出

搜索输出。

名称 路径 类型 说明
行列表
value array of object

行列表

行搜索分数
value.@search.score number

行的搜索分数

行表名称
value.@search.entityname string

包含此行的表

行对象 ID
value.@search.objectid string

行的 Objectid

行对象类型代码
value.@search.objecttypecode integer

行的 Objecttypecode

总行数
totalrecordcount integer

结果总数(如果 returntotalrecordcount 设置为 false,则为 -1)

WebhookNotificationContentForWhenAnActionIsPerformed

操作和表项。

名称 路径 类型 说明
架构
schema Object

WebhookNotificationContentForPerformBackgroundOperation

包含后台操作状态代码和状态代码的操作响应对象。

名称 路径 类型 说明
架构
schema Object

对象

这是 'object' 类型。

二进制

这是基本数据类型 'binary'。