Word Content for Desktop Publishing

Microsoft Word report object content is generated automatically to desktop publishing XML and requires no tagging.

Styles

Content that uses Word styles that are present in the CDM Desktop Publishing Styles list (Administration > Resources > Desktop Publishing Styles) are automatically generated (in effect, tags are not necessary). Contact your administrator to ensure the styles are present. The style names there must be identical to those in the Word objects you want to generate (the names are case sensitive).

For example, consider this Word object:

Only the content with Word styles that are matching the names from the Desktop Publishing Styles list are generated:

Thus Algerian and Bahnschrift styled content is generated in the output, while the third sentence, using a style called Text Not Required, is excluded.

Output Word Styles

Word content is enclosed in the appropriate style paragraph so as to be easily mapped in your desktop publishing application. Here is the sample generated content from the example in the preceding Styles section:

As previously explained, Line 3 does not appear as it uses a style not included in the Desktop Publishing Styles list, and the BahnschriftChar tag shown on line 4 is enclosing the content where the Word character style was applied in an Algerian styled paragraph.

Included or Discarded Content

When CDM report content is not intended to be published and its formatted with a style that is used on other parts of the report that must be published, this approach is recommended: You must create two styles using the same font, character size, and so on, with different names. One of these styles is to be added to the Desktop Publishing Styles list and is then applied to content that is to be included in the desktop publishing output. The second style is applied to content that is to be excluded from the output, and this style is not to be added to the Desktop Publishing Styles list.

Specific Styling Scenarios

• If a character style is applied to part of a paragraph in a Word object, and this style does not exist in the Desktop Publishing Styles list, but the paragraph style is present, then the paragraph's entire content is generated under the same XML node (in effect, tag).
• If a paragraph contains a character style that exists in the Desktop Publishing Styles list, but the paragraph style doesn't exist, then the paragraph's content is not generated in the XML file.
• To generate Word tables, the paragraph and character styles that exist in a table's cells must also exist in the Desktop Publishing Styles list. If they do not, the generated table is empty. The table style must also exist, or the table will not generate.
• Print areas and print area subranges are generated with the Table Normal table style and Normal paragraph styles in cells. These styles must exist in the Desktop Publishing Styles list to generate the range variables to desktop publishing.
• Objects other than charts and images are not generated (for example, text boxes, shapes, and so on). To generate charts and images, the style of the paragraph they are anchored to must exist in the Desktop Publishing Styles list. Charts and images that are not inline with text are not generated.
• If you use a linked style in Word, that is, one that may be applied to both paragraphs and characters and it is used on characters, it must be added to the Desktop Publishing Styles list twice. The second entry should be its name suffixed by a space and the word "Char", and this style name must exist in the Desktop Publishing Styles list to generate that nested tag. For example, you have defined a style named "My Style" that can be used both for paragraphs and characters. To generate this style for characters, you need to have a "My Style Char" style added in the Desktop Publishing Styles list.
• When generating content to desktop publishing, the style names might be modified to comply with the XML naming rules. For example, for the Word style "1_My Style" to be generated, the same style name, that is "1_My Style", must exist in the Desktop Publishing Styles list and the XML node will have the name "_MyStyle".
• Charts and images - all XML nodes for charts and images are generated with the name found in the Alt Text description for Word objects and the tag name for Excel objects.
• Special characters - the < and > characters are not escaped. If needed, a placeholder can be used instead that can be replaced with the appropriate content in the generated XML (in effect, &lt; for < and &gt; for >).

Pictures

Pictures are automatically generated if they are inline to a paragraph with a style that has a name matching a style in the Desktop Publishing Styles list.