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

# データサービス

> DingTalk YiDAのデータサービスの定義方法と活用方法を解説します。統合と自動化やワークフロー設計におけるリクエストフィールドの設定、データの絞り込み、並べ替えルールの定義、データサービスの取得と利用まで、専門的な運用手順を紹介します。

| **機能**  | **Freeプラン** | **ベーシック版** | **プロフェッショナル版** | **Dedicated-BI版** |
| ------- | ----------- | ---------- | -------------- | ----------------- |
| データサービス | 非対応         | 非対応        | 対応             | 対応                |

## データサービスとは

データサービスとは、データセットから特定のフィールドを選択して加工し、APIとして公開する機能です。現在、統合と自動化またはワークフローデザイナー内のカードノードでのみ利用できます。

<Note>
  **注意事項:**

  * 複数の独立したデータ指標が必要な場合は、それぞれ個別のデータサービスを用意し、統合と自動化で個別に利用してください。

  * スーパー管理者およびデータ管理者のみが、データサービスの表示と管理を行えます。

  * 権限:

  * 利用スコープ: 統合と自動化または簡易ワークフローデザイナーの「単一レコードの取得」または「複数レコードの取得」ノードで、データソースを「データファクトリ > データサービス」に設定すると、データサービスで定義したデータを利用できます。
</Note>

## データサービスの定義

<Steps>
  <Step title="「データファクトリ > データサービス」に移動し、「データサービスの作成」をクリックしてデータサービスページを開きます。" />

  <Step title="以下の説明に従ってサービスを設定します。" />
</Steps>

データセットから追加したいフィールドを選択します。統合と自動化やその他の機能でフィールドを利用可能にするには、**Return** を選択します。また、フィールドのデータ型に応じて集計方法（カウント、固有値カウント、最大値、最小値、平均、合計など）を設定したり、数式フィールドを作成したりすることもできます。

| **タイプ**                              | **関数**                             |
| ------------------------------------ | ---------------------------------- |
| **テキスト**                             | 集計なし、カウント（重複排除あり／なし）               |
| **日付**                               | 集計なし、カウント（重複排除あり／なし）、最大値、最小値       |
| **数値**                               | 集計なし、カウント（重複排除あり／なし）、最大値、最小値、平均、合計 |
| **配列（ユーザーや部門コンポーネントなど）**<br /><br /> | 集計関数は非対応です。「集計なし」のみ利用できます。         |

現在のデータサービスから返されるデータを絞り込めます。

絞り込み条件は、**固定値**、**カスタム変数**、**システム変数**に対応しています。

現在のデータサービスから返されるデータを並べ替えられます。

3. **確認してプレビュー**をクリックし、設定内容を検証します。

## データサービスの取得

エントリポイント: 統合と自動化 > 簡易ワークフローデザイナー > 複数レコードの取得ノード > 単一レコードの取得ノード > データファクトリから > データサービス。

統合と自動化に「複数レコードの取得」ノードを追加します。データソースを **データファクトリ** > **データサービス** に設定すると、当該ノードはデータサービスで算出された集計データを返します。

## データサービスの利用

> **エントリポイント: 統合と自動化または簡易ワークフローデザイナーのカード送信ノードまたはカード更新ノード。データサービスから返されたデータを、カードのデータソースにバインドします。**

<Steps>
  <Step title="カードデザイナーを開き、ループ指標カードを選択し、データソース変数（オブジェクト配列）を定義してモックデータを設定します。続いて、コンポーネント属性パネルで指標値と指標名をバインドします。" />

  <Step title="ステップ2">
    統合と自動化ワークフローにカード送信ノードを追加し、定義済みのクールデータカードを選択して、カードのデータソース値をフィールドに設定します。このフィールドは、前のステップの「データサービスから」ノードで返されたデータから直接取得できます。
  </Step>
</Steps>