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.

Before you begin

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

About this task

The functionality for authoring JET transformations supports the following JET actions:
  • File actions
  • Folder actions
  • Project actions

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:

Procedure

  1. In the editor area, in the Exemplar pane, right-click one or more exemplar artifacts; then select Create Exemplar Reference.
  2. In the Create Exemplar Reference window, 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.
  3. Optional: Specify a new name for the action in the text field.
  4. Click File > Save.

Results

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.

Example

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 window, 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.

Feedback