Dataverse 快速入门指南

本文介绍了 Python(以及其他非 .NET)程序员为了成功使用 Dataverse 而应了解的一些关键概念。 它还提供指向更多详细信息的链接。 Dataverse 功能非常广泛,但你可以按照自己的节奏探索这些其他功能。

C#/.NET 中的程序员应阅读广泛的 Dataverse 开发人员指南

表与消息

将数据存储在表中,这些表组织为行和列。 消息是作用于表及表数据的操作。 表也称为 实体,在文档中,行有时也被称为 记录

Tables

通常使用 Dataverse 中的三种表:系统、可自定义表和自定义表。 系统表(也称为开箱即用的表)无法更改。这些表支持 Dataverse 的基本功能。 如果具有适当的权限,则可以以交互方式或以编程方式修改可自定义表和自定义表。

若要以交互方式 创建或修改表,请使用 Power Platform 管理中心 (PPAC)。 若要以编程方式创建或修改表,请修改表元数据。 Python SDK 包含位于 client.tables 中的函数,使你能够轻松操作表元数据。

Dataverse 表行(也称为记录)表示为具有列架构名称的Python字典。

有关详细信息,请参阅 Web API EntityType 参考 和使用 包含表定义的 Web API

消息

消息表示要执行的 Web 服务操作。 消息可以是简单的操作,例如创建、检索、更新和删除(CRUD)。 消息还可以调用更复杂的操作,例如 book 或 win,这可能会启动其他操作的组合。

实体类型引用列出了所有已知(非自定义)表以及每个表支持的标准消息。 创建自定义表格时,该表格会提供一套默认消息。

安全性

根据管理员分配给你的安全角色(或角色)以及该角色的数据管理权限,限制对 Dataverse 环境中数据的访问权限。 角色可能会授予对整个表的访问权限,或者安全性可能会限制对特定行和列的访问。

有关详细信息,请参阅 安全概述 以及 安全性和数据访问

自定义和扩展

本部分介绍自定义和扩展 Dataverse 的一些方法。

关于表格的更多信息

Dataverse 支持可定制的表和自定义的表。 可自定义表是 Dataverse 附带的现有表,可以对其进行修改,例如添加或删除列、更改表名称等。

自定义表是你(或第三方)创建的表。 如本文前面所述,SDK 提供了可用于创建和删除自定义表的Python函数。

Important

必须为自定义表和列的所有操作(例如,“new_MyTestTable”,而不是“MyTestTable”)包括自定义前缀值。

始终在 SDK API 调用中使用表架构名称(“account”、“new_MyTestTable”)和列架构名称(“name”、“new_MyTestColumn”)。

有关更多信息,请参阅Microsoft Dataverse 中的表定义

Extensions

可以使用事件处理程序(称为插件)和自定义工作流活动来修改 Dataverse 数据处理的功能。 这些编译的自定义代码对象在特定的表和消息组合上注册。 插件或工作流活动可以在 Dataverse 的主要数据处理操作之前或之后修改数据。 如果看到的数据结果与预期不同,则其中一个扩展可能是原因。

自定义和扩展 Dataverse 的其他方法存在,但完整列表超出了本文的范围。

网络应用程序接口

SDK 提供一个 Python 编程接口,该接口在内部调用 Dataverse Web API。 该 DataverseClient 类提供 Web API 所需的 OData 2.0 授权的简化接口。

可以直接从 Python 程序中调用 Web API 函数和作。 但是,适用于 Python 的 SDK 提供了更自然的编程语法,可按 Python 开发人员和数据科学家的预期方式访问 Dataverse 数据。

Solutions

解决方案是一个容器,其中包含用于扩展和自定义 Dataverse 的文件夹和文件。 解决方案是将自定义项和扩展打包到单个压缩文件中进行导出的机制。 可以将该解决方案文件导入其他环境(也称为组织)。

扩展和自定义项始终存在于解决方案中。 在 Dataverse 中,有一个默认解决方案。 如果将扩展或自定义项添加到环境中而不将它们添加到自定义解决方案,则默认解决方案会自动包含它们。

可以使用 PPAC 或 Web API 以编程方式以交互方式创建、管理、导出和导入解决方案。

有关更多信息,请参阅解决方案概念