Add links to a bug tracking system in the release comments

You can configure IXIASOFT CCMS so that users can specify the number of the bug that they are fixing when they release a topic.

Note: This can be applied within a Hosted environment, but only within a test server.

To enable this feature, you specify the link to your bug tracking system in the textmlservercfg.properties configuration file.

When users release a topic related to a bug fix, they can specify the bug number in the Tracker link field of the Release window, as shown below:
Tracker link field
When the user releases the topic, the link to the bug is available in the Revision History:
Release History with tracker link

Clicking on the bug number opens the bug in a browser.

Note: This can be applied within a Hosted environment, but only within a test server.

To configure the CCMS to add links to a bug tracking system in the release comments:

  1. Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the tool bar. If the shortcut is not displayed, follow these steps:
    1. Select Window > Perspective > Open Perspective > Other
    2. Click TEXTML Administration.
    3. Click Open.
  2. In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
  3. When the Connect as dialog opens, type your username and password and click OK.
  4. Double-click the name of your Content Store to open a connection to it.
  5. Locate the textmlservercfg.properties file in the repository's /system/conf collection.
  6. Check out textmlservercfg.properties and open it with a text editor.
  7. Locate the following line at the end of the file:
    #Don't remove this line. It is required for proper parsing of the file
  8. Before this line, add the following lines:
    #Uncomment the following line if you want to enable support for tracker web linking
    tracker.url=<URL_of_Tracking_system>%TRACKER.ID%
    Where <URL_of_Tracking_system> is the URL of the tracking system and %TRACKER.ID% represents the location of the bug ID. For example, consider the following URL for Bugzilla:
    http://bugzilla-cms.acme.local/show_bug.cgi?id=1552

    This URL would be configured as follows in the textmlservercfg.properties file:

    tracker.url=http://bugzilla-cms.acme.local/show_bug.cgi?id=%TRACKER.ID%
    For the following JIRA URL:
    https://home.acme.com/jira/browse/acmedoc-56
    Configure it as follows in the textmlservercfg.properties file:
    tracker.url=https://home.acme.com/jira/browse/%TRACKER.ID%
  9. Save, close, and check in the textmlservercfg.properties file.
  10. Inform users of the changes and request that they close and reopen their CCMS Desktop to apply the changes.