The file that is actually exported for Word is not a native Word document, but an MHTML file that Word fully understands.
It consists of multiple so-called parts:
The main part in the MHTML is a regular HTML document, this is the actual document body.
The images referenced by the main HTML part are saved into additional parts, one part for each image.
Customizing the content: HTML and CSS
The content of the document body, the document header and the document footer are rendered from regular Velocity templates for easy customizability. Making modifications on the templates is totally similar to customizing the notification emails sent by codeBeamer. (Thus we strongly suggest that article, as well.)
It's important to understand that what you actually do is modifying an HTML template. You can use most of the HTML formatting capabilities (like colors, font weight, and borders), most of the HTML text constructs (like lists or tables), but not everything. For instance, floating <div>'s will not be understood by Word, as a floating block doesn't make much sense in a word processor.
You can also use CSS, with the same restrictions: exotic visualization, like drop shadows, will be ignored by Word.
The template files are located in the CB_HOME//tomcat/webapps/cb/config/templates/html directory:
Specifies the body content for the document.
Specifies the document header and footer. The header and the footer
Specifies the "skeleton" of MHTML. It's very unlikely that you will ever modify it.
Modify them, save them and export a new document. codeBeamer will pick up your changes immediately.
Another interesting feature is that you can use special, non-standard HTML fragments in the templates, which generate fields managed by Word.
You can, for instance, add this snippet to have an intelligent Word-managed TOC in your document:
TOC \o "1-3" \u
<span style='mso-no-proof:yes'>Please right-click and choose "Update Field" to initialize this field.</span>
Or, you can insert this to have a "17 of 82" style page number (fully managed and recomputed by Word!):
Map contains for each requirement's id the incoming or outgoing associations from/to that requirement. Important: these are not the referenced issues via reference fields, but the associations between other issues in the system.
About figuring out what properties are available on of these CodeBeamer objects: please look at the remote-api documentation and the javadoc found in. As you may already know CodeBeamer provides a rich API for querying and manipulating CodeBeamer objects programmatically using an RPC protocol. This API is documented here: You must login to see this link. Register now, if you have no user account yet.
So the remote-api contains the Javadoc of most internal CodeBeamer objects I've listed above, and is shipped with the CodeBeamer distribution. You can find it below your CodeBeamer installation directory on a path like: $CB_HOME/tomcat/webapps/cb/codebeamer-api-6.0.0.zip. If you unzip this zip file somewhere then you will see a "docs/api/" directory where the generated Javadoc resides. Open the index.html here and you will find the Javadoc and properties of the objects (like our TrackerItemDto).
Be warned however that the signature of these objects, the export scripts may and practically will change between any new CodeBeamer releases in the future. I would strongly recommend that you try to keep your customizations as isolated as possible, and using a git repository for tracking such changes is recommended. This will make your life much easier if you plan to upgrade CodeBeamer in the future...