Configuring a project used in a user-defined pattern

When a pattern user generates a user-defined pattern, copies of projects that are selected as source files in the pattern authoring project are created in the pattern instance. By default, if a pattern user customizes the projects in an instance of a user-defined pattern and then regenerates the pattern instance, those customizations are overwritten. As a pattern author, you can configure projects in a user-defined pattern project so that they are not regenerated when a pattern user regenerates a pattern instance. Pattern users can then customize these projects and regenerate pattern instances without losing the customizations. Projects that are configured so they are not overwritten are also not overwritten if a new version of the pattern is installed before the pattern user regenerates a pattern instance.

As a pattern author, you can specify how a project that is contained in a user-defined pattern is named when a pattern instance is generated. By default, the pattern instance name is added as a prefix to the project name. You can turn off this prefix. If you generate more than one instance of a user-defined pattern that contains a project name without a prefix, all instances of the pattern use the same copy of the project.

As a pattern author, you can name a project in a user-defined pattern by using the value of a pattern parameter. The project name is determined after all transformation expressions are calculated.