使用 OData v4 数据提供程序的虚拟表演练
假设您想从模型驱动应用中的外部数据源访问、创建、更新和删除有关联系人的一些个人信息。 在此简单演练中,您将在运行时从 OData Web 服务为具有映射到外部架构的列的名为人员的虚拟表建模,来执行这些操作。
数据源详细信息
因为用于此演练的数据源拥有 OData v4 Web 服务,所以可使用您的环境随附的 OData v4 数据提供程序。
Web 服务 URL:https://contosowebservice.azurewebsites.net/odata/
重要
- 用于本演练的 Web 服务 url 不是可工作的 Web 服务。
- 不能使用 OData v4 数据提供程序连接到另一个环境。
本演练需要一个包含下面三个列的虚拟表。
外部列名称 | 外部数据类型 | 虚拟表数据类型 | 用途 |
---|---|---|---|
编号 | Edm.Guid |
主密钥 | 表的主键 |
FirstName | Edm.String |
单行文本 | 人员的名字 |
LastName | Edm.String |
单行文本 | 人员的姓氏 |
年限 | Edm.Int32 |
整数 | 人员的年龄 |
LastModifiedOn | Edm.DateTimeOffset |
日期和时间 | 人员记录的最后修改日期和时间 |
外部数据源人员表的 OData 元数据:
创建数据源
为使用 OASIS 开放数据协议 (OData) 示例 Web 服务的 OData v4 数据提供程序创建数据源。
转至设置 > 管理 > 虚拟实体数据源。
依次选择新建、OData v4 数据提供程序和确定。
输入或选择以下信息。
字段 值 客户 人员示例 OData 数据源 URL https://contosowebservice.azurewebsites.net/odata
超时 30 返回内联计数 客户端分页 返回内联计数 真
其他列按原样保留,然后选择保存并关闭。
提示
使用自己的 Web 服务时,请验证 URL 是否有效,方法是将其粘贴到 Web 浏览器中。 如果您想要了解与您感兴趣的表相对应的列和数据类型,可以在 URL 的末尾追加 /$metadata
来查看 Web 服务中的表定义。
打开解决方案资源管理器
您创建的任何自定义表的名称中包含自定义前缀。 这是根据您在其中工作的解决方案的解决方案发布商设置的。 请确保在非托管解决方案中工作,其中的自定义前缀是您需要的此表的前缀。 详细信息:更改解决方案发布商前缀
打开非托管解决方案
在 Power Apps 左侧导航窗格中选择解决方案,然后在工具栏上选择切换到经典。 如果项目不在侧面板窗格中,请选择 …更多,然后选择所需项目。
在所有解决方案列表中,打开要使用的非托管解决方案。
创建虚拟表
在解决方案资源管理器的左侧导航窗格中,选择实体,然后从主窗格选择新建。
在实体: 新建窗体中,选择虚拟表选项,然后输入以下信息:
字段 值 数据源 人员示例 OData 数据源 显示名称 人员 复数名称 人员 客户 new_person 外部名称 人员 外部集合名称 人员 注释(包括附件) 选定 活动 选定 备注
OData 资源路径语义使用
EntitySet
标识资源。 在示例 OData Web 服务中,EntitySet
定义为人员。 此值用作虚拟表人员的外部名称。在显示此实体的区域旁边,选择销售,然后选择保存(但不关闭表窗体)。
为虚拟表创建列
在实体: 人员页面的左侧导航窗格中,选择字段。 作为本演练的一部分,您将编辑两个现有列,另外再添加三个在外部数据源中可用的列。
重要
外部名称区分大小写。 请参阅 Web 服务元数据以确保使用正确名称。 可空值 false 表示属性为必需属性。 请注意,系统始终需要主键列。
打开 new_personid 列,然后使用此处指示的值更改以下属性:
外部名称:Id
选择保存并关闭。
打开 new_name 列,然后将以下属性更改为此处指示的值:
- 显示名称:姓氏
- 外部名称:LastName
选择保存并关闭。
选择新建,然后在字段: 为人员新建页面中输入以下信息:
字段 值 显示名称 名 客户 new_firstname 外部名称 FirstName 字段要求 业务必需的 数据类型 单行文本 选择保存并关闭。
选择新建,然后在字段: 为人员新建页面中输入以下信息:
字段 值 显示名称 年限 客户 new_age 外部名称 年限 字段要求 业务必需的 数据类型 整数 选择保存并关闭。
选择新建,然后在字段: 人员新建页面中输入以下信息:
字段 值 显示名称 上次修改时间 客户 new_lastmodifiedon 外部名称 LastModifiedOn 字段要求 业务必需的 数据类型 日期和时间
将列添加到主窗体
在人员表窗口中,选择窗体。
打开主窗体,将名字、年龄和上次修改日期列从右窗格拖放到常规部分的窗体上。
在人员表窗口中,选择保存并关闭。
配置默认视图
- 在解决方案资源管理器的左窗格中人员实体下,选择视图。
- 打开所有人员视图。
- 在常规任务窗格中,选择添加列。
- 选择名字、年龄和上次修改日期列,然后选择确定。
- 在视图: 所有人员窗口上,通过选择左移和右移箭头来排列列顺序,然后选择保存并关闭。
- 在解决方案资源管理器窗口中,单击发布所有自定义项。
- 发布了所有自定义项之后,关闭解决方案资源管理器窗口。
在模型驱动应用中使用虚拟表
创建一个模型驱动应用,然后将人员表添加到站点地图。 然后,选择人员主窗体和人员高级查找视图。 发布应用程序。 详细信息:从头开始构建第一个模型驱动应用
然后,应用用户可以使用虚拟表执行读取、创建、更新和删除操作,就像在 Microsoft Dataverse 中使用任何其他表一样。
使用虚拟表创建、查看和删除记录
- 运行该模型驱动应用。 选择新建,完成所需列,然后保存记录。
- 再次选择新建创建另一个记录并保存。
- 现在,您应该在所有人员视图中有两个与下方类似的记录。
- 要删除记录,选择一个人员记录,然后选择删除。 确认删除确认页上的记录。