Output generation issues

When the output of your template does not display as you expected, review these issues and troubleshooting suggestions.
Table 1. Template and document generation issues
Issue Troubleshooting suggestion
Canceling of a document generation process might not always be acknowledged Canceling a local or remote document generation might not be acknowledged by Rational® Publishing Engine. Even if the progress dialog is canceled, the output documents generate successfully. This issue occurs because Rational Publishing Engine checks only at specified intervals for the cancellation signal to improve performance. If the document generation job is small and has few input elements, the cancel signal might not be checked by Rational Publishing Engine. Publish another document that uses more data to get Rational Publishing Engine to process the cancellation request.
The list of running document generation jobs is not updating Refresh the monitor and control user interface by clicking the browser Refresh icon. The user interface does not refresh automatically, so if the browser is open when jobs start or complete, the information is not updated.
In a scripted filter or condition, when the left operand and right operand of a condition are from same attribute name, but belong to two different queries, the condition does not work. You have to set different aliases for the two attributes for the condition to work.
Rational Publishing Engine Client times out when creating complex document specifications that are configured to use a remote publishing engine Increase the timeout value for the client.

Add the following parameter to the rpe-launcher.ini and rpe-studio.ini files, where newValue is the timeout setting in milliseconds: -Dcom.ibm.rational.rpe.wstimeout=newValue

The default timeout value is 30000 milliseconds.

Templates that include filtered elements cause the output generation to perform slowly If you are using Rational Publishing Engine filters in your template, Rational Publishing Engine is processing the data from the integrated product. Instead, use native filters to reallocate the filtering work to the Reporting Data Services Adapters rather than Rational Publishing Engine.
Tables do not fit to the page. The autofit to window has no effect. If you set the resize to fit contents property for a table element in a template to false, then autofit to window property is ignored. Set the resize to fit contents to true to use the autofit to window property.
Extra carriage returns after a table element when it is contained within a paragraph element. When this occurs at the end of the page, the table breaks across a page. To remove the extra lines, you can either:
  • Replace the paragraph element with a container element. Containers do not have the same formatting properties as paragraphs and do not create extra lines.
  • Add a style to ensure that the table does not break across pages. Select the paragraph element and in the Properties view, expand Formatting > pagination and for the keep lines together parameter, enter true.
The output looks different in different formats. For information about determining which output type to use for a template elements you are using, see Specifying output properties.
Table 2. Microsoft Word issues
Issue Troubleshooting suggestion
Cannot run Microsoft Word macros
  • Ensure that Microsoft Word is installed.
  • Verify that the macro is defined in the style sheet.
Object Linking and Embedding (OLE) does not display and macros do not generate the Microsoft Word output when Rational Publishing Engine generates documents remotely.

When Apache Tomcat is executed as an NT Service, you cannot run macros during Rational Publishing Engine remote engine generation on a Microsoft Windows 2008 64-bit computer.

Environment: Microsoft Windows 2008, Microsoft Office Word 2007.

Microsoft does not support office automation without a graphical user interface.

  • On Microsoft Windows 2008 64 bit, create the folder Desktop in the directory: C:\Windows\SysWOW64\config\systemprofile
  • On Microsoft Windows 2008 Server x86, create the folder Desktop in the directory: C:\Windows\System32\config\systemprofile
See Excel 2007 automation on top of a Windows Server 2008 x64.

Feedback