Removing a promoted property

If you have promoted a property from the node to the message flow level, you can remove (delete) it if you no longer want to specify its value at the message flow level. The property reverts to the value that you specified at the node level. If you remove a promoted property that is a mandatory property, ensure that you have set a value at the node level. If you have not, you cannot successfully deploy a broker archive file that includes this message flow.

Before you start:

If you have promoted one or more message flow node properties, and want to delete them:

  1. Switch to the Broker Application Development perspective.
  2. Open the message flow for which you want to promote properties by double-clicking the message flow in the Navigator view. You can also open the message flow by right-clicking it in the Navigator view and clicking Open The message flow contents are displayed in the 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 the message flow node whose properties you want to promote.
  4. Select Promote Property.

    The Promote Property dialog is displayed.

    The Promote Property dialog
  5. Select the promoted property that you want to remove in the list of properties on the right of the dialog, and click Remove. The property is removed from the list on the right. It is restored to the list on the left, in its appropriate place in the tree of properties for the node from which you promoted it. You can promote this property again if you choose.
  6. If you want to delete all the promoted properties within a single group, select the group in the list on the right and click Remove. The group and all the properties it contains are deleted from this list: the individual properties that you promoted are restored to the nodes from which you promoted them.
  7. Click Apply to commit this change without closing the Property Promotion dialog. Click OK to complete your updates and close the dialog.

If you have included this message flow in a higher-level message flow, and have set a value for a promoted property that you have now deleted, the embedding flow is not automatically updated to reflect the deletion. However, when you deploy that embedding message flow in the broker domain, the deleted property is ignored.

Related concepts
Promoted properties
Related tasks
Defining a promoted property
Promoting a property
Renaming a promoted property
Converging multiple properties
Related reference
Built-in nodes