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

# 関連検索

> 本記事では、フォームにおける関連検索コンポーネントの活用について、利用シーン、機能説明、フィールド属性、および注意事項を紹介します。このコンポーネントは効率的なデータクエリ表示をサポートし、人事OA管理システムなどさまざまなデータクエリシーンに適用できます。

## 使用シーン

コアフォーム内で他のフォームのデータをクエリします。以下のような幅広いデータ参照シーンに適用できます。

● HR OA管理システムにおいて、プロフィールホームページ上で自身の社員レコード、会議予約レコード、勤怠レコードなどのデータを閲覧できます。

| **変更前（設定が複雑、レコード数制限あり、ネストクエリ非対応）**<br />例えば、「製品」に紐付く原材料テーブルは現在サブフォームとして実装されています。**サブフォームは500件までに制限されており**、**サブフォーム内にさらに関連するサブフォームをネストすることはできません。** | **変更後（シンプル・直接的・効率的で理解しやすく、データ容量が大きく、再帰的なネストクエリに対応）**<br />「関連クエリ」コンポーネントを直接参照することで、関連するテーブルから詳細情報を取得・表示できます。サブフォーム内の各フィールドについてデフォルト値のデータ連動を設定する必要はありません。これによりベストプラクティスの設定効率が向上し、運用・理解のコストが削減され、サブフォームのデータに対する関連クエリにも対応します。 |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### 1. フィールド概要

関連クエリは独立したクエリ・表示機能です。他のフォームから1件または複数件のレコードを自動的に取得しますが、データベースには保存しません。

**コンポーネントの利用範囲：**

1. YiDAのすべてのエディションに対応しています。（クロスプラットフォーム互換）
2. YiDAの通常フォームおよびワークフローフォームのページタイプに適用されます。カスタムページには現時点で非対応です。
3. 本コンポーネントの動作特性上、データベースへのデータ送信を必要としない純粋なデータ参照・閲覧シーン向けに設計されています。そのため、現時点ではフォーム詳細ページでのみ利用可能です。その他の機能画面（データ管理ページなど）では、本コンポーネントは提供されていません。
4. ドロップダウン単一選択や複数選択などのコンポーネントの表示/非表示ロジックから、「関連クエリコンポーネント」を参照できます。

### 2. フィールド属性

#### 2.0 一般属性

関連クエリコンポーネントの一般属性は以下のとおりです。

1. タイトル
2. ステータス：通常 / 閲覧のみ / 非表示
3. データがない場合に表示するコンテンツ：カスタム対応

#### 2.1 関連属性

関連フォームを選択します。同一アプリ内および他アプリ間の関連付けの両方に対応しています。

#### 2.2 フィールドを表示

<Steps>
  <Step title="フィールドを表示：関連クエリを通じてターゲットフォームからフィールドを取得・表示" />

  <Step title="追加した表示フィールドは、並び替え・名前を変更・削除などの操作に対応" />
</Steps>

#### 2.3 データフィルタリング

関連クエリで返されたレコードにフィルターを適用します。フィルター条件に一致したレコードが該当フィールドに表示されます。

#### 2.4 表示レコード件数

関連クエリ結果の表示方法として「単一レコード」または「複数レコード」を選択します。

a. 「単一レコード」：関連する詳細情報の参照に適しています。送信順序で最も新しく送信されたレコードを表示します。

b. 「複数レコード」：関連するリスト参照に適しています。フィルターおよびその他の条件に一致するすべてのレコードがリストにまとめて表示されます。

i. 関連フォームがワークフローフォームの場合、インスタンスステータスが「完了」のレコードのみがクエリ対象となります。

#### 2.5 関連するテーブルの操作

関連フォームにデータがない場合、表示モードが「複数レコード」に設定されているときは、関連するテーブルに対して「レコード作成を許可」を選択します。これにより、リスト内からターゲットフォームへ直接レコードを追加できるようになります。

⚠️ 注意：現在の関連フォームがワークフローフォームの場合、レコードの追加には対応しておらず、ステータスが「完了」のレコードのみが表示されます。

### 3. 注意事項

1. 関連クエリのリストには最大5,000件のレコードが表示されます。
2. 関連クエリでワークフローフォームのデータを検索する場合、ワークフローステータスが「完了」のレコードのみが返されます。
3. ページ上に本コンポーネントが存在する場合、パブリックアクセスを有効にすることはできません。
4. 関連コンポーネントで返されるレコードは、フォームのフィールド権限およびデータ権限のスコープを継承します。
5. 関連フォームが削除されている場合、次のエラーメッセージが表示されます。