Configuring the properties of a transform

Configure the properties of a transform to set the value of an output element; define a conditional expression that determines whether the transform is applied; define the indexes to use when the input element is a repeating structure; or reorder the way in which inputs to a transform are handled by the Graphical Data Mapping editor.

Complete the following steps to configure the general properties of a transform:

• Open the Properties view of a transform by using any of the following methods:
  • Select a transform. Then, select the Properties tab.
  • Right-click the transform, and then select Show in > Properties view.
  • When the map is in full vie, select Alt+Enter.

    You can configure these keyboard shortcuts by selecting Window > Preferences > General > Keys.

  Note: You can detach the Properties view from the map. This is very useful if you have a secondary workstation screen. In one workstation screen you can see the map, and in the other you can see the properties map.
• In the Properties tab, add, modify, or remove resources:
  • Select Cardinality to select the indexes of the input and output elements that you want this transform to operate over. For more information, see Selecting the indexes of input array elements.
  • Select Variables to list the names of the input elements that are connected to the transform. Select Edit to change the name of a variable.
    Note: When you change the name of a variable, the new name is the one you see when you use content-assist to create your expressions.
  • Select Condition to define the XPath expression that must be evaluated against the input element before the transform is applied. If the condition evaluates to true, the transform is applied. For more information, see Defining an XPath conditional expression for a transform and Defining a Java conditional expression for a transform.
  • Select Filter to define an expression that must be evaluated against each element on a repeating input element before the transform is applied. If the condition evaluates to true, the transform is applied for each input.
  • Select Sort to sort the inputs to the transform by ascending order, descending order, case order, or data order. Then, complete the following steps:
    1. Select Sort the inputs to this transform.
    2. Add elements to the Sort by column.
    3. Select a sort method.
    Note: The element or elements that are used to provide the sort must provide a singular, scalar value. If you nest sorts, each sort uses the original input data value for the sort element. Specifically, the outer sort cannot use the result of a nested sort.
  • Select Order to display the order of input connections to a transform. You can reorder them.
  • Select Documentation to provide a description of the transform, or other relevant usage notes.