Converging multiple properties

You can promote properties from several nodes in a message flow to define a single promoted property that provides a single value to be for that property in all those nodes.

Before you start

To complete this task, you must have completed the following task:

To converge multiple node properties to a single promoted property:

  1. Switch to the Broker Application Development perspective.
  2. Open the message flow for which you want to promote properties, either by double-clicking the message flow in the Navigator view, or by right-clicking it in the Navigator view and clicking Open

    The message flow contents are displayed in the message flow editor view. If this is the first message flow that you have opened, the message flow control window and the list of available built-in message flow nodes are also displayed, to the left of the editor view.

  3. In the editor view, right-click the symbol of any message flow node in the message flow, and click Promote Property. The Property Promotion dialog is displayed.
  4. Expand the property trees for all the nodes for which you want to promote properties.
    1. Drag the first instance of the property that you want to converge from the list on the left, and drop it on the appropriate group in the list on the right. If the group already contains one or more promoted properties, the new property is added at the end of the group. Rename the new property if you want to.

      If you want the promoted property to appear in a new group, you can either create a new group using the new group icon above the list on the right before you promote the property, or you can drag and drop the property into an empty space below the existing groups, which forces a new group to be created. Rename the group if you choose.

      If you drag the property onto an existing promoted property of a different type, a no-entry icon is displayed and you cannot drop the property. You must create this as a new promoted property, or drop it onto a compatible existing promoted property. Properties must be associated with the same property editor to be compatible. For example, if you are using built-in nodes, you can only converge like properties (string with string, boolean with boolean).

  5. Drag all remaining instances of the property from each of the nodes in the list on the left onto the existing promoted property. The new property is added under the existing promoted property, and is not created as a new promoted property.
  6. Click Apply to commit this change without closing the Property Promotion dialog. Click OK to complete your updates and close the dialog.
Related concepts
Promoted properties
Related tasks
Defining promoted properties
Promoting a property
Renaming a promoted property
Removing a promoted property
Related reference
Built-in nodes