Microsoft Dataverse

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

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

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

创建连接

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

违约 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有地区

用于创建连接的参数。

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

限制

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

操作

上传文件或图像

此作允许您将文件或图像内容 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)。

执行后台操作(预览版)

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

执行未绑定操作

此作允许您执行 Microsoft Dataverse 环境中可用的作,这些作不与任何表关联。 此连接器以前称为 Common Data Service (current environment)。

执行绑定操作

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

按 ID 获取行

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

搜索行(预览版)

此作允许您使用 Relevance Search 搜索 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 上传到具有兼容列类型的表。 此连接器以前称为 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 获取一行。

参数

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

选择环境

表名
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 的行。

参数

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

选择环境

表名
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

选择表

选择列
$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)。

参数

名称 密钥 必需 类型 说明
表名
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 创建新行。

参数

名称 密钥 必需 类型 说明
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 。

参数

名称 密钥 必需 类型 说明
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)

行项
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)。

执行后台操作(预览版)

此作 Power Automate 允许您使用未归类为函数的自定义 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 获取行

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

参数

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

选择表

行 ID
recordId True string

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

选择列
$select string

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

展开查询
$expand string

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

分区 ID
partitionId string

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

返回

响应
object

搜索行(预览版)

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

参数

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

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

搜索类型
searchtype string

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

Search mode
searchmode string

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

行计数
top integer

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

行筛选器
filter string

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

表筛选器
entities array of string

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

Sort by
orderby array of string

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

Facet 查询
facets array of string

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

跳过行
skip integer

输入要跳过的搜索结果数

返回行计数
returntotalrecordcount boolean

选择选项

返回

搜索输出。

更新插入行

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

参数

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

选择表

行 ID
recordId True string

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

object

返回

响应
object

更新行

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

参数

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

选择表

行 ID
recordId True string

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

object

返回

响应
object

添加新行

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

参数

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

选择表

object

返回

响应
object

触发器

从业务流程流运行流步骤时

此触发器允许您在单击业务流程流步骤中的“运行流”按钮时启动流。 (仅适用于 Power Automate。

在选择行时

从命令栏内的“流”菜单中选择行后触发流。 (仅适用于 Power Automate。

执行操作时

在作完成时 Microsoft Dataverse 触发。

添加、修改或删除行时

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

从业务流程流运行流步骤时

此触发器允许您在单击业务流程流步骤中的“运行流”按钮时启动流。 (仅适用于 Power Automate。

参数

名称 密钥 必需 类型 说明
operationId
operationId string
主持人
host object
架构
schema True object

返回

名称 路径 类型 说明
流工作流日志 ID
entity.FlowsWorkflowLogId string

流工作流日志 ID。

BPF 实例 ID
entity.BPFInstanceId string

业务流程流实例 ID。

BPF 实例表名称
entity.BPFInstanceEntityName string

业务流程流实例表名称。

BPF 定义 ID
entity.BPFDefinitionId string

业务流程流定义 ID。

BPF 定义表名称
entity.BPFDefinitionEntityName string

业务流程流定义表名称。

步骤 ID
entity.StepId string

业务流程流步骤 ID。

BPF 定义名称
entity.BPFDefinitionName string

业务流程流定义名称。

BPF 实例名称
entity.BPFInstanceName string

业务流程流实例名称。

BPF 流阶段本地化名称
entity.BPFFlowStageLocalizedName string

业务流程流阶段本地化名称。

BPF 流阶段表名称
entity.BPFFlowStageEntityName string

业务流程流阶段表名称。

BPF 流阶段表集合名称
entity.BPFFlowStageEntityCollectionName string

业务流程流阶段表集合名称。

BPF 流阶段表行 ID
entity.BPFFlowStageEntityRecordId string

业务流程流阶段表行 ID。

BPF 活动阶段 ID
entity.BPFActiveStageId string

业务流程流活动阶段 ID。

BPF 可用阶段表名称
entity.BPFActiveStageEntityName string

业务流程流可用阶段表名称。

BPF 活动阶段本地化名称
entity.BPFActiveStageLocalizedName string

业务流程流活动阶段本地化名称。

在选择行时

从命令栏内的“流”菜单中选择行后触发流。 (仅适用于 Power Automate。

参数

名称 密钥 必需 类型 说明
operationId
operationId True string
主持人
host object
参数
parameters True object
架构
schema True object
Headers 架构
headersSchema object

返回

名称 路径 类型 说明
body.rows array of object
body.rows object
用户 ID
headers.x-ms-user-id-encoded guid

在 AAD 中触发流的用户的唯一标识符。

用户电子邮件
headers.x-ms-user-email-encoded byte

触发流的用户的电子邮件地址。

User name
headers.x-ms-user-name-encoded byte

触发流的用户的显示名称。

时间戳
headers.x-ms-user-timestamp string

触发流的时间。

执行操作时

在作完成时 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 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'。