ASTRO轻应用 ASTROZERO-为AstroZero服务编排添加记录查询图元:如何使用记录查询图元

时间：2024-08-29 14:50:57

ASTRO轻应用 ASTROZERO

如何使用记录查询图元

在基本中，拖拽“记录查询”图元至画布中。

选中记录查询图元，单击

，设置基本信息。

表1 基本信息参数说明
参数	说明
标签	设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为RecordSelect序号，序号从“0”开始，表示同类型图元序号。
名称	设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下：长度范围为1~80个字符。必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。
描述	请根据实际需求，在输入框中输入图元的描述信息。取值范围：1~255个字符。
使用快速查询模式	是否启用快速查询模式。如果勾选该参数，表示为快速模式。仅配置查询条件即可，查询结果自动保存在对象变量中。如果对象变量不是数组，则仅保存第一条符合条件的记录。如果对象变量为数组，则保存所有返回的记录。不勾选，表示为普通模式。根据条件查询对象记录，需要指明要查询的对象名、查询条件，需要查询的字段列表，查询结果需要保存到设置的变量中。默认不勾选。

单击

，在“记录查询”页面进行配置。

如果上一步勾选“使用快速查询模式”，则需要指定一个预先定义的对象变量或者对象变量数组，并将该对象变量或对象变量数组拖拽到“变量”输入框中，并设置条件以及选择排序方式，即可实现根据条件和排序方式将查询结果保存在对象变量中。如图1所示，根据条件查询对象数据，并将查询结果保存在对象变量“Account”中。

图1 快速查询模式

表2 快速查询模式参数说明
参数	说明
变量	预先定义的对象变量或者对象变量数组。查询结果自动保存在对象变量或者对象变量数组中。如果对象变量不是数组，则仅保存第一条符合条件的记录。如果对象变量为数组，则保存所有返回的记录。从全局上下文拖拽或直接输入对象变量/对象变量数组。
无记录时配置空值	当根据条件查询无记录时，则变量为空值。默认为勾选。
条件	选中对象后，该条件区域“字段”列会出现该对象的字段。单击“新增行”，可设置查询数据的条件。在“字段”中选择要进行判断的对象字段，在“比较符”中选择相应的比较符，“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。
（排序）排序字段/顺序	使查询结果根据某个字段进行升序或者降序排序。

如果上一步未勾选“使用快速查询模式”，则需要指定对象并在条件中设置指定对象部分字段的值，根据条件查询符合条件的对象记录，并赋值到设置的变量上。如图2所示，查询“Account”对象“name”为“Lily”的记录，并将查询得到的对象id赋值到"var_record_id"变量上。

图2 普通查询模式

表3 普通查询模式参数说明
参数	说明
对象	查询的具体对象名，请直接在下拉框中选择目标对象。
剔重	如果查询记录有重复值，是否需要删掉重复记录只保留一条记录。默认不勾选，表示不删掉重复记录。
条件	选中对象后，该条件区域“字段”列会出现该对象的字段。单击“新增行”，可设置查询数据的条件。在“字段”中选择要进行判断的对象字段，在“比较符”中选择相应的比较符，“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。
（排序）排序字段/顺序	使查询结果根据某个字段进行升序或者降序排序。
记录行的偏移量	分页，跳过前n条记录，从第n+1条记录开始。从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。
记录行的最大数目	分页，每页最多显示的记录数。从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。
记录的总行数存入变量	查询出来的总记录数存入变量中。从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”。
（输出）源/目标	输出结果，单击“新增行”，可进行添加。 “源”为需要查询的字段，可从下拉框中选择，“目标”可从全局上下文拖拽变量或者直接输入变量名。
无记录时配置空值	当根据条件查询无记录时，则变量为空值。默认为勾选。