Maps or map branches can be filtered by adding a
<ditavalref>
element that specifies the DITAVAL document to use
for that map or map branch.
The <ditavalref>
element is designed to manage conditional processing for the
following use cases.
Filtering rules often are specified globally, outside of the content. When global conditions set a property value to "exclude", that setting overrides any other settings for the same property that are specified at a branch level. Global conditions that set a conditional property to "include" or "flag" do not override branch-level conditions that set the same property to "exclude".
Using <ditavalref>
elements, it is possible to specify one set of
conditions for a branch and another set of conditions for a subset of the branch. As
with global conditions, properties set to "exclude" for a map branch override any other
settings for the same property specified for a subset of the branch. Branch conditions
that set a conditional property to "include" or "flag" do not override conditions on a
subset of the branch that explicitly set the same property to "exclude".
In addition to filtering, applications MAY support flagging at the branch level based on conditions that are specified in referenced DITAVAL documents.