Add a bug tracker link to 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. You can specify the link to your bug tracking system in the textmlservercfg.properties configuration file.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment. For dedicated SaaS deployments, test the changes and then ask IXIASOFT Customer Support to copy the changes to your production environment.

When users release a topic related to a bug fix, you can configure it so that users can specify the bug number in the Tracker link field of the Release window.

After topic release, the link to the bug is available in the Revision History, and users can click the bug number to open the bug in a browser.

To add a bug tracker link to release comments:

1. In the TEXTML Administration perspective, connect to your server.
2. Locate the textmlservercfg.properties file in the repository's /system/conf collection.
3. Check out the file and open it for editing.
4. Locate the following line at the end of the file:

   #Don't remove this line. It is required for proper parsing of the file

5. 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%

6. Save, close, and check in the file.
7. Inform users of the changes.
   The changes will be applied automatically once users close and then reopen their IXIASOFT CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIASOFT CCMS > Synchronize Configuration.
8. Inform users of the changes and request that they close and reopen their CCMS Desktop to apply the changes.