Filtering by Top Node

For subscriptions in hierarchy viewpoints, you can add top node filters that enable you to subscribe to a portion of a source viewpoint instead of the entire node set. You can specify multiple top nodes to subscribe to. When an update is made to the source viewpoint, if the update is within a branch that you have selected, a request is generated to make the same update in the target viewpoint. If the update in the source viewpoint is not within a branch that you have selected, no subscription request items are generated for that branch.

Considerations

• You can choose any node in a hierarchy as a top node for a filter, including nodes in the same ancestor chain or bottom-level nodes with no children.

• You cannot add top node filters to a subscription if the source viewpoint is based on a list type node set.

• Some request actions in the source viewpoint are translated to equivalent actions in the target viewpoint:

  • Add and Insert actions in the source may become Update actions in the target if the node already exists in the target.

  • If you move a node in the source out of the top node branch in the target, it becomes a Remove action in the target.

  • If you move a node in the source into the top node branch in the target, it becomes an Update action in the target, which may become an Insert if shared nodes is enabled or a Move if shared nodes is not enabled.

• When a parent node that is located under a different top node is inserted or moved under a node that is specified in a subscription top node filter, the descendants of the parent node are also inserted and moved as part of the subscription request.

To add a top node filter:

1. From Views, open the view that contains the target viewpoint.

2. Select the target viewpoint.

3. Place your cursor to the right of the viewpoint name, click , and then select Inspect.

4. Select Subscriptions, and then click the name of the subscription that you want to add a top node filter to.

5. In the Subscription Inspector, select the Filters tab, and then click Edit.

6. In Included Top Nodes, click Add.

7. In the node selector, perform an action:

   • Type the name of the top node that you want to subscribe to in the search bar and hit Enter to search for a node directly.
   • Click and drill to the top node that you want to subscribe to.
   • Optional: Click and select Show Node Description to toggle the node description on and off.

8. Click OK to select the top node, and then click Save.

To remove a top node filter:

1. On the Definition tab of the subscription inspector, click Edit.

2. In Included Top Nodes, place your cursor in the Action column of the top node that you want to remove, click , and then select Remove.