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 (
)
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
(
).
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
- 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 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.
- Optional: Specify a new name for the action
in the text field.
- Click .
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.