表单对象

 将表单对象添加为函数的参数

Zoho Creator 支持可作为参数传递给用户定义函数的表单对象。表单对象表示表单中的一组记录。在下面名为“calculateNetPay”的函数中,emp 是表单对象,表示 Employee 表单中的一批记录。此表单对象作为参数传递给函数,通过对集合进行迭代来处理员工记录。

Void calculateNetPay(Employee emp)
{
for each emp1 in emp
{
emp1.NetPay=(emp1.BasicPay+emp1.HRA)-(emp1.PF+emp1.TAX);
}
}

  为表单对象参数传递值的不同方法:

示例 1:创建一个集合变量并将此变量作为表单对象来传递。例如,在下面的示例代码中,empRec 是集合变量,用于在 Employee 表单中保存具有指定条件的记录。您可以将传递具有排序和范围属性的员工结果集。

empRec = Employee[Designation == input.Designation] sort by Added_Time range from 1 to 5;
thisapp.calculateNetPay(empRec);

示例 2:在此格式中,您不能与员工结果集一起传递排序和范围属性。在这里,“ID”指的是记录编号。

thisapp.calculateNetPay(Employee[ID=input.ID]);

示例 3:这是作为表单对象值传递当前记录的简单方法。

thisapp.calculateNetPay(input.ID);

 使用在自定义动作中有表单对象的函数

使用表单对象作为参数的函数可在视图中配置为自定义动作。示例应用程序“Custom Action Example”演示这种场景。

关于应用程序

示例应用程序“Custom Action Example”包含以下表单和视图。

  • 用于输入员工详细信息的员工表单
  • 用于显示员工数据的员工视图。
  • 用于按百分比输入加薪的“晋升”和“加薪”表单。

为“Employee View”配置名为“PayHike & Promotion”的自定义动作,以便计算此视图中所选记录的加薪。自定义动作调用名为“showPayHikeForm”的函数,它将 Employee 表单作为表单对象参数传递给函数。

自定义动作

使用函数 showPayHikeForm Employee View 配置名为 PayHike & Promotion 的自定义动作,如下面的屏幕截图中所示。选定选项在报表头部显示动作,以便在视图中显示自定义动作。选定选项对记录集合执行动作,在这种情况下,仅在执行一批记录之后才调用自定义动作。只有使用 formobjects 作为参数的函数才支持此选项。

自定义动作显示在视图标头中,如下所示:

函数“showPayHikeForm”

函数“showPayHikeForm”定义为使用 Employee 表单作为函数的参数。该函数使用员工视图中所选记录的员工编号来构成 querystring,并使用查询字符串(选定的员工编号)打开附加的名为“Promotion and Pay Hike form”的无状态表单。下面给出函数代码作为参考。

void employee.showPayHikeForm(Employee employees)
{
querystring = "";
for each employee in employees
{
querystring = querystring + "empid=" + employee.ID + "&";
}
openUrl("#Form:Salary_HikeForm?"+ querystring, "popup window", "height=100,width=100");
}

“点击时”脚本

上述函数“showPayHikeForm”使用查询字符串(选定的员工编号)打开 Promotion and Pay Hike form(无状态表单)。以下脚本添加到此表单的“点击时”按钮。当用户提交加薪百分比时,querystring 会在此表单的 empid 字段(此字段配置为查找字段- 多选类型并在表单中隐藏)中更新。

在以下代码中,

  • | 是包含员工编号的列表。
  • 对于列表中的每个员工编号,从 Employee 表单中提取员工记录,并更新为新的薪水和新名称。
  • 员工视图显示新薪水和新名称。

l = input.empid;
for each emp in l
{
employeeinfo = Employee [empcode == emp];
newsalary = (employeeinfo.Salary * (1 + input.Pay_Hike / 100));
employeeinfo.Salary = newsalary;
if (input.Designation != "-Select-")
{
employeeinfo.Designation = input.Designation;
}
}
openUrl("#View:Employee_View", "same window");