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.
In this section:
- Example: Single <ditavalref> on a branchA single <ditavalref> element can be used to supply filtering conditions for a branch.
- Example: Multiple <ditavalref> elements on a branchMultiple <ditavalref> elements can be used on a single map branch to create multiple distinct copies of the branch.
- 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.
- Example: Single <ditavalref> in a reference to a mapUsing a <ditavalref> element in a reference to a map is equivalent to setting filtering conditions for the referenced map.
- Example: Multiple <ditavalref> elements as children of
<map> in a root mapUsing 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.
- Example: Multiple <ditavalref> elements in a reference to a
mapUsing 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.
- 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.
- Example: <ditavalref> error conditionsIt is an error condition when multiple, non-equivalent copies of the same file are created with the same resource name.
Parent topic: Branch filtering