Specifying mapping file information in submap mapping rules

In model-to-model transformations, you can specify the mapping declaration, also called a map, that a submap mapping rule invokes. A submap rule can apply a mapping declaration that exists in a separate mapping file.

Before you begin

You must have a mapping model open. A mapping model has .mapping as a file name extension. The mapping model must contain at least one mapping declaration, and a submap mapping rule must be defined in the mapping declaration.


  1. In the editor area, right-click the submap mapping rule; then click Show in Properties.
  2. In the Properties view, click the Details tab.
  3. In the File field, specify the name of the mapping file that contains the mapping declaration to apply.
  4. Click Browse to find the .mapping file in the projects in your workspace; then click the appropriate mapping file and click OK.
  5. In the Map field, from the list, select the mapping declaration to apply.
  6. Optional: To create a mapping declaration in the mapping file that is open in the mapping area, click New. In the New Map window, specify a name for the new mapping declaration and click OK. The new mapping declaration appears in the Outline view.
  7. Click File > Save.