2.4.4.6 Examples of branch filtering

The branch filtering examples illustrate the processing expectations for various scenarios that involve <ditavalref> elements. Processing examples use either before and after sample markup or expanded syntax that shows the equivalent markup without the <ditavalref> elements.

2.4.4.6.1 Example: Single ditavalref on a branch
A single <ditavalref> element can be used to supply filtering conditions for a branch.
2.4.4.6.2 Example: Multiple ditavalref elements on a branch
Multiple <ditavalref> elements can be used on a single map branch to create multiple distinct copies of the branch.
2.4.4.6.3 Example: Single ditavalref as a child of map
Using a <ditavalref> element as a direct child of the <map> element is equivalent to setting global filtering conditions for the map.
2.4.4.6.4 Example: Single ditavalref in a reference to a map
Using a <ditavalref> element in a reference to a map is equivalent to setting filtering conditions for the referenced map.
2.4.4.6.5 Example: Multiple ditavalref elements as children of map in a root map
Using multiple instances of the <ditavalref> element as direct children of the <map> element in a root map is equivalent to setting multiple sets of global filtering conditions for the root map.
2.4.4.6.6 Example: Multiple ditavalref elements in a reference to a map
Using multiple instances of the <ditavalref> element in a reference to a map is equivalent to referencing that map multiple times, with each reference nesting one of the <ditavalref> elements.
2.4.4.6.7 Example: ditavalref within a branch that already uses ditavalref
When a branch is filtered because a <ditavalref> element is present, another <ditavalref> deeper within that branch can supply additional conditions for a subset of the branch.
2.4.4.6.8 Example: ditavalref error conditions
It is an error condition when multiple, non-equivalent copies of the same file are created with the same resource name.

Parent topic: 2.4.4 Branch filtering

Previous topic: 2.4.4.5 Branch filtering: Implications of processing order

Next topic: 2.4.4.6.1 Example: Single ditavalref on a branch

Return to main page.