配置跟踪报告

配置您的 Trac 实例

该插件需要被告知您的 Trac 安装的详细信息,以便它可以连接和查询打开的票证。Trac 安装需要通过无身份验证、基本身份验证或 NTLM 身份验证来访问。如果您使用过表单身份验证,那么您就不走运了。

您的 Trac 安装需要安装XML-RPC 插件并为该插件工作才能读取票证。

基本报表配置

最基本的报告配置是从 POM 的<issueManagement>部分读取的。这应该无需其他配置即可工作,但默认情况下,所有票证都将列出

  <issueManagement>
    <system>trac</system>
    <url>http://mytracserver.local/trac/MYPROJECT/</url>
  </issueManagement>

配置自定义查询

确切的查询可以在<query>元素中配置。请参阅TracQuery了解确切的语法。

  ...
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-changes-plugin</artifactId>
    <version>2.8</version>
    <configuration>
      <query>status=accepted&amp;status=assigned&amp;status=new&amp;status=reopened&amp;order=priority&amp;component=${project.artifactId}</query>
    </configuration>
  </plugin>
  ...

配置基本认证

如果您的 Trac 受到基本身份验证的保护,那么您需要添加<tracUser><tracPassword>配置元素,以便插件知道以谁身份进行身份验证。

<project>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-changes-plugin</artifactId>
        <version>2.8</version>
        <configuration>
          <tracUser>my username</tracUser>
          <tracPassword>my password</tracPassword>
        </configuration>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>

配置 NTLM 身份验证

如果您的 Trac 位于 Windows 上的 Apache 后面,并且 mod_sspi 使用 Active Directory 进行身份验证,那么插件应该以当前用户身份向服务器进行身份验证,而无需任何额外配置。不需要<tracUser><tracPassword>配置元素。

使用自定义编码

如果您必须支持非西方编码,请在配置中指定<outputEncoding>

<project>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-changes-plugin</artifactId>
        <version>2.8</version>
        <configuration>
          ...
          <outputEncoding>Windows-31J</outputEncoding>
        </configuration>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>