0

我创建了一个融合模板，我想在其中插入一个图表（饼图），显示与特定项目相关的工单状态。我希望图表宏可以在 JIRA 中按类型自动检索不同票证的数量，以便用户每次基于此模板创建页面时，他们不需要手动填写图表数据。

我知道在 JIRA Report 宏中可以轻松检索此类信息。但是如何在图表宏的报告结果中访问这些数据？还是我必须实现另一个自己的自定义宏？如果是这样，我是否必须编写一些 Java 或 Javascript 代码，或者仅使用宏模板语言就足够了？

我是融合的新手。任何想法都会有所帮助。

4

1 回答 1

1

问题解决了。Confluence 页面模板以存储格式编写，并在返回给客户端之前由 Confluence 内部呈现。有一种方法可以在模板中声明变量，然后通过在 Java 或 Javascript 的模板上下文中添加条目来为它们提供数据。

例如，JIRA 图表宏插入到下面的模板 simple-template.xml 中：

<ac:structured-macro ac:name="jira" ac:schema-version="1">
    <ac:parameter ac:name="server">Your Company JIRA</ac:parameter>
    <ac:parameter ac:name="jqlQuery"><at:var at:name="vJql" /></ac:parameter<name />
    <ac:parameter ac:name="count">true</ac:parameter>
    <ac:parameter ac:name="serverId"><at:var at:name="vServerId" /></ac:parameter>
</ac:structured-macro>

两个变量vJql和vServerId使用语法声明<at:var at:name="varName"/>。这些 var 可在扩展 class 的类提供的模板上下文中访问com.atlassian.confluence.plugins.createcontent.api.contextproviders.AbstractBlueprintContextProvider。要将上下文提供程序与模板绑定，需要通过添加元素来配置 atlassian-plugin.xml 中的模板声明context-provider：

<content-template key="simple-template"
    template-title-key="delivery.blueprint.template.title" i18n-name-key="new.template.blueprint.name">
    <resource name="template" type="download" location="/templates/simple-template.xml" />
    <context-provider class="com.company.atlassian.plugins.confluence.SimpleTemplateContextProvider" />
</content-template>

在类中，通过返回包含 vars 条目的上下文来提供 vars ：

private final String VAR_PROJECT_KEY = "jira-project";
private final String VAR_VERSION = "jira-fix-version";
private final String VAR_JQL = "vJql";
private final String VAR_SERVER_ID = "vServerId";

@Override
protected BlueprintContext updateBlueprintContext(BlueprintContext context) {
    try {
        String projectKey = (String) context.get(VAR_PROJECT_KEY);
        String version = (String) context.get(VAR_VERSION);
        String jql = "project = \'" + projectKey + "\' AND fixVersion = " + version;
        String serverId = ResourceBundle.getBundle("simple-template-example").getString("jira.serverid");

        context.put(VAR_JQL, jql);
        context.put(VAR_SERVER_ID, serverId);
        return context;
    } catch (Exception e) {
        e.printStackTrace();
        return context;
    }
}

完毕。

于 2016-05-17T08:57:11.507 回答