自定义变量

更新时间:
复制 MD 格式

自定义变量用于对事件字段的加工,快速产出需要的数据结果。例如对手机号取前3位、对浮点数保留2位小数、计算字符串长度等。通过自定义变量功能,您可以按照业务需求灵活快速配置。本文向您介绍如何应用自定义变量功能。

新增自定义变量

在变量中心-变量管理页面,选择自定义变量管理页面,点击新建自定义变量按钮。

配置自定义变量

在创建自定义变量过程中,需要配置以下变量属性:

  • 关联事件:必填。选择该变量作用的事件,事件的挑选会影响字段的使用。且创建成功后该自定义变量只能应用于该事件。

  • 变量名称:必填。名称需要具备唯一性。

  • 变量描述:非必填。对变量内容、逻辑的具体说明。

  • 变量类型:变量计算结果的数据类型,支持字符型、浮点型、整型、布尔型。

  • 异常值:变量计算异常情况下的默认返回值,选择变量类型后系统会推荐一个异常值。

  • 计算表达式:通过系统支持的函数撰写计算表达式。在函数说明中,可以查看当前支持的所有函数、及其解释。

例如,计算表达式 #substr(@手机号,1,3) 表示使用 substr 函数截取手机号字段从第1位开始、长度为3的子串。表达式中以 @字段名 引用事件字段,以 #函数名(参数) 调用函数。右侧函数说明面板展示所选函数的入参类型、返回值及调用示例。

配置好计算表达式后,需进行测试,测试通过的情况下才能保存该变量的配置信息。

例如,关联事件选择注册事件,变量名称填写手机号前3,变量类型选择字符型,异常值填写SYS_ERROR,计算表达式填写#substr(@手机号,1,3)。单击计算表达式旁的测试按钮,在弹出的自定义变量测试对话框中输入变量参数值(如手机号填写35712345678),单击测试查看计算结果(返回357),验证表达式逻辑正确后保存配置。

应用自定义变量

在策略计算逻辑配置中,左变量可选择自定义变量模块,并从中选出已完成配置的自定义变量。

重要

自定义变量仅会展示在配置的关联事件中,如在左变量选择时找不到自定义变量,建议查看关联事件是否配置错误。