填表公式:数据源-明细

什么是数据源

【数据源】可从模板的数据接口、系统内设的全局数据接口、新建表单、打开表单、本表单明细等获取数据，并将获取到的数据传给后续的操作中使用。返回的数据是一个二维表（结构类似明细表），一行表示一条记录，一列表示一个数据项。

数据源的作用

【数据源】的作用是给后续的操作提供数据，首先会取出二维表中第一条记录，驱动操作的执行一次，在操作中可以访问该条记录参与计算，操作完成后，【数据源】会取下一条记录继续驱动操作执行，以此类推，直至所有数据消耗完。
数据源中有多少条记录，则驱动操作执行多少次。
例如【数据源】查出三条记录，那么新建表单操作就会执行三次，创建三张表单。

数据源-明细

本表单的明细可以作为操作的数据源，为后续操作提供数据。

●【过滤条件】
填入表达式，对数据源（本表单的明细）中所有的记录进行过滤。

●【显示对话框】
若不勾选该项，数据源所有过滤后的记录都会被使用；
若勾选该项，会显示对话框，只有被选中的记录会被使用。

●【可多选】
勾选【显示对话框】才可见该项。
若勾选该项，在对话框中可以选中多条记录；
若不勾选该项，每次只能勾选对话框中的一条记录。

●【多选时合成记录为一条】
被选中的多条记录会合并成一条记录，结果只返回一条记录。
●【包含被隐藏的行】
若勾选该项，在对话框中显示的记录包含明细中被隐藏的行；
若不勾选该项，在对话框中显示的记录不包含明细中被隐藏的行。

支持在客户端、移动端运行。

示例

新建一张《采购入库单》后输入明细中的金额，总金额自动进行合计。

1. 在“采购入库单”模板表单设计界面中单击【填表公式】，在弹出的“填表公式管理”对话框中找到“值变化”事件，添加数据项——本表单明细的“金额”。

2. 为了在本表单明细的“金额”在值变化的时候能给“总金额”赋值。因此，我们在刚刚添加的数据项下面添加一个“赋值”操作。

3. 【名称】改为“赋值_金额合计”。

4. 为了将“明细”中的“金额”进行合计，我们将“明细”作为【数据源】。

5. 接着，给本表单的“总金额”赋值。每次“明细”的“金额”发生变化，【数据源】都会取出“明细”中第一条记录，驱动“赋值”操作执行一次，给“总金额”完成第一次赋值后，【数据源】会取下一条记录继续驱动操作执行，以此类推，直至所有数据消耗完，得到所有“金额”相加的“总金额”。因此，“总金额”绑定表达式“本表单.总金额 + 数据源.金额”。

6. 由于明细“金额”的值一发生变化，就会驱动“赋值”操作执行，“总金额”就会不断累加，得出的结果就会有误。因此，我们还需要添加一个用来清空上次计算的“总金额”的“赋值”操作。

7. 【名称】改为“赋值_清空合计金额”。

8. 清空“总金额”的值，给“总金额”赋“0”值。

9. 将该操作提到“赋值_金额合计”操作之前执行。先进行清空已存在的“总金额”的值后，再对明细中的“金额”进行合计。

10. 单击【确定】后，调试一下效果。