查询#

概述#

查询小组件显示任何查询的结果，包括带有参数的查询。下面显示了一个示例，其中在UI页面底部使用了查询小组件来显示查询的结果。

要在UI页面中使用查询小组件，请执行以下步骤。

1. 在处于构建模式的任何UI页面中，从页面右侧的“小组件”列表中选择查询小组件，然后将其拖放到UI页面中的正确位置。
2. 进入小组件的“设置”部分。
3. 在“常规”选项卡中，提供小组件的名称和描述，并指定是否应显示标题以及用户是否可以激活全屏模式。
4. 在查询设置选项卡中提供查询和选择模式：
5. 多行 - 可选择多行
6. 无 - 与显示的数据交互时没有可用的选择
7. 单行 - 可选择单行
8. （可选）定义此小组件和UI页面的其他元素之间的链接。
9. 通过保存并关闭设置，小组件将相应地进行更改。

实施示例：参数化查询#

对于本示例，让我们使用参数化查询添加查询小组件，并将其链接到允许用户提供参数的来源小组件。

链接的构建方式取决于查询参数的设置方式。下面是一些常见示例：

实体参数 - 来自单个实体选择的输入#

在查询上设置实体参数（在本示例中，是ScheduledJob查询的物料实体）：

在UI页面上，查询需要实体ID，该ID可以基于实体选择，方法是使用参数设置为Id的anyToAnyProperty转换器。

接下来，在页面设置中将转换器参数创建为属性：

然后，表单字段可以链接到如下查询参数：

名称参数 - 来自单个实体选择的输入#

在查询上设置实体参数（在本示例中，是ScheduledJob查询的资源名称）：

与上面所做的类似，如果实体是通过表单提供的，则可以构建如下所示的链接。在本例中，可以使用标准转换器entityName，该转换器将只传递实体的名称作为字符串：

名称参数 - 来自自由文本字段的输入#

表单字段也可以用作自由文本输入，并且该输入可以传递给任何名称参数，而无需使用转换器。与先前示例相同，但表单字段只配置为字符串：

此类字段可以像这样轻松链接：