如何...

• 设置函数
• 使用 REST API 调用函数
• 在工作流规则中部署函数
• 请参阅错误代码
  • HTTP 状态码
  • 自定义错误
• 一些常用函数的示例
  ​[相关主题]

设置函数

可在 5 个位置设置函数：

• 创建独立函数。
• 使函数与工作流规则相关联。
• 通过在计划中添加函数来使用函数。
• 将函数设置为在点击自定义按钮时执行。
• 使函数与相关列表相关联。

要创建函数，请执行以下操作：

1. 转至设置 > 开发者空间 > 函数。
2. 在函数页面中，点击 +创建新函数。
3. 选择要添加函数的位置。
   
4. 点击下一步。
5. 在创建函数页面中，执行以下操作：
   • 给出函数的名称和描述（可选）。
   • 点击编辑参数。
   • 使用 CRM 模块中的字段名称或自定义值来设置要在脚本中使用的参数。
     
   • 在 Deluge 脚本编辑器中编写所需函数。
     
   • 点击保存并执行脚本以验证代码。
   • 点击保存。
6. 点击保存。
   该函数将列示在函数页面的“列表视图”中。
   请注意，指定为用于特定位置的函数不能用于其他位置。例如，为“工作流规则”配置的函数不能用于“计划”。

使用 REST API 调用函数

除常规功能外，函数允许您在 CRM 中具有其他功能。函数需要触发器来调用。触发器可为工作流、蓝图、相关列表形式，或通过点击按钮来触发。

如果函数需要在不使用这些方法的情况下或从外部源触发，则您可以创建独立函数并以 API 调用的形式提供。通过 REST API 触发函数，这允许您在 Zoho CRM 中的任意位置或任意第三方应用程序触发该函数。

用作 API 调用的样本函数：

一个表单，此表单使用以表单输入形式给出的信息在 CRM 中自动生成线索。

第 1 步：

使用以下代码创建一个独立函数。

第 2 步：

要以 API 形式提供函数，请执行以下操作：

1. 转至设置 > 开发者空间 > 函数。
2. 对需要以 API 形式出现的相应函数点击设置图标。
3. 点击 REST API。
   
4. 为自定义函数设置 API 名称。
5. 启用 OAuth2.0 和 API 密钥滑块。
6. 点击保存。
   

第 3 步：

此处的样本显示为使用 Zoho Creator 创建的表单。创建表单以使其包含以下字段：“FirstName”、“LastName”、“Company”和“Mobile”。编写函数以使其在点击提交按钮时执行。

结果：

点击提交按钮后，系统将执行该函数，并在您的 CRM 中创建线索。该线索包含表单中给出的详情。

Postman 中的函数：

以 API 调用形式提供的函数可用 POSTMAN 应用程序进行测试。但是，当在该应用中执行函数时，有一些需要记住的事项。

• 当前将函数用作 API 的受支持方法为 GET 和 POST。
• 在 POST 请求的“Body”部分中，选择“form-data”。
• 创建名为“arguments”的键，并将值设置为输入 JSON 对象。
• 还可在 URL 中以 arguments={encoded_arguments} 形式给出参数。
• POST 请求 - 参数限制
  • 在请求 URL 中 - 5000 行
  • 在 body 中 - 95000 行（作为 JSON 对象）

“Body”中的样本参数：

在工作流规则中部署函数

要使函数与工作流规则相关联，请执行以下操作：

1. 转至设置 > 自动化 > 工作流自动化 > 规则。
2. 在工作流规则页面中，点击创建规则。
3. 在创建新的规则页签中，指定工作流规则参数。
4. 在即时操作下，选择函数。
   
5. 在配置函数页面中，从库 > 函数（由您的机构中的用户创建）中选择函数，或使用 Deluge 脚本编写您自己的函数。
6. 点击函数（由您的机构中的用户创建）。
   
7. 选择要触发的函数并点击配置。
   
8. 在配置自定义函数页面中，完成以下步骤：
   • 选择要关联的模块。
   • 在参数映射分栏中，将该参数映射至 CRM 模块中的字段名称。
     
   • 点击保存并关联。
     现在可使库自定义函数与工作流规则相关联。
9. 在工作流规则页面中点击保存。
   现在，您的定制函数将与工作流规则相关联。触发工作流规则后，将自动执行自定义函数。