Using Ditaval files for conditional processing

IXIASOFT CCMS offers an intuitive interface for creating and organizing Ditaval files.

If you are using conditional attributes extensively in your documentation, you should take advantage of Ditaval files. These files specify the conditions to include and exclude when you generate your output. They ensure that conditions are always applied consistently to generated output.

For example, consider a documentation project with three conditions:
  • Platform: Linux or Windows
  • Audience: Sys_Admin or End_User
  • Product: Product A or Product B
You could create one Ditaval file for each combination that you need to generate. For example, the following code shows the Ditaval file for generating the Administration Guide for Product A on Linux:
<?xml version="1.0" encoding="UTF-8"?>
<val>
	<prop action="exclude" att="audience" val="end_user"/>
	<prop action="include" att="audience" val="sys_admin"/>
	<prop action="include" att="platform" val="linux"/>
	<prop action="exclude" att="platform" val="windows"/>
	<prop action="include" att="product" val="Product A"/>
	<prop action="exclude" att="product" val="Product B"/>
</val>
With the CCMS, you do not need to code the Ditaval file manually; you simply use the Ditaval view to create the file. You then apply the Ditaval file that you need when you generate the output for your maps.
Note: Before you create Ditavals, confirm with your administrator that they are used by your transformation scenarios to generate output.