> ## 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.

# 検索対象フィールドの設定

> YiDA のデータ管理ページで検索対象フィールドを設定する方法を解説します。プラン別の違い、機能概要、ユースケース、検索に対応するコンポーネントの分類とタイプを紹介し、業務効率化に役立つ構成方法をわかりやすく説明します。

<Warning>
  前提条件：

  * 有料プランの新しい検索ストレージアプリでは、検索対象フィールド設定の上限が撤廃されました。デフォルトで、追加されたすべてのフィルターフィールドが検索対象となります。
  * Free プランでは、旧版・新版の検索ストレージアプリのいずれの場合も、検索対象フィールドを手動で設定する必要があります。
  * 検索機能のアップグレードに関する詳細は、**こちらをクリック**してご確認ください。

  **注意：データ管理ページに「サブテーブル列を展開」ボタンがある場合は、旧版のストレージアプリです。**
</Warning>

## 1. 概要

### 1.1 機能概要

データ管理ページでフィルターに使用できるフィールド数には上限があります。フォームに含まれるフィールドが多すぎる場合、フィルター上限を超えた追加フィールドは、システムによって自動的に「検索不可フィールド」リストへ振り分けられます。特定のフィールドを検索対象にしたい場合は、検索対象フィールドをカスタマイズしてください。

### 1.2 ユースケース

フィールドを検索対象に含めるかどうかは、API 呼び出し、データ管理ページでのクエリ、コンポーネントのデータ連動のマッチング条件、業務関連ルールなどのシーンに影響します。なお、レポート検索はこの設定の制限を受けません。

## 2. 検索に対応するコンポーネントの分類

### 2.1 検索タイプ

現在、システムは**完全一致検索、あいまい検索、数値検索、その他の検索**の 4 種類の検索タイプに対応しています。各コンポーネントは、システムによって自動的にこの 4 タイプのいずれかに分類されます。

**各検索タイプには、検索に使用できるフィールド数の上限があります。**

あいまい検索は大文字と小文字を区別しません。例えば、レコード 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>生成される両方のコンポーネントの演算子は、デフォルトで「等しい」です。</td>
    <td>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>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 を超えると、超過分の一行テキストフィールドは「検索不可フィールド」としてマークされます。

あいまい検索

### 2.2 手順

データ管理ページ >> フィルターを設定 >> 管理者がデフォルトのフィルターフィールドと並び順を設定 >> 検索対象フィールドを設定 >> 検索に含めたいフィールドを検索 >> 「参加」をオンにする >> 「今すぐ適用」をクリック。

「今すぐ適用」をクリックすると、設定完了を通知する DingTalk の業務通知メッセージがプッシュされます。

## 3. FAQ

<AccordionGroup>
  <Accordion id="q1" title="3.1 データ連動が有効にならない">
    データ連動が有効にならない場合は、まず関連するテーブルでデータ連動の条件として使用されているフィールドが検索対象に含まれているかをご確認ください。
  </Accordion>

  <Accordion id="q2" title="3.2 業務関連ルールが正常に実行されなかった">
    業務関連ルールがトリガーされたにもかかわらず正常に実行されなかった場合は、まず実行関数の主条件または副条件として使用されているフィールドが、対応するフォームのデータ管理ページで検索対象に含まれているかをご確認ください。
  </Accordion>

  <Accordion id="q3" title="3.3 YiDA API を呼び出すとアプリの設定エラーが返される">
    YiDA API を呼び出した際にアプリの設定エラーが返される場合は、まず searchFieldJson パラメータで渡したクエリフィールドが、対応するフォームのデータ管理ページで検索対象に含まれているかをご確認ください。
  </Accordion>

  <Accordion id="q4" title="3.4 データ管理ページに「検索対象フィールドの設定」オプションが表示されない">
    この設定は、フォーム配下のデータ管理ページで行う必要があります。ご自身で作成した管理ページでは設定できません。
  </Accordion>
</AccordionGroup>