使用 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 元数据:

Odata 外部数据源 XML 第 2 部分。

创建数据源

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

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

  2. 依次选择新建OData v4 数据提供程序确定

  3. 输入或选择以下信息。

    字段
    客户 人员示例 OData 数据源
    URL https://contosowebservice.azurewebsites.net/odata
    超时 30
    返回内联计数 客户端分页
    返回内联计数

其他列按原样保留,然后选择保存并关闭

提示

使用自己的 Web 服务时,请验证 URL 是否有效,方法是将其粘贴到 Web 浏览器中。 如果您想要了解与您感兴趣的表相对应的列和数据类型,可以在 URL 的末尾追加 /$metadata 来查看 Web 服务中的表定义。

打开解决方案资源管理器

您创建的任何自定义表的名称中包含自定义前缀。 这是根据您在其中工作的解决方案的解决方案发布商设置的。 请确保在非托管解决方案中工作,其中的自定义前缀是您需要的此表的前缀。 详细信息:更改解决方案发布商前缀

打开非托管解决方案

  1. Power Apps 左侧导航窗格中选择解决方案,然后在工具栏上选择切换到经典。 如果项目不在侧面板窗格中,请选择 …更多,然后选择所需项目。

  2. 所有解决方案列表中,打开要使用的非托管解决方案。

创建虚拟表

  1. 在解决方案资源管理器的左侧导航窗格中,选择实体,然后从主窗格选择新建

  2. 实体: 新建窗体中,选择虚拟表选项,然后输入以下信息:

    字段
    数据源 人员示例 OData 数据源
    显示名称 人员
    复数名称 人员
    客户 new_person
    外部名称 人员
    外部集合名称 人员
    注释(包括附件) 选定
    活动 选定

    备注

    OData 资源路径语义使用 EntitySet 标识资源。 在示例 OData Web 服务中,EntitySet 定义为人员。 此值用作虚拟表人员外部名称

  3. 显示此实体的区域旁边,选择销售,然后选择保存(但不关闭表窗体)。 人员表定义。

为虚拟表创建列

实体: 人员页面的左侧导航窗格中,选择字段。 作为本演练的一部分,您将编辑两个现有列,另外再添加三个在外部数据源中可用的列。

重要

外部名称区分大小写。 请参阅 Web 服务元数据以确保使用正确名称。 可空值 false 表示属性为必需属性。 请注意,系统始终需要主键列。

  1. 打开 new_personid 列,然后使用此处指示的值更改以下属性:

    外部名称:Id

    创建 ID 列。

  2. 选择保存并关闭

  3. 打开 new_name 列,然后将以下属性更改为此处指示的值:

    • 显示名称:姓氏
    • 外部名称:LastName

    创建姓氏列。

  4. 选择保存并关闭

  5. 选择新建,然后在字段: 为人员新建页面中输入以下信息:

    字段
    显示名称
    客户 new_firstname
    外部名称 FirstName
    字段要求 业务必需的
    数据类型 单行文本

    创建人员的年龄列。

  6. 选择保存并关闭

  7. 选择新建,然后在字段: 为人员新建页面中输入以下信息:

    字段
    显示名称 年限
    客户 new_age
    外部名称 年限
    字段要求 业务必需的
    数据类型 整数

    创建年龄列。

  8. 选择保存并关闭

  9. 选择新建,然后在字段: 人员新建页面中输入以下信息:

    字段
    显示名称 上次修改时间
    客户 new_lastmodifiedon
    外部名称 LastModifiedOn
    字段要求 业务必需的
    数据类型 日期和时间

    创建上次修改日期列。

将列添加到主窗体

  1. 人员表窗口中,选择窗体

  2. 打开主窗体,将名字年龄上次修改日期列从右窗格拖放到常规部分的窗体上。

    添加到主窗体的名字、年龄和上次修改日期列。

  3. 人员表窗口中,选择保存并关闭

配置默认视图

  1. 在解决方案资源管理器的左窗格中人员实体下,选择视图
  2. 打开所有人员视图。
  3. 常规任务窗格中,选择添加列为视图添加列。
  4. 选择名字年龄上次修改日期列,然后选择确定
  5. 视图: 所有人员窗口上,通过选择左移和右移箭头来排列列顺序,然后选择保存并关闭
  6. 在解决方案资源管理器窗口中,单击发布所有自定义项
  7. 发布了所有自定义项之后,关闭解决方案资源管理器窗口。

在模型驱动应用中使用虚拟表

创建一个模型驱动应用,然后将人员表添加到站点地图。 然后,选择人员主窗体和人员高级查找视图。 发布应用程序。 详细信息:从头开始构建第一个模型驱动应用

然后,应用用户可以使用虚拟表执行读取、创建、更新和删除操作,就像在 Microsoft Dataverse 中使用任何其他表一样。

使用虚拟表创建、查看和删除记录

  1. 运行该模型驱动应用。 选择新建,完成所需列,然后保存记录。
  2. 再次选择新建创建另一个记录并保存。
  3. 现在,您应该在所有人员视图中有两个与下方类似的记录。 查看所有人员。
  4. 要删除记录,选择一个人员记录,然后选择删除。 确认删除确认页上的记录。

另请参阅

OData v4 数据提供程序配置,要求和最佳实践
创建和编辑包含来自外部数据源的数据的虚拟表

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。