Zoho Recruit 自定义函数通过执行简单程序脚本，帮助您更新相关 Recruit 模块或第三方应用程序中的数据。当记录匹配工作流条件时，工作流引擎自动触发自定义函数和更新 Recruit 记录。利用自定义函数，您可以使用 Deluge 编写脚本（由 Zoho Creator 提供支持）、将它们关联到工作流规则以及使业务流程自动化。另请参阅 Deluge 脚本 - 参考指南。

 业务场景

• 将每个商机（状态为“交易成功”）的金额累计为相关客户的总收益（自定义字段）。如果客户作出 10 次支付，则您可以从客户页面查看总收益，而不是创建报表。基于从客户产生的总收益，您可以将它们分级为 A 类、B 类、C 类客户。
• 当商机在 Recruit 中交易成功时，在 Zoho Projects 或任何第三方项目管理应用程序中创建项目。此外，在“客户”或“商机”记录下面查看项目链接以监测项目的进度。
• 基于父客户的邮寄地址自动更新联系人的地址信息。
• 当商机状态为“交易成功”时，将商机、相关联系人和客户详情推送到 Zoho Books 或任何第三方会计软件。一旦付款通知单的状态在会计软件中更改为“已付”，立即在 Recruit 中更新商机记录。

 目标受众

• 为用户设置工作流规则的 Recruit 管理员
• 具备 REST API 和 Deluge 脚本技能的编程人员

 可用性

 若要测试自定义函数集成

1. 根据您的工作流规则条件在 Zoho Recruit 中添加测试数据。
2. 通过您的应用程序中的自定义函数检查从 Zoho Recruit 收到的数据。
3. 如果未收到数据或数据不匹配，在 Zoho Recruit 中修改您的自定义函数代码。
4. 继续此测试，直至您的应用程序从 Zoho Recruit 获得期望的数据。

  重要提示

• 您可为每个工作流规则关联最多 6 个（1 个即时操作和 5 个定时操作）自定义函数。
• 在单个自定义函数调用中，您只可执行 5000 行（语句）。
• 您可以使用自定义函数从 Zoho Recruit 向第三方应用程序传输最多 10 个 Recruit 字段的数据。
• 您可以使用自定义函数来将其它应用的数据获取到 Zoho Recruit。
• 您必须依照第三方应用程序中的限制定期更新 API 工单。
• 如果由于第三方 API 中的任何问题导致自定义函数集成停止工作，您将不会收到任何邮件通知。
• 如果在连接到 Zoho Creator 服务时出现任何故障，自定义函数将在 15 分钟之后发送第二次通知。此后，系统将不会为该特定工作流触发发送任何通知。从 Zoho Creator 返回的错误显示在“失败原因”部分下面。
• 如果您超过每天的最大计数，系统将不会向第三方应用程序发送剩余的自定义函数通知，并将向管理员通知失败情况。 
• Zoho Recruit 将按照日期和日期时间字段的以下标准格式向第三方应用程序发送数据：
  • 日期：yyyy-MM-dd
  • 日期时间：yyyy-MM-dd hh:mm
• 自定义函数的限制：
  • 每天的调用数 - 10000 次调用/天或机构的每个用户许可 200 次调用。（以较低者为准）
  • 集成任务 - 使用 deluge，25000 次 Zoho API 调用/天。
  • 获取数据 - 25000 次调用/天
  • 发布数据 - 2 次调用/天
  • 发送邮件 - 1000 封邮件/天

 业务场景

将商机金额累计到父客户

汇总

将每个商机（状态为“交易成功”）的金额累计为相关客户的总收益（自定义字段）。如果客户购买 10 次，则您可以从客户页面查看总收益，而不是创建报表。稍后您可以基于来自客户的收益将它们分级为 A 类、B 类或 C 类客户。

若要配置此自定义函数，请按照以下步骤操作：

1. 1. 登录至 Zoho Recruit。
   2. 打开设置 > 设置 > 自动化 > 工作流自动化 > 规则 > 为商机模块创建工作流。
   3. 点击下一步。
      
   4. 选择您想在何时执行此规则。现在选择基于一条记录操作 执行下面的创建或编辑选项。
      
   5. 点击完成。
   6. 选择您想对其执行此规则的记录。选择匹配条件的记录 选项并将条件设置为“阶段包含交易成功”。
      
   7. 点击完成。
   8. 现在点击即时操作 并选择自定义函数。
      
   9. 在配置自定义函数 弹出窗口中，点击库链接。
      
   10. 在库 页面中，点击 Roll-up Potential Amount to Account 函数的配置。
       
   11. 按如下所示为参数指定值：
       • AccountId：从字段列表中选择“客户 ID”列。
       • SumUpField：指定您在客户模块中拥有的字段以用于求和。
       • 点击“指定自定义值”链接并键入您的字段名称。

        

       

   12. 保存配置。现在系统将自动更新客户模块中的一个客户的所有商机产生的收益总和。

 请参阅错误代码

当自定义函数执行失败时，会在 Zoho Recruit 中显示以下错误消息之一：

 HTTP 状态码

• 400 错误请求 - 通常是缺少必需的参数。
• 401 未经授权 - 未提供有效的 API 密钥。
• 402 请求失败 - 参数有效，但请求失败。
• 404 未找到 - 请求的项不存在。
• 500, 502, 503, 504 服务器错误 - 第三方应用程序发生错误。
• 错误代码 1 - 暂时不能连接到 API 服务器。为从 Recruit 发送的请求检查 API 服务器日志和防火墙设置。

 自定义错误

• 内部处理故障 - 当由于在处理脚本时出现错误而导致未执行自定义函数时。
• 达到日限制 - 当公司已达到一天的最大限制时。
• Deluge 脚本 - 当由于 Deluge 脚本中出错而导致工作流执行触发失败时。