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

# SUM

> SUM函数用于求和计算，支持子表单列数据求和。适用于宜搭的多种场景如表单、流程设计、集成自动化等。通过给定数字列表作为参数，返回这些数值相加后的总和。提供使用示例及实现特定条件下的求和技巧。

SUM函数用于求和计算，支持子表单列数据求和。

## 支持产品场景

SUM函数支持在宜搭的以下场景中使用。

* 表单（主表字段）
* 表单（业务关联规则）
* 表单（校验）
* 流程设计（校验规则）
* 流程设计（关联操作）
* 集成自动化
* 流程-节点
* 连接器

## 格式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
SUM(number1,number2...numberN)
```

## 属性说明

| 属性     | 是否必填 | 说明                                                                             |
| ------ | ---- | ------------------------------------------------------------------------------ |
| number | 是    | 数字类型，进行求和的数据，多个数字之间使用英文逗号分隔。<br />**说明**：如需计算子表单某列数据的加和，只需将对应字段作为SUM函数的入参输入即可。 |

## 返回值

| 返回值类型 | 说明        |
| ----- | --------- |
| 数值    | 多个数相加后的和。 |

## 使用示例

* 计算多个数值组件的和。

如下图所示，使用`SUM()`函数计算`数值 1`与`数值 2`的和。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1704334045354-caca67ca-1dd7-4ae5-b174-61d3e6a54553.png)
</Frame>

* 计算子表单某一列数据的和。

如下图所示，使用`SUM()`函数计算计算出差补贴总金额。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1704334301293-40a91e9b-a902-488d-9469-2a24781f181f.png)
</Frame>

## 体验

求多个数值组件和或者计算出子表单多条明细的数值组件和。

## 小技巧

因暂未提供 `sumif`函数，因此你可以参考以下方式实现类似效果。

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sum(
  if(
    eq(子表单.下拉菜单, "场地费"),
    子表单.租金小计,
    0
  )
)
```