聚合记录
概述
聚合记录任务支持计算表单字段值的 SUM/COUNT/AVG/MIN/MAX。这将帮助在不迭代记录的情况下创建应用程序。
示例使用 julymonthsales = Order_Info[Month == 7].sum(amount);
- Count:返回表单中所有或特定记录的计数。
- Sum:返回表单中所有或选定记录的数值字段总和
- Average:返回表单中所有或选定记录的数值字段的平均值
- Maximum:返回表单中所有或选定记录的数值/日期-时间字段的最大值
- Minimum:返回表单中所有或选定记录的数值/日期-时间字段的最小值
- Distinct:返回表单中字段的不同值。
语法
Count 函数
//数出表单中所有记录的总数
<variable> = <Form_LinkName>.count();
//数出具有给定条件的特定记录的总数
<variable> = <Form_LinkName>[criteria expression].count();
其中,
<variable> 指的是用户定义的变量名称或表单字段。
示例 1
//数出表单中所有记录的总数
input.Total = FormA.count();
//数出具有给定条件的特定记录的总数
input.Food_Expenses = FormA[Expense == "Food"].count();
其中 FormA 是表单链接名称
示例 2
比如说您有一个具有日期字段的表单。若要提取特定日期添加的记录,请将以下代码添加到所需的表单动作块:
其中,
Day_count 是用于保存 2014 年 9 月 7 日的记录计数的变量。
Form 是表单链接名称。
Date_field = "07-Sep-2014” 是条件,其中 Date_field 是表单中的日期字段。
您可以替换日期值,使用 input.Date_field 选择表单中输入的日期值。
Sum 函数
//计算表单中的数值字段的总值
<variable> = <Form_Name>.sum(<Numeric Field Name>);
//计算具有给定条件的特定记录的总数
<variable> = <Form_Name>[criteria expression].sum(<Numeric Field Name>);
其中,
<variable> 指的是用户定义的变量名称或表单字段。
示例:
//求得总销售价值
Total_Sales = FormA.sum(Amount);
//求得 Item="Printer” 的总销售价值
ItemA = FormA[Item == "Printer"].sum(Amount);
Average 函数
//求得所有记录的数值字段的平均值
<variable> = <Form_Name>.avg(<Numeric Field Name>);
//求得特定记录的数值字段的平均值
<variable> = <Form_Name>[criteria expression].avg(<Numeric Field Name>);
其中,
<variable> 指的是用户定义的变量名称或表单字段。
示例:
//求得所有记录的平均值
Avg_Sales = FormA.avg(Amount);
//求得 item="Printer” 的平均销售值
Avg_Sales_ItemA = FormA[Item == "Printer"].avg(Amount);
Maximum 函数
//求得所有记录的数值字段的最大值
<variable> = <Form_Name>.maximum(<Numeric Field Name>);
//求得特定记录的数值字段的最大值
<variable> = <Form_Name>[criteria expression].maximum(<Numeric Field Name>);
其中,
<variable> 指的是用户定义的变量名称或表单字段。
示例:
//求得所有记录的最高销售价值
Highest_Sale_Val = FormA.maximum(Amount);
//求得 "Printer” 的最高销售价值
Highest_Sale_Val_ItemA = FormA[Item == "Printer"].maximum(Amount);
Minimum 函数
//求得所有记录的数值字段的最小值
<variable> = <Form_Name>.minimum(<Numeric Field Name>);
//求得特定记录的数值字段的最小值
<variable> = <Form_Name>[criteria expression].minimum(<Numeric Field Name>);
其中,
<variable> 指的是用户定义的变量名称或表单字段。
示例:
//求得所有记录的最低销售价值
Highest_Sale_Val = FormA.minimum(Amount);
//求得 "Printer” 的最低销售价值
Highest_Sale_Val_ItemA = FormA[Item == "Printer"].minimum(Amount);
Distinct 函数
//从表单获得不同字段值 <list-variable> = <Form_Name>.distinct(<fieldname>);
//从表单获得给定条件的不同字段值 <list-variable> = <Form_Name>[criteria expression].distinct(<fieldname>);
其中,
<list-variable> 指的是用户定义的列表变量名称或表单字段。
使用脚本构建器
聚合记录任务可从脚本构建器配置,如下面给出的步骤中所指定:
- 从左侧拖移聚合记录任务(正如下面的屏幕截图所突显的那样)。点击“编辑”按钮以配置聚合记录对话框中的值。
- 声明一个变量或选择字段名称作为变量以存储聚合记录任务返回的值。
- 从选择表单列表中显示的表单列表中选择表单。
- 指定所需的条件如果未指定条件,则聚合函数将对所有记录执行。
- 从列表中选择聚合函数以及将要执行该函数的字段名称。
- 点击完成并保存脚本。