润乾——新增任务参数设置

参数设置

参数使用场景：

• 报表中使用

很多时候，报表中的某些内容希望在调度任务执行的时候动态获取，这时候就可以在报表和调度的参数管理中定义好参数名称和表达式，这样在调度任务的执行过程中，就可以动态获取参数的值，

例如：在某个调度任务中，用户需要在推送的报表中包含当前任务执行时的时间,那用户可以在报表对象设计时，在报表属性的参数定义中插入参数arg0，并选中A1单元格填入表达式“=@arg0”。在新建调度任务的时候，在任务参数设置页面添加参数，参数名称为arg0,参数值为“now()”。执行调度任务，这时候推送的报表对象的A1单元格的值就是当前日期。

• 调度任务设置过程中使用

在推送报表的过程中，报表的推送路径，或者报表的名称需要根据情况进行不同的设置，这种情况下就可以在参数设置中设置好参数，在推送路径和命名调度对象的时候调用。

如：用户使用ftp推送，希望根据任务执行的年月日，将调度对象推送到不同的路径下，则用户可以在参数设置页面添加3个参数，参数名称分别为为year，month、day,参数值分别为year(now()),month(now()),day(now())。在输出设置中输出FTP设置中FTP目录地址中输入/@year/@month/@day。

【参数类型】：共分为４种参数类型：常量、表达式、SQL、自定义

• 常量：一个确定的值。此时，数据源列无效；参数值可输入具体的值（如：数值、字符串等）。
• 表达式：可定义一个润乾表达式。此时，“参数值”列可定义一个润乾表达式。例如now（）返回系统时间，或者通过list或者to函数返回数组。 如：com.runqianapp.schedule.parameter.MyArgumentCalculator。
• SQL：可定义一个可执行的sql，“数据源”可定义SQL语句将在哪个数据源连接的数据库中执行。
• 自定义：当参数类型为自定义时，参数值可定义一个完整的类路径，用于计算参数的值。如：com.runqianapp.schedule.parameter.MyArgumentCalculator。

【参数名称】：如果该参数的计算结果要传给报表，那么，名称必须与报表对应的参数名称一致；调度管理其他支持参数的定义项中，均可使用这里定义的参数，调用时，参数名称前加@。如：定义一个参数为temp，在“输出ftp设置”的“ftp目录地址”中使用，那么，在该文本框输入@temp以调用temp参数。如下图：

【参数值】：当参数类型为“常量”时，定义固定数值或字符串等；当参数类型为“表达式”时，定义一个润乾表达式来计算参数的值；当参数类型为“SQL”时，可定义一个可执行的SQL语句来获得参数的值；当参数类型为“自定义”时，可输入类路径来调用外部类计算参数的值。

【数据源】：只有“SQL”数据类型的参数生效。

参数遍历

使用场景：

当参数类型为sql的时候，sql的返回值可能为一个集合，那么，调度引擎将会遍历参数的值，生成不同组合，并生成对应的多个实例.

例如：用户在进行邮件推送的过程中需要对不同的员工组合发送不同的邮件，此时可以在任务参数设置页面添加二个参数，参数类型为sql，并设置不同的查询条件，在这种情况下，调度引擎将会遍历结果组合，生成不同的任务实例。