Specify conditions using a Ditaval file

You can select an existing ditaval file using the Ditaval option on the Generate Output dialog to filter your output based on the conditions in the ditaval file.

To implement ditaval files in your deployment, make sure that your DITA Open Toolkit transformation handles ditaval files to generate output. Otherwise, filtering will not be applied.

Note: You only see the Ditaval option on the Generate Output dialog if there is at least one ditaval file in your CCMS.

You must also set the ditaval file name in the build.properties file by calling the ot_build_add_ditaval_ifpresent macro in the transformation scenario target. The ot_build_add_ditaval_ifpresent macro sets the args.filter parameter in the build.properties file.

To specify conditions using ditaval:

  1. Open the conductor file (for example, %OutputGenDir%/data/conductor-acme.xml) with a text editor.
  2. Find the applicable target.
  3. Add the following macro call to your target: 
    <ot_build_add_ditaval_ifpresent>
    For example:
    <target name="acme.dita2pdfwrapper" depends="default_dependencies, flatten, resolve_container_keyref, extract_HiRes_images">
	<echostart>acme.dita2pdfwrapper</echostart>

	<!-- These are the required target calls to do -->
	<ot_build_add_ditaval_ifpresent/>
	<ot_build_clean_ot_temp/>

	...

	<echoend>acme.dita2pdfwrapper</echoend>
</target>
  4. Save and close the conductor file.