入站数据集成

  • 6 分钟

入站数据集成专注于将数据传入 Microsoft Dataverse，供应用和流使用。

API

Web API 是两项 Web 服务之一，可用于处理 Dataverse 中的数据和元数据。 另外一项是组织服务。

Dataverse Web API 提供适用于各种编程语言、平台和设备的开发体验。 Dataverse Web API 实施 OData (Open Data Protocol) 版本 4.0，这是一项构建和使用 RESTful API 的 OASIS 标准。

所有使用 Dataverse API 的数据操作（无论是使用 Web API 还是使用组织服务）都将转换为遵循平台事件框架的消息。 使用本框架可启动经典工作流、Power Automate 云端流等流程，并且支持开发者添加自定义插件步骤以执行验证和进一步处理。

事件与批处理

解决方案架构师应对 Dataverse 所需数据进行分类。 主要类别为基于事件或基于批处理。 以下图表比较这两种方法。

入站集成方法图表。

推送模式

如果考虑将数据输入 Dataverse，需要确定是通过另一系统将数据推送至 Dataverse，还是将数据拉取至 Dataverse。

向 Dataverse 入站集成的一般推送模式是使用 web API，由其他系统执行 web API 调用。 不过，要允许其他系统直接向 Dataverse 写入数据，需要其他系统了解 Dataverse 中的数据模型以及 Microsoft Power Platform 解决方案中流程的运行方式。 建议创建一个外部系统层，以访问以下实体：

  • 基于事件的处理 - Power Automate 和 Microsoft Azure 逻辑应用非常适用于由源系统中的变更触发的个别事务。
  • 批处理 - 批处理通常由其他源（如 KingwaySoft）中的工具或通过使用 Microsoft Azure 数据工厂抽象出来。
  • Microsoft Azure Functions - Azure Functions 可以抽象出在企业集成层实施业务逻辑的需求。
  • 自定义 API - 创建您自己的 API 供其他系统调用。

注意

Power Automate 通常用于在 Dataverse 环境之间同步数据。

设计集成式解决方案时，需考虑使用多个线程来消除延迟影响和服务限制。

拉取模式

拉取模式可以有效实现数据扩充。 在 Dataverse 中检索行时，可使用拉取模式按需从外部系统获取数据。 虚拟实体非常适合这种模式。

替换键

在 Dataverse 表中，行是通过 GUID 来唯一标识的。 其他需与 Dataverse 集成的系统需要在数据库中记录 GUID，或者必须要查询 Dataverse 才能找到需要更新的行。 这种方法的效率很低。 Dataverse 支持在表中创建替换键。

有了替换键，需要读取和写入行的外部系统无需先查询 GUID 也可有效访问行。 例如，会计系统通常会有一个字母数字帐号作为帐户的唯一标识符。 您可以将 Dataverse 表中的帐号列定义为替换键，这样会计系统便可使用其在自身系统中存储的数据读取和写入帐户了。

更新插入

您可使用“更新插入”消息来降低数据集成场景所涉及的复杂性。 在从外部系统推送数据至 Microsoft Dataverse 时，您可能会不知道某条记录在 Dataverse 中是否已存在。 这种情况下，您也就不知道是该使用更新操作，还是该使用创建操作。 您首先需要通过查询来确定记录是否存在，然后再对应执行适当的操作。 现在，可以不用这么复杂了，您可使用“更新插入”消息来更有效地上传数据到 Dataverse。

“更新插入”可结合替换键使用。 您只需在“更新插入”调用中提供充分的信息，Dataverse 便会查找相应行，并对其执行创建或更新操作，如下图所示。

显示更新插入逻辑使用情况的图表。

自定义 API

自定义 API 是新发布的功能，支持您将一组操作抽象并合并到其他系统可调用的一个 API 中。

您可通过创建自定义 API 记录来定义自定义 API，如以下屏幕截图所示。

自定义 API 记录的屏幕截图。

自定义 API 可以是一个函数，也可以是一个操作。 如果要获取信息，应使用函数（即 GET 请求）；如果要修改数据，则应使用操作。

您可使用插件来执行自定义 API 的实际数据操作。

注意

有关详细信息，请参阅创建和使用自定义 API。

Azure Functions

利用 Microsoft Azure Functions，开发者可以创建复杂、可重复使用的自定义逻辑并与其他系统集成。 Azure Functions 可结合 Webhook 使用，也可捆绑到自定义连接器中。 借助 Azure Functions，开发者可以创建可重复使用的组件，供功能顾问和应用创建者在其应用和流中使用。 除此之外，其他应用也可访问 Azure Functions，以推送和拉取数据到 Dataverse。 Azure Functions 可以连接 Dataverse 并访问数据。

您可使用 Azure Functions 为您的解决方案创建 API，以创建自定义服务器端逻辑，并通过 Microsoft Azure API 管理发布 API。