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 in <p
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:
@otherpropsattribute are equivalent:
otherprops="groupA(a b) groupA(c) groupZ(APPNAME)" otherprops="groupA(a b c) groupZ(APPNAME)"
@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, such as 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, <ph product="operatingSystem()"> is equivalent to <ph>.
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 sampleGroup="value" will
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 oddgroup(),
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.
Return to main page.
Standards Track Work Product
|Copyright © OASIS Open 2016. All Rights Reserved.||25 October 2016|