本文导读

展开导读

文档首页/ 应用与数据集成平台 ROMA Connect/ 用户指南（新版）/ 组合应用管理/ 引用变量

引用变量

更新时间：2023-12-28 GMT+08:00

查看PDF

在组合应用的流任务编排中，以及连接器和处理器配置中涉及到大量的输入输出信息，还涉及到大量的配置信息需要填写。用户在编辑设计组合应用时，可以通过变量的方式快速引用流任务中的输入输出信息和配置信息，帮助用户便捷高效的设计组合应用。

组合应用中的变量可以分为系统变量、节点变量和自定义变量三种。同名变量的优先级为：系统变量 > 节点变量 > 自定义变量。

系统变量

系统提供了一些内置的变量，表示系统参数或者某些连接器的特定输出。当前组合应用提供的系统变量如表1所示。

系统变量引用方式：${变量名}。

表1 系统变量说明
变量	说明
step_execution_time	上一个节点的执行耗时，单位毫秒。
response_code	上一个HTTP请求节点的响应码。
selected_row_count	上一个数据库节点执行查询操作的数据条数。仅支持MySQL，Gauss200，PostgreSQL，Oracle，SQL Server或DB2数据库。
updated_row_count	上一个数据库节点执行插入、更新和删除操作的数据条数。仅支持MySQL，Gauss200，PostgreSQL，Oracle，SQL Server或DB2数据库。
loop_index	上一个循环处理节点，当前循环的索引，从0开始。
loop_size	上一个循环处理节点的循环总次数。
split_index	上一个数据拆分节点，在数据拆分时当前数据块的索引，从0开始。
split_size	上一个数据拆分节点的数据拆分数量。
split_complete	上一个数据拆分节点，数据拆分是否完成。

节点变量

上一个节点的执行结果，可以作为节点变量，被后续节点进行引用，如Open API的请求体内容、查询数据库的结果、HTTP请求的结果等。

节点变量引用方式：${payload}。

如果执行结果是一个对象，如JSON对象、XML对象等，可以使用${payload.id}或者${payload[0].id}等方式，引用执行结果中的部分数据。

使用示例：

例如当HTTP请求节点执行完成收到的响应体为如下JSON格式数据，在后续节点可使用${payload}引用该JSON数据，使用${payload.id}来引用“00000000”值，使用${payload.data[0].value}来引用“x”值。

{
    "id":"00000000",
    "name":"sample01",
    "data":[
        {
            "id":1,
            "value":"x"
        },
        {
            "id":2,
            "value":"y"
        },
        {
            "id":3,
            "value":"z"
        }
    ]
}

自定义变量

自定义变量包括用户在“变量配置”中添加的变量，在“Open API”节点添加的请求参数、在“变量赋值”节点添加的变量、在“脚本处理”节点配置的“输出到变量”参数等，可以在后续节点中被引用。

自定义变量引用方式：${变量名/参数名}。

在“变量配置”添加变量

登录新版ROMA Connect控制台。
在左侧导航栏选择“组合应用”，在组合应用页面找到要添加变量配置的组合应用。
单击组合应用上的“”，选择“编辑”，进入组合应用的编辑界面。
单击页面正上方的“变量配置”。

在变量配置弹窗中单击“添加”，添加变量。

表2 配置变量
参数	说明
变量名	填写变量的名称，后续将通过变量名称进行引用。
配置类型	选择变量的数据类型，可选择“字符串”、“整数”、“长整数”、“小数”、“布尔”和“密码”。
变量值	填写变量的值。
作用域	选择变量的生效范围，是所有组合应用生效（global），还是仅当前组合应用生效。
描述	填写变量的描述信息。

单击“保存”，保存变量信息。

在“Open API”节点添加请求参数
 具体配置操作请参考Open API。
在“变量赋值”节点添加变量
 具体配置操作请参考变量赋值。
在“脚本处理”节点配置“输出到变量”参数
 具体配置操作请参考脚本处理。

父主题： 组合应用管理

上一篇：创建组合应用模板

下一篇：引用函数表达式

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消