使用 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
选择保存并关闭。
打开 new_name 字段，然后将以下属性更改为此处指示的值：
- 显示名称：标题
- 外部名称：标题
选择保存并关闭。
选择新建，然后在票据的字段：新建页面中输入以下信息：
- 显示名称：严重性
- 名称：new_severity
- 外部名称：严重性
- 字段要求：业务所需
- 数据类型：整数
- 最小值：0
- 最大值：4
选择保存并关闭。
将字段添加到主窗体
在“票据实体”窗口中，选择窗体。
打开主窗体，将严重性字段从右窗格拖放到常规部分标题字段下的窗体中。
在“票据实体”窗口中，选择保存并关闭。
配置默认视图
在解决方案资源管理器的左窗格中票据实体下，选择视图。
打开所有票据视图。
在常规任务窗格中，选择添加列。
选择严重性，然后选择确定。
在视图：所有票据窗口中，选择保存并关闭。
在解决方案资源管理器窗口中，单击发布所有自定义项。
发布了所有自定义项之后，关闭解决方案资源管理器窗口。
通过 Dynamics 365 Customer Engagement (on-premises) 查看实战中的虚拟实体
转至服务>扩展>票据。
将显示所有票据视图。 请注意，可能需要刷新浏览器，才能从服务区域查看实体。
打开票据记录查看其中包含给定记录的标题和严重性字段的窗体。
