参数赋值

1 概述

1.1 版本

1.2 应用场景

通过自定义参数解决流程中需要动态改变参数值的场景。
比如：
1）上游节点运行的结果，在下游节点中使用。
2）基于某些节点的运行结果，应用在一些条件判断的场景中。

1.3 功能简介

【参数赋值】可以通过[数据来源]将需要赋值的数据取出，并将数据表的行列数据为参数赋值，将获取到的数据输出为参数，供下游节点使用。

2 功能说明

配置项包括：输出参数和数据来源。具体功能说明如下：
1、输出参数
可选择任务参数，将[数据来源]中获取的数据表的行列数据赋值给该参数。如下图所示：

具体功能说明如下：
1）任务参数
输出的参数需要先通过工具栏中的“参数”定义任务参数，如下图：

全局定义好之后，此处选择对应的任务参数即可。

注：同一个参数赋值节点中多个输出参数不支持选择同一个任务参数。

2)值类型
支持来源于常量、表达式和数据源字段。
选择“常量”或“表达式”时，输入对应的参数值即可；
选择“数据源字段”时，需要先切换到“数据来源”Tab进行数据源配置，然后在此处指定数据来源中获取的行列数据作为参数的实际值，支持指定某一行数据、某一列数据或某个单元格值三种。
比如，选择第二列“产品名称”的所有数据，配置如下：

这里的值是用于任务运行时使用的参数值。

注：【参数赋值】中单个参数输出的字段值个数限制最多不能超过10000个。如果参数的输出结果超过限制，则该节点运行会失败。

3）调试值
调试值仅用于任务调试过程中进行数据预览时使用，任务运行时不会被使用。
为方便下游节点查看效果，建议给参数设置调试值。

注：调试值允许输入多个值，多个值之间使用“逗号”分隔。

2、数据来源
仅参数值类型为“数据源字段”时需要配置参数的数据来源，支持从多种数据源中取数，选择“数据连接”时，支持两种配置方式：直接选择表或视图（可设置过滤条件）、写SQL语句。具体使用可参见：数据同步-数据来源

点击“数据预览”可以先看下获取的数据，方便输出参数的值来源配置，如下图：

3 参数使用

1、任务调试时，输出参数的参数值使用优先级：
1）【参数赋值】中设置的参数调试值>当前任务中设置的参数默认值。
2）当同一个任务中添加了多个【参数赋值】节点，若不同节点使用了相同的参数，该参数被下游节点引用时，距离节点越近的「参数赋值」参数优先级越高。
2、支持跨节点传递参数
【参数赋值】下游所有的节点都可以使用输出的参数，但是不可跨分支被其他节点使用。
3、参数引用的写法
若参数值为整型、双精度型、布尔型，直接用${参数名}的方式引用参数；
若参数值为字符类型、日期类型，需要加上单引号引用参数 :’${参数名}’。