通过

使用 OData v4 数据提供程序演练虚拟实体

  • 项目

假设您想要从自定义业务应用中的外部数据源访问、创建、更新和删除有关联系人的一些个人信息。 因为用于此演练的数据源有 OData v4 Web 服务，所以您可以使用您的 Dynamics 365 Customer Engagement 版本随附的 OData v4 数据提供程序。 详细信息：使用 OData v4 数据提供程序演练虚拟表

此主题适用于 Dynamics 365 Customer Engagement (on-premises)。 有关此主题的 Power Apps 版本，请参阅： 虚拟表演练

关于此虚拟实体演练

假设要从 Customer Engagement 的自定义商业应用程序或“服务”区域内访问外部数据源中的票据信息。 在此演练中，您将使用映射到外部架构的字段对虚拟实体建模，该架构在运行时从 OData Web 服务检索票据数据。

数据源详细信息

因为用于此演练的数据源拥有 OData v4 Web 服务，所以可使用您的环境随附的 OData v4 数据提供程序。

Web 服务 URL：https://contosowebservice.azurewebsites.net/odata/

重要提示

用于本演练的 Web 服务 url 不是可工作的 Web 服务。

本演练需要一个包含下面三个字段的虚拟实体。

外部字段名称 外部数据类型 虚拟实体数据类型 用途
TicketID Edm.Guid 主键 实体的主键
标题 Edm.String 单行文本 票据的标题
严重性 Edm.Int32 整数 数值 0-4，用于指示票据的严重性

外部数据源票据实体通过 Web 浏览器查看时的 OData 元数据。

票证实体元数据。

创建数据源

为使用 OASIS 开放数据协议 (OData) 示例 Web 服务的 OData v4 数据提供程序创建数据源。

转至设置>管理>虚拟实体数据源。

依次选择新建、OData v4 数据提供程序和确定。

输入或选择以下信息。

  • 名称：Contoso 示例数据源
  • URL：https://contosowebservice.azurewebsites.net/odata
  • 超时：30
  • 返回内联计数：True

让其他字段保留原样，然后选择保存并关闭。

小费

使用自己的 Web 服务时，请验证 URL 是否有效，方法是将其粘贴到 Web 浏览器中。

创建虚拟实体

转到设置>自定义>自定义系统。

在左侧导航窗格中，选择实体，然后从主窗格选择新建。

在实体：新建窗体中，选择虚拟实体选项，然后输入以下信息：

  • 数据源：Contoso Sample Data Source
  • 显示名称：票据
  • 复数名称：票据
  • 名称：新票据
  • 外部名称：票据
  • 外部集合名称：票据
  • 选择以启用以下通信和协作选项：
    • 注释(包括附件)
    • 活动

在显示此实体的区域旁边，选择服务，然后选择保存（但不关闭实体窗体）。

票证实体定义。

创建虚拟实体的字段

在实体：票据页面的左侧导航窗格中，选择字段。 本演练过程中将编辑两个现有字段，再添加一个字段。

重要提示

外部名称区分大小写。 请参阅 Web 服务元数据以确保使用正确名称。

可空值 false 表示属性为必需属性。 请注意，系统始终需要主键字段。

打开 new_ticketid 字段，然后使用此处指示的值更改以下属性：

外部名称：TicketID

TicketID 字段。

选择保存并关闭。

打开 new_name 字段，然后将以下属性更改为此处指示的值：

  • 显示名称：标题
  • 外部名称：标题

“标题”字段。

选择保存并关闭。

选择新建，然后在票据的字段：新建页面中输入以下信息：

  • 显示名称：严重性
  • 名称：new_severity
  • 外部名称：严重性
  • 字段要求：业务所需
  • 数据类型：整数
  • 最小值：0
  • 最大值：4

“严重性”字段。

选择保存并关闭。

将字段添加到主窗体

在“票据实体”窗口中，选择窗体。

打开主窗体，将严重性字段从右窗格拖放到常规部分标题字段下的窗体中。

添加到主窗体的“严重性”字段。

在“票据实体”窗口中，选择保存并关闭。

配置默认视图

在解决方案资源管理器的左窗格中票据实体下，选择视图。

打开所有票据视图。

在常规任务窗格中，选择添加列。

为视图添加列。

选择严重性，然后选择确定。

在视图：所有票据窗口中，选择保存并关闭。

在解决方案资源管理器窗口中，单击发布所有自定义项。

发布所有自定义项。

发布了所有自定义项之后，关闭解决方案资源管理器窗口。

通过 Dynamics 365 Customer Engagement (on-premises) 查看实战中的虚拟实体

转至服务>扩展>票据。

“票证”区域。

将显示所有票据视图。 请注意，可能需要刷新浏览器，才能从服务区域查看实体。

“所有票证”视图。

打开票据记录查看其中包含给定记录的标题和严重性字段的窗体。

票证记录。

另请参阅

OData v4 数据提供程序配置，要求和最佳实践

创建和编辑包含来自外部数据源的数据的虚拟实体