Ditaval usage

A ditaval is a set of rules to manage the conditional profiling attributes in a map and its children topics when you generate the related output.

You can create a ditaval object and then use the Ditaval Editor to set the rules in it. The ditaval can specify which values for conditional profiling attributes to include or exclude when generating an output. Conditional profiling attributes that are excluded do not appear in the final output.

Note: By default, if a ditaval does not specify whether to include or exclude a particular conditional profiling attribute, then it is automatically included in the generated output. To exclude a conditional profiling attributes, you must explicitly configure a ditaval to exclude it.

Once created and configured, you can then apply this ditaval to content when you generate an output. Using a ditaval ensures that conditions are always applied consistently to generated output.

Example of a ditaval configuration

Consider a map with three conditional profiling attributes and two possible values for each:

Table 1. Sample conditional profiling attributes for ditaval configuration
Attribute Option

Platform

  • Linux

  • Windows

Audience

  • Admin

  • Writer

Release

  • T34

  • B52

You might create one ditaval for each combination that you need to generate. The following code shows an example of how you would configure the ditaval for generating the Administration Guide for the B52 release on Linux:

<?xml version="1.0" encoding="UTF-8"?>
				<val>
				<prop action="include" att="audience" val="admin"/>
				<prop action="exclude" att="audience" val="writer"/>	
				<prop action="include" att="platform" val="linux"/>
				<prop action="exclude" att="platform" val="windows"/>
				<prop action="include" att="product" val="B52"/>
				<prop action="exclude" att="product" val="T34"/>
				</val>

Actions for conditional profiling attribute

In a ditaval, you can define additional actions for IXIA CCMS Web to take beyond including and excluding. In Ditaval Editor, you can tell CCMS Web to take any of the following actions:

Table 2. Possible actions for conditional profiling attribute

Type

Action

Flag

Include content, but output flagged by formatting
Note: With selection, you have additional options about how to format the flagged content such as: style, color, and background.

Include

Include content in generated output

Exclude

Exclude content from generated output

Passthrough

Include content in generated output while retaining the condition as part of the output