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

# 数据服务

> 本文介绍了数据服务的概念、定义方法及其在集成自动化和流程设计器中的应用。包括如何配置请求字段、数据过滤及排序规则，以及如何获取和消费数据服务。

| **能力** | **免费版** | **轻享版** | **专业版** | **专属-BI版** |
| ------ | ------- | ------- | ------- | ---------- |
| 数据服务   | 不支持     | 不支持     | 支持      | 支持         |

## 什么是数据服务？

数据服务是对数据集的加工处理，可选取特定字段并转为API接口服务，目前仅支持在集成自动化/流程设计器的卡片节点内消费。

<Note>
  **特别说明：**

  * 当存在多个独立的数据指标时，需要维护独立的数据服务，在集成自动化内单独消费

  * 数据服务仅应用主管理员、数据管理员可查看及操作。

  * 权限说明：

  * 消费范围：在集成自动化/简易版流程设计器内获取单条/多条数据节点，当数据获取方式为从数据工厂>数据服务中获取，可获得数据服务定义好的数据。
</Note>

## 定义数据服务

<Steps>
  <Step title="进入 数据工厂 > 数据服务， 单击 新建数据服务 按钮 ， 打开数据服务页面">
    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660223647104-35482618-5409-4e9a-b116-10d75b96a83b.png)
    </Frame>
  </Step>

  <Step title="参考以下操作进行服务设置" />
</Steps>

添加该数据集内的若干字段，如需在集成自动化等功能消费该字段，请勾选**是否返回**，另外可根据不同字段的数据类型配置该字段的统计方式（如计数、去重计数、最大、最小、平均、求和），同时支持创建公式字段

| **类型**                          | **函数名称**                                                                                                                                       |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **文本**                          | 不聚合、计数（是否去重）                                                                                                                                   |
| **日期**                          | 不聚合、计数（是否去重）、最大、最小                                                                                                                             |
| **数字**                          | 不聚合、计数（是否去重）、最大、最小、平均、求和                                                                                                                       |
| **array（如成员/部门组件）**<br /><br /> | 不支持聚合函数，只有不聚合选项。<br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660811132837-48c7e85c-7d4c-4104-956b-20ee8d956520.png) |

可针对当前数据服务所返回的数据进行过滤筛选。

过滤条件支持按**固定值**、**自定义变量**、**系统变量**进行过滤。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660811215096-0cb54bba-d1e8-49c1-9642-7b5c6ea3aeed.png)
</Frame>

可针对当前数据服务所返回的数据进行排序。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660223770783-6d85de63-a4dd-436b-94bc-9709707dc3c2.png)
</Frame>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660223778111-03312f51-fc3f-4c02-a0f1-4893ce72d027.png)
</Frame>

3. 单击 确定并预览 ，查看配置是否正确。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660651397271-7decb8e3-7193-4351-834c-e6a4ca779135.png)
</Frame>

## 获取数据服务

功能入口：集成自动化 > 简易版流程设计器 > 获取多条数据节点 > 获取单条数据节点 > 从数据工厂数据 > 服务数据。

在集成自动化新增获取多条数据节点，当数据获取方式为从**数据工厂**> **数据服务**中获取，可获得数据服务统计计算好的数据。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660223801687-92526be4-8ce7-403b-9630-575bed997fed.png)
</Frame>

## 消费数据服务

> **功能入口：集成自动化 / 简易版流程设计器 发送卡片节点/更新卡片节点  将获取数据服务返回的数据绑定到卡片数据源上**

<Steps>
  <Step title="进入卡片设计器，选择循环指标卡，定义数据源变量（对象数组）及配置mock数据，同时在组件属性板绑定指标值和指标名称">
    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660652346702-73e5bc38-b420-4981-8c9a-b2054cedaa7d.png)
    </Frame>

    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660652323495-676eb9f2-b298-452f-a312-8c7c91391644.png)
    </Frame>
  </Step>

  <Step title="步骤 2">
    集成自动化节点内新增发送卡片节点，选择定义好的酷数据卡片，卡片数据源的值设为字段，字段来源可直接消费上一个节点“从数据服务”中获取到的数据

    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1660223847204-70ec084a-862a-4bff-8b63-5da3fcccb1fc.png)
    </Frame>
  </Step>
</Steps>