Jenkins动态参数配置：根据选项切换下拉列表或文本输入框

你之前的选型方向没问题，问题出在Active Choices Reactive Parameter默认会把返回值渲染为下拉框，没有显式指定渲染类型的情况下，返回空列表只会得到无选项的禁用下拉，不会自动变成输入框。下面是可直接落地的两种实现方式，最终都可以直接把参数值传给Ansible playbook使用。

方案一：单参数动态切换控件（推荐，无需额外参数兼容） #

这个方案只需要两个参数，不需要额外做值合并，最终直接拿到统一的文件名参数。

1. 上游选择参数配置 #

第一个参数使用Active Choices Parameter，参数名设为CHOICE，选择类型为单选下拉，Groovy脚本保留原有配置即可：

return [
  "EXISTING",
  "NEW"
]

2. 动态文件名参数配置 #

第二个参数使用Active Choices Reactive Parameter，参数名设为TARGET_FILE，核心配置项：

• 在Referenced parameters（引用参数）输入框准确填入CHOICE，大小写完全一致，否则脚本无法获取上游选择值
• 勾选Enable custom parameter rendering（启用自定义参数渲染）
• Groovy脚本替换为以下内容：

if (CHOICE == "EXISTING") {
    // 替换为你实际获取现有文件列表的逻辑，支持读取Jenkins节点文件、调用接口、读配置中心等
    def existingFileList = ["file1", "file2", "file3", "filen"]
    return [
        existingFileList,
        renderType: "ftSelect", // 该分支渲染为单选下拉框
        readOnly: false
    ]
} else if (CHOICE == "NEW") {
    return [
        [""], // 输入框默认空值
        renderType: "ftText", // 该分支渲染为单行文本输入框
        defaultValue: "",
        readOnly: false
    ]
}
// 兜底默认返回空输入框
return [[""], renderType: "ftText"]

注意：不要在NEW分支返回空数组，空数组会被识别为无选项的下拉框，必须显式指定renderType才能切换控件形态。

方案二：双参数动态显隐（逻辑更直观，易维护） #

如果不想在单个参数里处理渲染逻辑，可以配置两个独立的文件名参数，根据上游选择动态显示/隐藏对应控件。

配置步骤 #

• 保留第一个CHOICE参数，配置和方案一一致
• 新增第一个响应式参数EXISTING_FILE：引用CHOICE，当CHOICE=EXISTING时返回文件列表渲染为可见下拉框，其他情况设置控件隐藏
• 新增第二个响应式参数NEW_FILE_NAME：引用CHOICE，当CHOICE=NEW时渲染为可见文本输入框，其他情况设置控件隐藏
• 在调用Ansible前增加一步参数合并逻辑，以声明式Pipeline为例：

pipeline {
    agent any
    stages {
        stage('执行Ansible部署') {
            steps {
                script {
                    // 根据用户选择取对应参数值，统一赋值给传递给Ansible的变量
                    env.FINAL_FILE_NAME = params.CHOICE == "EXISTING" ? params.EXISTING_FILE : params.NEW_FILE_NAME
                }
                ansiblePlaybook(
                    playbook: 'deploy.yml',
                    extraVars: [
                        // 直接把统一变量传给playbook即可，playbook侧无需额外判断
                        target_file: env.FINAL_FILE_NAME
                    ]
                )
            }
        }
    }
}

配置校验注意事项 #

• 所有Reactive Parameter的引用参数名必须和上游参数名完全一致，大小写敏感，填错会导致脚本拿不到值、动态切换失效
• 配置完成后先进入Build with Parameters页面测试切换逻辑：选EXISTING时正常显示文件下拉，选NEW时正常显示输入框，输入/选择的值可以在构建历史的参数页看到正确记录
• 如果是自由风格任务，不需要写Pipeline，直接在构建步骤里通过$TARGET_FILE（方案一）或者判断后取值（方案二）传给Ansible即可。

内容的提问来源于stack exchange，提问作者Philip Shangguan