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:
-
From Views, open the view that contains the target viewpoint.
-
Select the target viewpoint.
-
Place your cursor to the right of the viewpoint name, click
, and then select Inspect.
-
Select Subscriptions, and then click the name of the subscription that you want to add a top node filter to.
-
In the Subscription Inspector, select the Filters tab, and then click Edit.
-
In Included Top Nodes, click Add.
-
In the node selector, select one or more top nodes to subscribe to. Perform an action:
- Type the name of a 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.
Nodes that you select are indicated by a check mark and added to the Selected tab. Click the X to remove a node from the Selected tab.
Note:
By default, the node description is displayed next to the node name in the node selector. Click Show Node Property
to select a different property to display in the node selector. The properties that you have configured to be displayed as columns in the viewpoint are available to select. See Configuring How a Viewpoint Displays Properties.
-
When you have finished selecting top nodes, click OK, and then click Save.
To remove a top node filter:
-
On the Definition tab of the subscription inspector, click Edit.
-
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.