184.108.40.206 Conditional processing values and groups
Conditional processing attributes classify elements with metadata. The metadata is specified using space-delimited string values or grouped values.
For example, the string values within
product="basic deluxe"> indicate that the paragraph applies to the “basic” product
and to the “deluxe” product.
Groups organize classification metadata into subcategories. This is
intended to support situations where a predefined metadata attribute applies to multiple specialized
subcategories. For example, the
@product attribute can be
used to classify an element based on both related databases and related application servers. Using
groups for these subcategories allows each category to be processed independently; when filter
conditions exclude all applicable databases within a group, the element can be safely excluded,
regardless of any other
Groups can be used within
@otherprops. The following rules apply:
- Groups consist of a name immediately followed by a parenthetical group of
or more space-delimited string values. For example,
- Groups cannot be nested.
- If two groups with the same name are found in a single attribute, they should be treated
as if all values are specified in the same group. The following values for the
@otherpropsattribute are equivalent:
otherprops="groupA(a b) groupA(c) groupZ(APPNAME)" otherprops="groupA(a b c) groupZ(APPNAME)"
- If both grouped values and ungrouped values are found in a single attribute, the ungrouped
values belong to an implicit group; the name of that group matches the name of the
attribute. Therefore, the following values for the
@productattribute are equivalent:
product="a database(dbA dbB) b appserver(mySERVER) c" product="product(a b c) database(dbA dbB) appserver(mySERVER)"
Setting a conditional processing attribute to an empty value,
product="", is equivalent to omitting that attribute from the
element. An empty group within an attribute is equivalent to omitting that group from the
attribute. For example,
<ph product="database() A"> is equivalent to
<ph product="A">. Combining both rules into one example,
product="operatingSystem()"> is equivalent to
If two groups with the same name exist on different attributes,
a rule specified for that group will evaluate the same way on each attribute. For example, if
the group "sampleGroup" is specified within both
@otherprops, a DITAVAL rule for
evaluate the same in each attribute.
If there is a need to distinguish between similarly named groups on different attributes, the
best practice is to use more specific group names such as platformGroupname and
productGroupname. Alternatively, DITAVAL rules can be specified based on the attribute name
rather than the group name.
If the same group name is used in different attributes, a
complex scenario could be created where different defaults are specified for different
attributes, with no rule set for a group or individual value. In this case a value might end
up evaluating differently in the different attributes. For example, a DITAVAL can set a
default of "exclude" for
@platform and a default of "flag" for
@product. If no rules are specified for group
or for the value
oddgroup="edgecase", the attribute
platform="oddgroup(edgecase)" will evaluate to "exclude" while
product="oddgroup(edgecase)" will resolve to "flag". See DITAVAL elements
for information on how to change
default behaviors in DITAVAL provile.
@otherpropsattributes cannot be specialized or generalized.