Creating JET actions for JET transformations

You can create associations between exemplar artifacts and the transformation input schema elements. Exemplar artifacts are associated with the input schema elements through transformation output actions, also called JET actions. There are three types of JET actions: file actions, folder actions, and project actions.

You must have a transformation model file open. A transformation model file has the name transform.tma.

When an exemplar artifact is associated with an input schema and an action, a check box icon ( This image shows the check box icon which indicates that the exemplar artificact has been added to the transformation input schema. ) appears in the editor area beside the exemplar artifact. This icon enables you to easily determine which exemplar artifacts correspond to a JET action. Exemplar projects or folders that have a cleared check box icon contain artifacts that are not associated with a JET action. If no check box appears beside an exemplar artifact, it is not associated with a JET action.

After you create an association, the editor area displays the corresponding exemplar references beneath the action. The exemplar references display a reference decoration ( This image shows the exemplar reference decoration, which indicates that the output template refers to an exemplar artifact. ).

You can also nest transformation output actions, which eliminates the need to repeat path information, and enables you to easily understand where the transformation generates artifacts.

To create an association between an exemplar artifact and a transformation input schema element:

In the editor area, in the Exemplar pane, right-click one or more exemplar artifacts; then select Create Exemplar Reference.
In the Create Exemplar Reference dialog box, select a destination for the model element or JET action; then click OK. If you select a model element as the destination, new actions are created for each exemplar artifact which are assigned the name of the exemplar artifact. If you select an action as the destination, and the action is the same type as the exemplar artifact that you select, the exemplar artifact is added to the destination action, and no JET action is created.
Optional: Specify a new name for the action in the text field.
Click File > Save.

Tip: You can create an association by dragging one or more exemplar artifacts in the Exemplar pane to an element in the Transformation input schema and output actions pane.

For example, in the Exemplar pane, if you select an exemplar artifact that is a folder called MyFolder and select a JET folder action called in the Create Exemplar Reference dialog box, the MyFolder exemplar artifact is added to the JET folder action. If you specify an input schema element as the destination, a JET folder action is created.