This new feature allows you to edit your wikis in Microsoft Word. Simply click on Edit in Word and the wiki is automatically locked and the wiki is opened in an MS Word session. After editing, saving and closing MS Word, the wiki is automatically uploaded and unlocked for the next user. Headings, tables, links, bullet lists, and many symbols are automatically converted between Word and Wiki formats, so that you can either create them in Word, and have them upload into codeBeamer wikis, or edit them in MS Word.
The Edit in Word link is visible to all users, but it will only work for those users who have purchased a license. For more information on licensing, please see codeBeamer Licensing.
This feature is useful for document text updates using simple Wiki markup formatting. The conversion process takes a wiki, converts its format to RTF for Editing in Word, and then reconverts to wiki upon upload. Wiki offers a subset of all the features offered in Word, so many Word documents will not properly up-convert (when pasted into the Wiki's Edit in Word session, for example).
Edit in Word Usage Examples
To really see what's going on in the following examples, try selecting more... (above) and Wiki Markup View on this wiki, to see the actual contents of the wikis used for these examples. The regular wiki view comment (gray) boxes are also helpful, but if you are confused, the Wiki Markup View may help.
Wiki markup constructs that are not in the following list are not supported.
Only MS Word 2003 and 2007 versions are supported.
Sun's JDK-1.5 or higher must be installed on the client computer.
To reproduce this in MS Word: To create a new table switch to the Insert tab and select Table. After the table has been created, you can merge its cells by selecting them and clicking Merge Cells in the pop-up menu. To add a heading, simply fill the heading cells with any color.
Example: This is a red text and this is a text with lime background
To Reproduce this in MS Word: Select some text and use Font Color and Text Highlighting options in Font section to set text foreground and background color.
%%(color:red)This is red text%% and %%(background-color:lime)this is text with lime background%%
Example: file or clip art. The picture is included as an attachment to the wiki, in the Properties.
To Reproduce this in MS Word: Choose Insert... Picture .... From File. When the picture is inserted, do not resize it. Any resizing should occur in the properties of the picture itself, as performed by an image editor. The upload/convert will attach the picture in the Properties .... Comments and Attachments.
For a step-by-step example of using Edit in Word to insert and upload pictures into your wiki, see Pictures in EiW.
Limitations of Editing in MS Word
Limitations inherent in this wiki-RTF-wiki double conversion include:
MS Word pictures are automatically uploaded and inserted into the wikis, and vice versa. However, vector graphics (eg, graphics created in MS Word) are not supported. Pictures can also be separately uploaded to the CodeBeamer server and linked inline. Pictures that are inserted in MS Word and then resized will not reflect the resizing when displayed in the wiki. That is, the pictures may be too large or too small.
Table of Contents: Use the Wiki markup plugin definition
, not the MS Word Table of Contents, as the MS Word Table of Contents will not import into the wiki.
Similarly, complex Tables and other more complex MS Word constructions, that have wiki equivalents, should be defined in the MS Word document using wiki markup-type commands, or the simpler table commands as shown above.
Symbols or uncommon fonts or formats: Testing has been limited to English and German with common symbols only. Problems may occur with uncommon fonts or symbols.
Although the wiki converts to RTF, use copy and paste from other RTF files (into the Wiki in Edit in Word) with great caution. Very large RTF files (for example, RTF files that contain pictures) will not convert properly.
Colors: a limited number of colors convert from RTF to wiki
Font Sizes: relative font sizes are not converted, unless they are part of formatted markup-style headings.