Known Limitations and Issues
Only Microsoft Word on Windows is Supported.
All other known issues are listed inCodebeamer trackers.
Error Message When Trying to Import an Unchanged Word Export from Codebeamer
You will receive an error message if you export items from Codebeamer to Word and do not change the export Word file (.docx file) but try to import them back to Codebeamer, for example, to a different tracker.
Codebeamer detects this scenario (when an unchanged Word document arrives), rejects the import, and displays the following error message. The workaround is to modify anything in the Word document, save it, and then try to import the changed Word document.
Why wiki-text are changed during Word-round roundtrip? Why other unwanted changes appear?
When editing some Codebeamer content in Word you may find during the import back that there are some unwanted changes appearing, and some new lines are added or removed or some wiki text -like wiki tables- has different structure than it was before.
Why this is happening?
This is simply because during the Word roundtrip or Office-edit there are several conversions happening, and each conversion can bring in some differences, some of the styling or layout may get lost or even errors may happen.
To explain such conversions happen during Word roundtrip or Office-edit:
• The original wiki text is converted to HTML.
• The HTML is slightly modified with CSS so it will look better in Word.
• Images are added to the HTML, and they are resized if necessary.
• The result HTML is fed to Word, which converts that to its own Word-Markup-Language.
• Then while edit this in Word, the change-tracking is turned on so we know which parts are changed during round-trip import.
• The round-trip import processes the Word-Markup-Language and converts that back to wiki (also captures images and comments).
• Only those changes are imported back in round-trip which contain tracked changes added by Word.
So during the Wiki->HTML->Word Markup -> Word edit -> Word Markup -> Wiki processing several conversions are taking place.
These conversions cannot be perfect because of the largely different feature set of Word and HTML and Wiki. Word is far more advanced than HTML, and HTML is far more capable than Wiki. Wiki is just largerly simplified subset of HTML. Therefore there will be always some differences or features that cannot be converted or kept during these conversions.
Also because the conversion is machine generated the result wiki will never look as nice as a human written Wiki markup, neither the original wiki markup cannot be reproduced perfectly during these conversions. Some new-lines and white spaces will be added here-and-there, some tables will be structured differently and many more differences may appear.
Our primary goal during Word roundtrip and Office edit is to keep every information and structure of the information as much as possible. It is a bit less important to keep the perfect look of the information - like text colors or alignment or fonts-.And then the least important -if possible at all- is to keep the result wiki close to the original wiki text.
FAQ
1. Can I delete specific fields and add additional fields in the roundtrip word file?
No, Word Roundtrip is limited.
2. What can I change specifically in the excel roundtrip file?
Word roundtrip supports rich text files with images and comments. You can only change editable fields that appear in the roundtrip file, such as:
• Name
• Description
• Comments
• Severity
• Priority and
• Business value