> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 设置参与筛选字段

> 该页面介绍了搜索存储应用中字段参与搜索的设置方法，包括不同版本下的操作差异、功能简介、使用场景以及参与搜索的组件分类和类型。

<Warning>
  使用前提：

  * 付费版新版搜索存储应用下，取消设置参与搜索字段限制，默认所有添加的筛选字段均为可搜索字段；
  * 免费版新旧搜索存储应用均需手动设置字段参与搜索；
  * 搜索能力升级详情可 **点击此处** 查看；

  **注：数据管理页处有展开子表列按钮为旧存储应用。**
</Warning>

## 1. 简介

### 1.1 功能简介

由于数据管理页内参与筛选/过滤的字段有数量限制，当表单内字段数量过多时，后续添加的超过筛选上限的字段会被系统默认归纳到「未参与搜索字段」列表中，如果需要设置指定字段参与筛选，可以自定义参与搜索字段。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1652931071236-b35c9146-b9da-4e63-97ea-0be2a1214da1.png)
</Frame>

### 1.2 使用场景

字段是否参与搜索会影响到接口、数据管理页查询、组件数据联动匹配条件、业务关联规则等场景的使用，报表搜索不会受到限制。

## 2. 参与搜索的组件分类

### 2.1 参与搜索的类型

目前系统有四种参与搜索的类型，分别为**精准搜索、模糊搜索、数字搜索、其他搜索**。系统会自动将对应的组件归类到这四种参与搜索类型当中。

**每种搜索类型都会有参与搜索的字段数量上限。**

模糊搜索时，搜索内容支持字母大小写兼容，例如数据1：ABCD  ，数据2：abcd ，输入A或 a 均可以搜索到这两条数据。

规范清单如下：

| **精准搜索（上限50）** | **模糊搜索（上限15）** | **数字搜索（上限20）** | **其他搜索（上限20）** |
| -------------- | -------------- | -------------- | -------------- |
| 单选             | 单行文本           | 数值             | 部门             |
| 下拉单选           | 多行文本           | 评分             | 成员             |
| 级联选择           | 图片上传           | 日期区间           | 复选             |
| 地址             | 地址             | <br />         | 下拉复选           |
| <br />         | 子表单            | <br />         | 国家/地区          |
|                | 附件             |                | 关联表单           |

<table>
  <tr>
    <td />

    <td>**组件名称**</td>
    <td>**操作符**</td>
    <td>**截图示意/备注**</td>
  </tr>

  <tr>
    <td rowSpan={15}>普通组件</td>
    <td>单行文本</td>
    <td rowSpan={2}>等于<br />匹配（like）</td>

    <td />
  </tr>

  <tr>
    <td>多行文本</td>

    <td />
  </tr>

  <tr>
    <td>数值</td>
    <td rowSpan={2}>大于/小于/介于/大于等于/小于等于</td>

    <td />
  </tr>

  <tr>
    <td>评分</td>

    <td />
  </tr>

  <tr>
    <td>单选</td>
    <td>等于/包含</td>
    <td>“等于”时只能单选选择<br />”包含“时可多选</td>
  </tr>

  <tr>
    <td>下拉单选</td>
    <td>等于/包含</td>
    <td>支持数字/字母模糊搜索（提交数据是搜索选择选项）</td>
  </tr>

  <tr>
    <td>复选</td>
    <td rowSpan={2}>等于/包含(in)</td>

    <td />
  </tr>

  <tr>
    <td>下拉复选</td>

    <td />
  </tr>

  <tr>
    <td>级联选择</td>
    <td>等于/包含(每级是 eq)</td>

    <td />
  </tr>

  <tr>
    <td>日期</td>
    <td>大于/小于/介于/大于等于/小于等于</td>

    <td />
  </tr>

  <tr>
    <td>日期区间</td>
    <td>2个组件的操作符默认为等于</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1629862414545-1253ff0a-9b86-47e6-adeb-a45ccb3ab4fd.png)<br />自动生成 2 个组件</td>
  </tr>

  <tr>
    <td>图片上传</td>
    <td rowSpan={2}>模糊匹配（like）</td>

    <td />
  </tr>

  <tr>
    <td>附件</td>

    <td />
  </tr>

  <tr>
    <td>成员</td>
    <td>等于/包含(in)</td>
    <td>“等于”时只能单选选择<br />”包含“时可多选</td>
  </tr>

  <tr>
    <td>子表单</td>
    <td>筛选域无透出此字段</td>

    <td />
  </tr>

  <tr>
    <td rowSpan={9}>高级控件</td>
    <td>部门</td>
    <td>等于/包含(in)</td>
    <td>“等于”时只能单选选择<br />”包含“时可多选</td>
  </tr>

  <tr>
    <td>国家/地区</td>
    <td>等于/包含(in)</td>
    <td>“等于”时只能单选选择<br />”包含“时可多选</td>
  </tr>

  <tr>
    <td>地址</td>
    <td>地址：等于/包含(每级是eq)<br />详细地址：等于/匹配（like）</td>
    <td>![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1629862395172-f4088e82-c6b3-4e30-8709-4c66fa21cb47.png)<br />自动生成地址、详细地址 2个组件<br />“等于”时只能单选选择<br />”包含“时可多选</td>
  </tr>

  <tr>
    <td>富文本</td>
    <td rowSpan={6}>筛选域无透出此字段</td>

    <td />
  </tr>

  <tr>
    <td>布局容器</td>

    <td />
  </tr>

  <tr>
    <td>分组</td>

    <td />
  </tr>

  <tr>
    <td>关联表单</td>
    <td>支持数字/字母模糊搜索（提交数据时选择关联表单数据）</td>
  </tr>

  <tr>
    <td>定位</td>

    <td />
  </tr>

  <tr>
    <td>手写签名</td>

    <td />
  </tr>
</table>

**例如**：如果表单内含有单行文本，那么单行文本字段就会被归类到模糊搜索字段列表中，当表单中单行文本字段数量超过 15 个时，超出的单行文本字段就会被定义为「未参与搜索字段」 。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1652931134022-db1330cb-53eb-4bba-acfb-d732c6583acc.png)
</Frame>

模糊搜索

### 2.2 操作步骤

数据管理页 >> 设置筛选条件 >> 管理员设置默认筛选字段及排序 >> 设置参与搜索字段>> 搜索需要参与搜索的字段 >> 开启「参与」>> 点击立即生效

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1652931258762-7a876baa-1266-4b64-aaf0-6f4458b8db93.png)
</Frame>

点击立即生效后，完成了构建钉钉工作通知会推送消息提醒，如下图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1652931485053-744d1feb-da1b-4564-887f-1edbcc09fb40.png)
</Frame>

## 3. 常见问题

<AccordionGroup>
  <Accordion id="q1" title="3.1 数据联动不生效 ？">
    数据联动不生效时，请先排查关联表中作为数据联动条件的字段是否有参与搜索
  </Accordion>

  <Accordion id="q2" title="3.2 业务关联规则未执行成功 ？">
    业务关联规则触发后未成功执行，请先排查作为执行函数内作为主条件/子条件的字段在对应表单的数据管理页中是否有参与搜索
  </Accordion>

  <Accordion id="q3" title="3.3 调用宜搭接口，提示应用配置错误 ？">
    调用宜搭接口后，接口返回应用配置错误，请先排查作为 searchFieldJson 参数内的查询字段在对应表单的数据管理页中是否有参与搜索
  </Accordion>

  <Accordion id="q4" title="3.4 在数据管理页没有看到「设置参与搜索字段」？">
    需要在表单内的数据管理里进行设置，不可以在自行创建的管理页进行设置

    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1652932505852-1e9563ef-d174-40c8-a8c4-b4b266bb76f5.png)
    </Frame>
  </Accordion>
</AccordionGroup>