Promoting a property in the mediation flow editor

Properties that may be promotion are listed in the Properties view of the mediation flow editor. From this list, you can promote a property and enter its alias and value.

Promoted properties page

You can view the Promoted properties page from the Operations connection section at the top of the mediation flow editor, or from the editor's canvas as well. You can filter and sort the list to control the list display. The list of properties that you see on this page depends on the context:
  • If you click on the canvas of the Operations connections section, all the promotable properties of all the wired operations in the mediation flow appear in the Promoted properties page.
  • If you click on the canvas of the request flow or response flow, all the promotable properties of all the primitives and nodes in the flow appear in the Promoted properties page.
  • If you make a selection, such as an operation or primitive, the Promoted properties page will display all the promotable properties of that selection.
Note: A property that is in a table (such as the Filters table in the Message Filter) will appear in this list only if it has a value.

Marking a property as promoted

To promote a property, and assign an alias and value to the promoted property, work in the Promoted properties page and follow these steps.

  1. If you want to promote a property that is in a table, such as the Pattern property in Message Filter, first add the property in the details page, and save your changes. The property will now appear in the Promoted Properties page.
  2. To view the property you want to promote, click the Promoted Properties page
  3. Select the Promoted check box for the property. A default alias is created. If the property already has a value, that value is assigned to the alias. Otherwise, the default value for the property is assigned to the alias.
  4. To change the alias, type a name in the Alias column, or choose a name from the list of alias names. In the Details page, you will see a Icon indicating the property is promoted marker to indicate that the property is promoted.
  5. To change the value of a promoted property, click the Icon indicating the property is promoted marker . The Promoted properties page is displayed, and the property is selected.
    Note: You cannot change the value of a promoted property from the Details page.
  6. Enter the alias value.
  7. Return to the Details page. The value that you entered for the alias is displayed as the value of the property.
Important: Changing the value of an alias will change the value of all of the properties that have that alias.

Table-based properties

Some primitives have table-based properties with multiple columns. You can promote one column in an individual row of the table and assign an alias name to the row.

For example, the message filter primitive has a table based property named Filter which has two columns: Pattern and Terminal name. Of the two properties, only Pattern is promotable. The following image shows the Promoted properties page of a Message Filter, showing that Pattern is promoted.

A table property is displayed in the promoted properties view only if it has a value.


Message Filter Promoted properties page

The following image shows the Details page for the message filter primitive. The terminal name is editable, however the value of the pattern is not available for edit from this page.


Message Filter details page showing promoted properties

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.