Generating reports with transformations

The product provides an example of a model transformation (the report simplification transformation example) and a corresponding example of a report design (the Sample SUML design). The transformation simplifies the model before the report is generated. You can use the transformation and report design to generate a report, and report designers can use the transformation and report design as a reference when they create custom report designs that use transformations.

Procedure

To generate a report with a model transformation such as the report simplification transformation example:

  1. Ensure that the plug-ins for the transformation are in your current workspace.

    If the report design that you are using is the "Sample SUML design" report design, import the report simplification transformation example. This transformation simplifies the model before the report is generated to produce a simplified report. To import the example, complete the following steps:

    1. Click File > New > Example.
    2. Expand Reporting Plug-ins and double-click Report simplification transformation example. The three example plug-ins are imported into your workspace.
  2. In the plugin.xml file that contains the transformation code, add one of the following property elements to the com.ibm.xtools.transform.core.transformationProviders extension to identify the type of output model that the transformation produces during report generation.
    • If an org.eclipse.core.runtime.contentTypes extension is defined for the output resource type, add a new property element with an id of "TargetContentType" and a value that is the ID of the content type of the transform output.
    • If no content type is defined for the transform output, add a new property element with an id of "TargetFileExtension" and a value that is the file extension for the transform output.

    You do not need to perform this step if you are using the "Sample SUML design" report design.

  3. In the Java™ perspective, click Run > Run Configurations.
  4. Type a name for the launch configuration, ensure that the Location field specifies a workspace other than the current workspace, and click Run. You can now use the transformation in the new workspace when you generate reports.
  5. Follow the procedure for generating model information reports. On the Main page, select the report design that works with the transformation. On the Transform page, select the check box for the transformation.
    Note: If you are using the example, select the "Sample SUML design" report design and the report simplification transformation.

Feedback