A transformation assigns default file names to the files and folders that it generates. You can specify alternate file names for any of the files and folders that a transformation generates by creating a mapping model. Specifying alternate names in a mapping model does not modify the source model. You must create a mapping model in the same workspace as the selected model elements.
To create a mapping model, you must select the source model elements on which to run a transformation. The source model elements can exist in different models or different projects. When you generate a mapping model, a separate model is created that contains an artifact for each element that you select in the source model. A manifestation relationship exists between each created artifact and its corresponding element in the source model.
The transformation assigns a default name to each artifact which refers to, and has the same name as, the corresponding source model element. The File Name property of each artifact remains empty until you provide an alternate name by specifying one in a mapping model. You can specify absolute and relative file names. Absolute file names must reference an existing project. The transformation creates parent directories that do not already exist. The transformation adds standard C++ file name extensions, such as .h or .cpp.
If a mapping file name has a specified extension, the transformation removes and replaces it with a standard file name extension such as .h or .cpp.
The next time that you run a transformation using a
mapping model, the alternate file names that you specify in the mapping model
are applied to the elements that the transformation generates.