查询单条数据节点

1. 简介

查询单条数据，可以利用查询条件和数据排序来定位、查询出目标表单中的某条数据，且查询结果（包括查询出的数据条数）支持被后续执行节点多次调用。

该节点主要用于查询出某条数据，供后续节点进行条件判断、新增、删除、修改等操作的场景。如：

以客户管理场景为例，当新增联系人时，查询客户表中是否存在对应客户信息，若不存在，则新建一条客户记录。效果如下图所示：

新建智能助手Pro 后，将自动进入设计画布，配置好触发节点后，即可进行后续执行节点的配置。

根据业务需求，在已有节点后添加一个查询单条数据节点：

目标表单是指，查询单条数据节点获取数据的表单，支持选择当前应用以及跨应用的表单：

查询单条数据节点仅能从目标表单中查询出单条数据。因此，当目标表单中的数据较多时，可以根据需求添加查询条件，使其仅查询出符合特定条件的数据。

查询条件需要设置的内容及说明如下：

注：

1）不同类型的目标表单字段可设置的过滤关系与过滤值不同。如需使用子表单字段作为过滤值，则需要将过滤关系设置为「等于任意一个/不等于任意一个/同时包含/包含任意一个」，详情参见：过滤值说明；

2）支持引用字段值的前置节点包括：触发节点、查询单条/多条数据节点、新增数据（单条/多条）、计算节点和插件节点。其中，当触发方式为「定时触发 >> 自定义时间」时，不可引用触发节点的字段值；

3）目标表单中的部分字段不能设置查询条件，包括：分割线、查询、选择数据、手机、微信头像、文字识别、按钮、当前节点以及当前负责人。

若添加了排序规则，查询单条数据节点在查询目标表单数据时，将按照排序规则，取排序后的第一条数据。排序规则设置如下：

注：

1）每个字段只能被添加为排序规则一次，且最多支持添加 5 个排序规则；

2）若未添加排序规则，查询单条数据节点在查询目标表单数据时，将随机获取一条数据。

当「查询单条数据节点」的查询结果被后续执行节点调用时，若查询结果为空，则会对后续节点的执行效果产生影响，详情参见：执行节点详解。

在调用「查询单条数据节点」的查询结果时，该节点会提供一个可作为单值的数字类型字段的节点变量「数据条数」供调用，且变量值为查询出的数据条数。具体说明如下：

1）调用说明

「数据条数」为动态值，会始终获取最新查询出的数据总数。即，如果查询单条数据节点在一次执行中，查询出了 1 条数据，但随后这条数据被删除，节点能够查询出的数据条数为 0，则调用数据条数变量时，变量值为 0。

2）场景举例

以同步客户信息为例，在新增联系人时，查询客户表中是否存在对应客户。在条件分支节点中，通过调用「数据条数」变量来判断客户是否存在，并依据判断结果，进行相应的新增/更新客户信息操作：

则，「数据条数」变量的调用方式如下图所示：