Refer to these notes on using the current implementation
of the SoDA® migration tool in IBM® Rational® Publishing Engine.
SoDA commands
Table 1. Considerations for using SoDA commands
in Rational Publishing EngineName |
Description |
OPEN |
OPEN commands that have multiple
arguments are not supported in this version. |
REPEAT |
The following sections of a REPEAT command
are not supported:- Predicate
- Ordering
- Recursive replicator
|
LIMIT |
The following sections of a LIMIT command
are not supported:
For the LIMIT command, Rational Publishing Engine creates
a container and adds a condition to this element. The condition body
is SoDA LIMIT Predicate. After generating the template,
edit this condition in accordance with the LIMIT predicate.
LIMIT
OMIT and LIMIT OTHERWISE are treated
identical with the simple LIMIT command.
|
DISPLAY |
The filter feature is not supported. |
Microsoft Word
elements
Only the following properties are read from the SoDA template and set in the resulting Rational Publishing Engine template
for the generated elements.
- Paragraph
- Inherited style name (only if the style is a heading type one),
paragraph alignment, top border style, top border width, top border
color, right border style, right border width, right border color,
bottom border style, bottom border width, bottom border color, left
border style, left border width, left border color, before spacing,
after spacing, multiple line spacing, first line indent, hanging indent,
left indent, right indent, level number, numbering style
- Text
- Font color, font size, font family, bold, italic, underline, strikethrough,
character spacing, subscript, superscript, all borders style, all
borders color, all borders width, text background color
- Field
- Font color, font size, font family, bold, italic, underline
- Table
- Cell spacing, table alignment, top border style, top border width,
top border color, right border style, right border width, right border
color, bottom border style, bottom border width, bottom border color,
left border style, left border width, left border color
- Cell
- Top border style, top border width, top border color, right border
style, right border width, right border color, bottom border style,
bottom border width, bottom border color, left border style, left
border width, left border color, cell text top padding, cell text
right padding, cell text bottom padding, cell text left padding, cell
background color
- Image
- Image width, image height, image alignment
- Hyperlink
- Font color, font size, font family, bold, italic, underline, strikethrough,
underline color, character spacing, subscript, superscript, text background
color
- Footnote
- Font color, font size, font family, bold, italic, underline, strikethrough,
character spacing, subscript, superscript, text background color,
footnote type
- Table caption, Figure caption, and Comment
- Font color, font size, font family, bold, italic, underline, strikethrough,
character spacing, subscript, superscript, text background color
- Row
- Row height, row repeat at page beginning
- List
- Numbering style
- Page number and Total page number
- Font color, font size, font family, bold, italic, underline, strikethrough,
character spacing, subscript, superscript, all borders style, all
borders color, all borders width, text background color
- Field
- Field code
- Master Page
- Page orientation, paper size, paper height, paper width
- Header
- Header from top
- Footer
- Footer from bottom
Customizing Rational Publishing Engine
- Due to the command limitations highlighted above, the resulting Rational Publishing Engine template
does not have any conditions set. You can add conditions in the appropriate
locations in the template.
- Because of the SoDA template
structure, empty Paragraph elements can appear in the resulting template.
You can remove them if they are not required.
- If there are list elements in the SoDA template,
it is possible in Rational Publishing Engine template
to have a list element with one or more paragraphs inside. Remove
all paragraphs from the list element, to obtain a better output.
- For each OPEN command with calculated values,
the resulting Rational Publishing Engine template
contains a Dynamic Data Source Configuration element. You must configure
this element with a specific value as required.
- For the REPEAT commands that have the Heading
style, a Paragraph element with that Heading style is created in the
resulting template. Such Paragraph elements have a Container element
with the Repeat query. Remove the Heading style from the parent Container
element.
Mapping SoDA data
sources
Certain SoDA data
sources can map to multiple Rational Publishing Engine schemas.
You cannot perform operations such as Join in these
scenarios. The data sources is added to the Rational Publishing Engine resulting
template. You must manually add a condition to the template elements
to perform the Join operation.