Apps 用户指南

适用平台：

上次更新日期 2025年10月29日

查询构建器

查询生成器允许您筛选 Data Service 实体中的数据，同时遵循预定义的语法。

重要提示：

Fetch 、 FetchOne 、 GetChoiceSet和GetChoiceSetValue函数是异步函数，并且不支持链接。

要在控件中显示实体记录，请使用应用程序变量和“设置值”规则。您还可以使用查询生成器将控件数据源绑定到实体。

有关实际示例，请参阅使用 Fetch 函数。

提示：要在页面加载或单击按钮时刷新实体变量，请添加“设置值”规则。在设置值规则中打开“查询生成器”，并为“UpdateTime <= now( )”添加一个筛选条件。

使用查询生成器

查询生成器使用 Fetch() 函数对 Data Service 实体进行评估和排序。

作为先决条件，您必须将现有 Data Service 实体引用到应用程序中。要使用查询生成器，请继续执行以下步骤：

对于所需的控件，选择“已启用 VB”属性。您可以通过“常规”选项卡中的“VB 数据源”字段来识别这些属性类型。
选择“查询生成器”。系统将打开“查询生成器”窗口。
选择要为其构建查询的实体。

在“条件”选项卡上，单击：

选项	描述
添加条件	添加单个条件
添加组	对多个条件进行分组

添加两个或更多条件时，查询将根据 AND 或 OR 运算符评估并返回数据：

AND - 返回满足所有条件的数据
OR - 返回满足任意条件的数据

选择要从中查询数据的实体字段。
选择评估运算符。
输入条件的值。值的类型必须与字段类型相同。例如，对“文本”字段使用字符串，对“数字”字段使用整数。
（可选）在“其他设置”选项卡上为查询的数据配置规则。
选择“保存”以保存查询。

其他设置

在“其他设置”选项卡上，您可以为查询的数据配置规则。

下表描述了“其他设置”选项卡的元素。

元素	描述
页面起始索引 (跳过)	用于定义在开始返回结果之前要跳过的记录数量。例如，如果您输入10 ，则查询从第 11 条记录开始。注意：使用大型数据集时，设置“页面开始索引”对于分页非常有用。
页数限制 (顶部)	用于设置要返回的最大记录数。例如，如果您输入“50”，则查询将返回前 50 行。注意：设置页限制有助于控制查询大小。
添加排序字段	添加一个排序字段，该字段允许您为查询的数据配置排序规则。显示“排序依据”字段和“对元素进行升序排序” 。
按字段排序	使您可以输入要用于对数据进行排序的字段。
升序排列	如果为 True，则按升序对查询的数据进行排序。
投影	可用于定义实体中仅应包含在结果集中的特定字段。备注：可使用投影来简化输出数据。

Fetch 函数

查询生成器使用Fetch()函数来检索和操作实体数据。 Fetch()函数是异步函数，并且不支持链接。

Fetch() 函数具有以下参数：

参数	描述
`FilterGroup`	Data Service 中的一组筛选器
`PaginationProps`	指定页面大小和要跳过的记录数。
`SortOption[] sortOptions`	指定要排序的列和排序顺序。
`string[] selectedFields`	指定应返回的实体字段。
`ExpansionFieldOption[] expansionFieldOptions`	指定应展开并返回关系实体的列。 Apps 允许一级扩展，这意味着如果您有关系字段，则表达式需要一级属性才可访问。查询生成器会自动添加这些属性，并且它们对于非系统实体是必需项。

The FetchOne() function

当 Fetch() 返回 ListSource<T> 时，其类型与列表控件相同，而 FetchOne() 返回类型为 T 的单个记录。

与Fetch()函数一样， FetchOne()函数是异步函数，并且不支持链接。

对于以下场景，您需要手动修改 Fetch() 函数，以获得更多自定义结果：

简单提取

获取实体的记录数，例如 SystemUsers。

Fetch(of SystemUsers)()Fetch(of SystemUsers)()

使用筛选条件获取

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))

使用筛选条件和排序顺序（升序）获取

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})

使用筛选条件和排序顺序（降序）获取

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})

使用静态分页属性获取

Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))

使用控件绑定的静态分页属性获取

例如，对于“编辑网格”控件：

Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))

使用投影获取

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})