Configuring a runtime workbench to test model-to-model transformations

You can invoke a runtime workbench to test and debug transformations. You might want to use the runtime workbench to avoid packaging the transformation plug-in before testing the transformation.

About this task

After you create and open the runtime workbench, you can create source and target models to test the transformation code. The transformation transforms the elements that you create in the source model and generates output in the target model.


  1. Open the Plug-in Development perspective: Click Window > Open Perspective > Plug-in Development.
  2. To open a runtime workbench, complete one of the following steps:
    • For non-debug mode, click Run > Run Configurations.
    • For debug mode, click Run > Debug Configurations.
  3. In the Run window, in the left pane, click Eclipse Application and click the New launch configuration icon, which is the first icon on the left of the toolbar.
  4. Click the Configuration tab.
  5. Click Use an existing config.ini file as a template and accept the default value in the Location field. These values specify that the runtime instance is an instance of the product that you are running, instead of a default Eclipse instance, which does not provide enough functionality to test a transformation.
  6. Click Apply.
  7. Depending on your selection in step 2, click Run or Debug.
    Note: If projects in the workspace contain errors, a dialog box that lists the projects is displayed. To continue to start the runtime workbench, click Proceed.
    The new runtime workbench opens.
    Note: Depending on the system resources that are available, the runtime workbench might take a few minutes to open.
  8. In the runtime workbench, create a project that contains a model that the transformation transforms. For example, if the target transformation accepts a UML model, create a UML model in the project.
  9. In the runtime workbench, create a target container where the transformation generates output. If the transformation generates a UML model, create a UML modeling project. If the transformation generates a code model, create a project of the appropriate domain type. For example, if the transformation generates Java™ source code, create a Java project.