4.3 参数可变的Confluence宏

在浏览之前我们可以先了解一下 宏参数设置

宏参数设置

宏参数配置可以为管理员实现模板中宏参数的动态替换。

例如，模板中包含一个jira宏，其Jql参数值为 “project = TW and created <= 2022-06-01”，倘若以此模板直接定期生成报告，那报告的这部分内容将会定格重复，永远呈现项目“TW”在“2022-06-01”时间节点的Jira数据。

使用宏参数设置，可以在生成每个报告时，让 “TW” 替换为这份报告对应的项目，让“2022-06-01”替换为报告生成的日期、报告周期的开始日期、报告周期的结束日期。

具体操作步骤如下：

点击 “宏参数” 按钮，界面中会弹出宏参数的配置窗口。

点击窗口中 ”添加替换规则“ 按钮，可以设置一条宏参数的替换规则，内容包括：

• 参数内容：要进行动态替换的宏参数字符。
• 替换为：动态参数，其中有”报告生成日期“、”开始时间(周期)“、”结束时间(周期)“；当报表自动化的报告类型为”用户报告“时，有额外选项 ”用户名“、”用户全名“；当报表自动化的报告类型为”项目报告“时，有额外选项 ”项目名“、”项目key“。
• 日期偏移： 日期偏移只在”报告生成日期“、”开始时间(周期)“、”结束时间(周期)“这三种动态替换时出现，可对相应的动态参数的日期基础上增减天数，上下增减上限为365天。

点击 ”保存按钮“ 添加生效。

基于宏参数设置的功能，我们简单介绍以及演示一下都有哪些Confluence宏支持宏参数的动态变换。

Jira问题/过滤器宏

存在使用到 Jira问题 宏的模板（蓝图模板或用户模板均可），我们给JQL参数输入的内容为 “project = RWP and assignee = admin and created >= 1970-01-01  ”。

如果我们 “admin”替换为报告人名称，“1970-01-01”替换为开始时间，如图下所示。

那么我们在自动生成的报告中便可将原来的JQL变更为 “project = RWP and assignee = momo and created >= 2022-08-07 ”，如图所示。

日期宏

存在使用到 日期 宏的模板（蓝图模板或用户模板均可），我们设定两个日期“1970-01-01”、“1970-01-02”。

如果我们 “1970-01-01”替换为开始时间，“1970-01-02”替换为结束时间，如图下所示。

那么我们在自动生成的报告中便可将这两个日期分别变更为报告周期的开始时间与结束时间，如图所示。

包含摘录宏

存在使用到 包含摘录 宏的模板（蓝图模板或用户模板均可），我们设定招录的页面参数为“摘录内容1970-01-01”

如果我们 “1970-01-01”替换为报告生成日期，如图下所示。

那么我们在自动生成的报告中便可将摘录引入的页面参数自动变为“摘录内容2022-08-17”，如图所示。

*  这里需要注意，我们这样的操作是预估到有“摘录内容2022-08-17”这样的一个页面存在的前提下进行的。