使用函数创建验证规则

使用函数创建验证规则

通过使用函数，您可创建验证规则，在此规则中，用户输入的值需要在 CRM 数据库之外进行验证。您也可以通过在函数中引用相应模式来验证特定形式的电话号码、邮政编码等字段。例如，您可编写函数来验证帐号字段，例如，仅接受以下形式的值：xxx-999-x00。由于帐号是机密数据，并且很可能存储在政府数据库或银行存储库中，因此您必须允许 CRM 验证第三方数据库中的数据形式，并在不匹配时发出提醒。

场景
您从事零售业务，并使用第三方物流来提供送货上门和批量装运服务。每次装运使用 10 位数物流编号（存储在物流数据库中）来进行物流跟踪。当销售代表在 CRM 中输入错误的编号时，不予保存该记录，避免客户查询时发生不必要的问题或延迟。您可以使用函数来验证“物流编号”字段，以便在物流公司的数据库中验证该值是否完全匹配。仅当销售代表输入使用验证规则中提及的相应格式 (xxx-9999999999)的 10 位数字值时，才会保存该记录，否则将发出提醒消息，提示该数据为无效数据。 



/* The snippet below shows you how to get a list of fields, their values from a MAP object.The fields’ values can be obtained from the same MAP object.*/
entityMap = crmAPIRequest.toMap().get("record");
/* The example below demonstrates how a field’s value (email) can be obtained from a MAP object.Here, entityMap - Map Object, Email - Field's API name
Sample entityMap= {'Email': 'xxx@xxx.com', 'Last_Name': 'xxx'}; */
referenceField= entityMap.get("Reference_Number"); // Reference_Number is the API name for "Reference number" field.
response = Map();
/* ---------------------------------------------------------------------------------------------- */
Start writing your code here to perform the necessary field validation *
/* ---------------------------------------------------------------------------------------------- */
/* If the code identifies a validation error, set the status and alert message as shown below: */
if(referenceField.matches("[A-Z]{3}-[0-9]{10}")) {
      response.put('status','error');
      response.put('message', 'Invalid Reference Number');
} else {
/* If there are no errors found during validation, set the status as shown below: */
      response.put('status','success');
}
/* ---------------------------------------------------------------------------------------------- */
return response.toString();
注
  1. 您可以通过编写简化验证规则的函数，将现有记录的基于条件的验证规则更改为基于函数的验证规则。
  2. 可创建的验证规则总数取决于所订阅版本。在规则/模块总数中，对于旗舰版，您可使用函数创建 3 个验证规则，对于超级版，您可使用函数创建 5 个验证规则。要了解每个版本可创建的规则总数，请查看功能可用性页面。
  3. 只有在基于条件的验证规则中受支持的字段才会同时显示在基于函数的规则中。
  4. 为避免函数执行失败，建议进行空值检查，因为有时字段为空白（没有值的字段）。 
  5. 该函数的返回值应如样本代码中所述。除上述返回值外的任何值都将被视为错误。
  6. 字段值只能以 API 格式在函数内部提供。要访问这些值，您可使用字段 API 名称。
  7. 验证规则在 Zoho CRM 手机应用中也将适用。但是，无法从手机应用创建规则。
  8. 如果函数执行失败，系统会提醒您检查以下可能原因：
    1. 代码中存在逻辑错误。
    2. 执行超时导致函数执行失败。
    3. 如果问题仍然存在，请联系 support-crm@zohocorp.com.cn 以获取帮助。

要使用函数创建验证规则，请执行以下操作：
  1. 转至设置 > 定制 > 模块与字段。
  2. 将光标放在 模块 上，点击 更多 图标并选择设置验证规则。
  3. 在 验证规则 页签下，点击新建验证规则。
  4. 在 创建验证规则 页面的选择要验证的字段下，从下拉列表中选择某个字段。
  5. 在选择验证类型中，选中使用函数验证。
  6. 点击下一步。

  7. 在 配置函数 页面中，执行以下任一操作：
    1. 点击函数 > 选择函数 > 配置 > 保存。
    2. 点击创建您自己的函数 > 输入函数 > 保存。
  8. 点击保存。 
注
在CRM里（在“函数”页签中）下创建的函数可与验证规则相关联。 
  1. 转至设置 > 开发者空间 > 函数 > 创建新的函数。
  2. 在 分类 中，从下拉列表中选择验证规则。


    • Related Articles

    • 使用函数创建验证规则的用例

      如果在字段中输入特定术语，请将详细描述设置为必填项 Zylker Tech 生产电子组件和其他类似产品。他们的制造项目的质量检查被外包给第三方服务提供商进行。评估结果通过评估报告与生产经理共享。表单中的重要字段经常或者留为空白，或者给出模糊描述。信息的缺乏导致频繁来回通信，从而导致进一步处理的延迟，并且会在他们规划对流程即兴计划实施细节时产生问题。为在将来的报告中避免此类问题，生产经理决定进行检查，以提示用户每当在字段中输入特定术语时应输入详细描述。 以下是需要为所需结果配置的验证规则：  ...