Jenkins：基于前置选择在参数化构建中显示文件文本

当然可以实现这个需求啦！从你提供的截图和代码来看，你已经在使用Active Choice插件做分支选择的参数化构建了，接下来咱们只需要扩展一下，就能实现“根据前置条件读取工作区文件说明文本”的效果。下面是具体的实现思路和代码示例：

首先要确保你的Jenkins已经安装了Active Choice Plug-in和Active Choice Reactive Reference Plug-in，这两个插件是实现动态参数和关联前置条件的核心依赖。

我们可以在现有分支选择参数的基础上，新增一个动态参数来展示对应分支的说明文本：

// 原有的分支选择参数
activeChoiceReactiveParam('branch') {
  description('Select the branch you are going to use')
  choiceType('SINGLE_SELECT')
  groovyScript {
    script('["develop", "master"]')
    fallbackScript('"Error. No branch to select."')
  }
  filterable(true)
}

// 新增：用于展示分支说明的动态参数，关联branch参数
activeChoiceReactiveParam('branch_description') {
  description('Branch description from workspace file')
  choiceType('FORMATTED_HTML') // 用HTML格式优化文本展示效果
  referencedParameters('branch') // 绑定分支参数，选不同分支时自动更新内容
  groovyScript {
    script('''
      // 获取当前项目的工作区路径
      def job = Jenkins.instance.getItem(env.JOB_NAME)
      def workspace = job.workspace ?: "Workspace not found"
      
      // 假设工作区里的说明文件命名为 branch_{分支名}_info.txt，可根据实际修改
      def descFilePath = "${workspace}/branch_${branch}_info.txt"
      def descFile = new File(descFilePath)
      
      // 读取文件内容，处理文件不存在的情况
      if (descFile.exists() && descFile.canRead()) {
        // 把文本换行转成HTML换行，让展示更清晰
        return descFile.text.replaceAll("\\n", "<br>")
      } else {
        return "<span style='color:orange'>⚠️ No description file found for branch: ${branch}</span>"
      }
    ''')
    fallbackScript('"Failed to load branch description."')
  }
}

• FORMATTED_HTML类型：这个参数类型支持HTML格式，能让说明文本的换行、提示信息更直观，比如用<br>替换换行，用颜色标注提示。
• 关联前置参数：通过referencedParameters('branch')，这个说明参数会跟随branch参数的变化自动重新执行脚本，读取对应分支的说明文件。
• 工作区与文件读取：通过Jenkins API获取当前项目的工作区路径，然后拼接对应分支的说明文件名（你可以根据实际的文件命名规则修改路径）。同时增加了文件存在性和可读性判断，避免出现报错。
• 权限注意：如果Jenkins报脚本权限错误，需要到「Manage Jenkins > In-process Script Approval」里批准相关的方法调用（比如文件读取、Jenkins实例获取）。

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