自定义流程变量用于保存流程运行过程中的临时数据，并在后续节点、后动作和分支条件中使用。例如，将 APL 函数的计算结果保存下来，再根据结果决定流程走向。
使用范围
- 支持审批流和业务流。
- 变量只属于当前流程定义，其他流程定义不能使用。
- 变量在 变量管理 中创建，在后动作中赋值，在分支条件中引用。
- 修改变量配置后立即生效，并可能影响已引用该变量的节点。
配置变量
在流程编辑器右上角点击 变量管理，可以搜索、添加和编辑变量。
变量信息
| 配置项 | 说明 |
|---|---|
| 变量名称 | 流程中显示的名称，必填，最多 50 个字符。内容过长时列表以省略号显示，悬停可查看完整名称。 |
| API Name | 变量的唯一标识，必填，最多 20 个字符。不能包含中文或特殊字符，不能与已有变量重复。系统会自动生成，也可以修改。 |
| 数据类型 | 变量保存的数据类型，必填。 |
| 默认值 | 变量没有被赋值时使用的值，可不填写；不填写时为空。默认值必须与数据类型匹配。 |
| 使用节点 | 自动显示引用该变量的节点和分支条件。 |
支持的数据类型：
| 类型 | 适用数据 |
|---|---|
string（字符串） |
文本、字母、数字或符号 |
boolean（布尔值） |
是或否 |
integer（整数） |
不带小数的整数 |
number（数值） |
整数或小数 |
list（数组） |
由多个元素组成的列表，如字符串数组、数字数组 |
保存变量后，列表会显示变量名称、API Name、数据类型、默认值、使用节点和操作。已被节点引用的变量不可删除；如需删除，请先移除相关引用。
给变量赋值
操作步骤
- 打开需要配置的流程节点，进入 后动作。
- 选择 变量赋值，点击 添加。
- 选择要赋值的变量。
- 选择赋值方式并填写值。
- 保存后动作配置。
赋值方式
固定值：系统默认带出变量的默认值，可以在本次后动作中修改。此处修改不会改变变量管理中的默认值。
函数：点击 添加 APL 函数，进入函数配置。函数需要返回所选变量对应的值和数据类型；可以复制、编辑或删除已配置的函数。
配置多个变量时，可以使用一个函数一次返回多个变量。函数返回值为空、缺少某个变量，或返回类型不匹配时，对应变量无法得到有效值。
同一流程中多次给变量赋值时，后执行的赋值会覆盖先前的值。后动作执行时优先使用本次赋值；变量没有被赋值时，才使用变量管理中的默认值。
在分支条件中使用变量
配置分支条件时，在变量选择器中选择 自定义变量，即可使用当前流程定义中已创建的变量。
如果还没有自定义变量，页面会提示“暂无自定义变量，请先添加”。点击 + 添加 可进入变量管理；创建完成后，变量会出现在自定义变量列表中。
运算符
| 数据类型 | 可用运算符 |
|---|---|
| 字符串 | 包含、不包含、等于、不等于、为空、不为空 |
| 整数、数值 | 等于、不等于、大于、小于、大于等于、小于等于、为空、不为空 |
| 布尔值 | 等于、不等于、为空、不为空 |
| 数组 | 等于、不等于、为空、不为空 |
使用函数得到的变量通常用于判断是否有返回值，只支持 为空 和 不为空。
业务流分支节点还可以配置：
- 条件名称：必填，最多 50 个字符；新建时默认填充条件名称。
- 条件详情：展示已配置的变量、运算符和比较值。
查看执行结果
流程运行到使用变量的节点时，会同步获取变量值。执行期间，节点显示“正在获取流程变量（Getting process variables）”。执行结果可以在审批节点和流程日志中查看。
函数执行失败时，节点会提示“流程变量执行失败，请联系CRM管理员修改配置”。具备相应权限时，可以选择 重试 或 跳过；处理后请在流程日志中确认实际结果。
重新执行流程时的变量值
- 重新发起并生成新实例时，原实例中的变量赋值不会带入新实例。
- 返回当前节点时，中间被跳过节点的赋值继续保留。
- 被驳回节点重新执行时，该节点的赋值会清空，需要重新赋值。
配置建议
- 先在变量管理中完成变量定义，再配置赋值和分支引用。
- API Name 使用稳定、易识别的英文标识；修改前先查看“使用节点”。
- 选择数据类型时，同时确认默认值和 APL 函数返回值的类型。
- 配置完成后，至少验证一次正常流转、函数返回为空和函数执行失败的情况。