【运维自动化-标准运维】各类全局变量使用说明-元变量(完结)

news/2025/10/28 16:46:34/文章来源:https://www.cnblogs.com/tencent-blueking/p/19172199

元变量有三种：下拉框、表格、文本值下拉框

一、下拉框

支持单选和多选两种，单选模式下输出选中的 value，多选模式下输出选中 value 以逗号 ‘,’ 拼接的字符串。

该类型变量默认不支持输入任意值，仅在子流程节点配置填参时支持输入任意值

创建
输入名称和KEY值

引用

${KEY}

引用${KEY}，返回类型为值（单选）或字符串（多选）

使用

自定义数据源，格式：
[{"text": "xxx", "value": "xxx"},{"text": "xxx", "value": "xxx"},....]，text和value是固定的key，一定要是这个格式
比如：m1\m2\m3分别表示stag、prod、poc
[{"text":"m1","value":"stag"},{"text":"m2","value":"prod"},{"text":"m3","value":"poc"}]
原程数据源，格式同上
远程数据源主要用于有前置步骤如http请求返回的数据，格式一定要跟自定义数据源一致，否则无法渲染。
类型
- 单选
- 多选

实操演示
1、创建一个多选下拉框的变量module，表示模块选择

数据源用自定义的，三个模块，stag、prod、poc，默认值是prod

[{"text":"m1","value":"stag"},{"text":"m2","value":"prod"},{"text":"m3","value":"poc"}]

2、引用变量
添加简单的插件-脚本执行，脚本内容也是简单的echo下 ${module}

3、执行过程
执行前会让选择下拉框变量，这里选两个m2和m3

执行结果输出了，m2和没对应的value

二、文本下拉框

文本下拉框跟下拉框类似，只是文本下拉框可以通过变量输出key和value（即选项名称和选项值都能输出），普通下拉框只能输出value

创建

引用
${KEY[“value”]} 输出单个或选项的值(value)，多个以逗号",“拼接。
${KEY[“text”]} 输出单个或多个选项的名称（key），多个以逗号”,"拼接。
${KEY[“text_not_selected”]} 输出未选择的选项名称（反选）
${KEY[“value_not_selected”]}输出未选择选项的值（反选）

使用
数据源格式同普通的下拉框，可见下拉框的部分。

实操演示
1、创建一个文本下拉框变量text_list

数据源用自定义的，这里我们用一个简单的下拉列表示例：

[{"text":"性别","value":"男"},{"text":"身高","value":"180"},{"text":"年龄","value":"20"}]

翻译成下拉选项就是：
性别男
身高 180
年龄 20

2、引用变量
添加一个简单的插件-脚本执行，脚本内容也是简单的echo变量输出

3、执行过程
执行前会让选择下拉框变量，这里选择性别看看输出结果

4、输出结果

三、表格

表格变量可以配合填写表格参数的插件使用，通过自定义表格变量简化或复用插件参数，比如配置平台的创建集群插件，需要填写很多二维的参数（集群名、集群容量、环境类型等），就可以用表格变量来实现。

创建
输入名称和KEY值

引用
${KEY}
引用表格变量某一列某一行的属性，如 ${KEY.columnA[0]} -> “test1”
引用表格变量某一列的全部属性，多行用换行符 \n 分隔，如 ${KEY.flat__columnA} -> “test1
test2”

使用

列配置
格式为：

[{"tag_code": "name1","type": "input","attrs": {"name": "A"}
}, {"tag_code": "name2","type": "input","attrs": {"name": "B"}
}, {"tag_code": "name3","type": "input","attrs": {"name": "C"}
}]

翻译成表格就是

说明：name1，name2，name3实际就是列1，列2，列3的key
a0\a1\b0\b1…为测试输入的列值。
如：
${table.A[0]}=a0 表示A列第一行的值
${table.B[1]}=b1 表示B列第二行的值

实操演示
1、创建一个表格变量table

列配置为：

[{"tag_code": "bk_set_name","type": "input","attrs": {"name": "集群名"}
}, {"tag_code": "bk_set_env","type": "input","attrs": {"name": "环境类型"}
}, {"tag_code": "bk_set_status","type": "input","attrs": {"name": "集群状态"}
}]

翻译成表格为