Creating model-to-model transformation mapping projects

A mapping project is a standard plug-in that specifies a transformation provider, which is the mechanism that defines transformations. A mapping project also contains at least one mapping model. When you create a mapping project, a mapping model is created in the project, based on the input and output models that you specify.

The extensibility features are packaged as an optional product component that you must install if you want to create transformations. You must enable the Modeling and XML Developer capabilities.

You can specify one or more source and target metamodels when you create a mapping project. You can specify metamodels, which have .ecore as a file name extension, or UML profiles, which have .epx or .uml as a file name extension.

To create a mapping project:
  1. Click File > New > Project.
  2. In the New Project wizard, on the Select a wizard page, click Transformation Authoring and click Model to Model Mapping Transformation Project.
  3. Click Next.
  4. On the Plug-in Project page, in the Project name field, specify a project name. You can accept the default values for the other fields on the page.
  5. Click Next.
  6. On the Plug-in Content page, review the values and click Next.
  7. On the Templates page, from the Available Templates list, select Plug-in with Transformation Mapping.
  8. Click Next.
  9. On the New Transformation Mapping page, in the Map name field, specify a name for the transformation mapping file.
  10. In the Package name field, specify the name of the base package that contains the transformation source files. The package name that you specify is created in the same plug-in as the transformation mapping that you create.
  11. To specify the source and target input model or models, complete the following steps:
    1. Click Add Model beside the corresponding area of the New Transformation Mapping page.
    2. In the Load Resource dialog box, click the appropriate button to browse to the model or models.
    3. Click the model or models, click Open, and click OK.
    If you specify source and target metamodels when you create a project, the necessary dependencies are added to the plug-in manifest file automatically. If you add the metamodels by using the commands in the editor area after you create the mapping project, you must add any new required dependencies to the plug-in manifest file.
  12. Click Finish.

The generated mapping project contains a mapping model. A mapping project can contain multiple mapping models.

Parent topic: Authoring model-to-model transformations
Related concepts
Model-to-model transformation authoring
Related information
Enabling workbench capabilities
Feedback