Sample assets in RPE Document Builder

Out-of-the-box sample assets have been available in the Rational Publishing Engine (RPE) Desktop installation of RPE Document Studio and RPE Launcher for many versions. These sample assets are now included within RPE Document Builder 2.1.1.

Find details at https://jazz.net/blog/index.php/2017/01/19/sample-assets-in-rational-publishing-engine-document-builder/

 

Math equations in Word and PDF documents in RPE 2.1.1

With Rational Publishing Engine (RPE) 2.1.1, we can render mathematical equations in Word and PDF documents. RPE expects input to be MathML format to be able it to render them. See examples of mathematical equations in MathML format at MathJax. Microsoft Word DOCX format has built-in support for math equations (through MathML) with an equations editor to create and modify equations.

https://jazz.net/blog/index.php/2017/01/18/math-equations-in-word-and-pdf-documents-from-rational-publishing-engine/

 

JavaScript improvements with Rational Publishing Engine 2.1.1

JavaScript is one of the key components while building a Rational Publishing Engine (RPE) template. The plain JavaScript dialog editor has been improved with:

  • Content Assist: Ctrl + space lists available variables, helps with syntax of various JavaScript functions, parameters to be passed to a function. Tip: If the variable is a data attribute from a query, store it in a JavaScript variable to take advantage of content assist.
  • Syntax coloring: For any programming language, syntax coloring is a must.
  • Line marking: The line containing the cursor has a line marking.

Find more at https://jazz.net/blog/index.php/2017/01/17/javascript-improvements-with-rational-publishing-engine-2-1-1/

Generate documents from fine-grained components

Rational Publishing Engine (RPE) 1.3 and above was already capable of configuration-aware document generation. With Collaborative Lifecycle Management (CLM) 6.0.3, we can use configurations of separate components in the project area to achieve re-usability. Rational DOORS Next Generation (RDNG) and Rational Quality Manager (RQM) offer the reusable solution. With RPE 1.3 (yes, 1.3) and above, we can generate documents by selecting the configuration of a component through RPE Launcher (desktop application) and also from RPE Document Builder (Web application) while configuring the template data source.

Find more details at https://jazz.net/blog/index.php/2017/01/16/generate-documents-from-fine-grained-components/

 

Data Source Configuration conflicts detected

If you notice “Data Source Configuration conflict detected” error in problems view upon opening a template in RPE studio, you should fix it immediately to avoid undesired results. The document generation might go through successfully for some case. However, for some cases the document generation could fail as well.

The data source configuration conflict happens when you use a schema normally and then use the same schema to configure the DSC element as in the below screen capture.

ds_conflilct

How to fix the conflict

Duplicate the conflicting schema either by using “Duplicate Schema” option from the outline. If the duplicate option is not available, go through the normal Add Schema operation to add the  schema with a different name again.

duplicate_schema

Once the schema is duplicated as _resources (or any unique name), use this schema to configure the DSC element and make sure to configure rest of the properties like URL, inherited data source, etc for the DSC element as earlier.

ds_conflict_fix

After you fix the issue, re-opening the same template should NOT result in “Data Source Configuration conflict detected” in the problems view.