Specifying conditions

When generating the output for DITA files, users can specify conditions using Ditaval files or by setting user parameters in the Generate Output dialog.

You need to determine the methods you want to support and configure your deployment as required. You can pick a single method or use a combination of both.

Using Ditaval files

Ditaval files specify the conditions to include and exclude when generating the output using the DITA Open Toolkit. They ensure that conditions are always applied consistently to generated output. Users can specify a Ditaval file in the Generate Output dialog. When a Ditaval file is specified, the Output Generator sends the files to transform along with the Ditaval file to the DITA Open Toolkit, which handles the filtering. The Output Generator does not apply any filtering to the files.

Specifying the conditions as user parameters in the Generate Output dialog

Users can also specify conditions directly in the Generate Output dialog. To implement this method, you configure the Output Generator by defining conditions as user parameters in the Conditions preprocessor. When the Output Generator retrieves the files to transform from the TEXTML Server, it retrieves the files and then filters them according to the conditions specified by users. Filtering is therefore performed by the Output Generator before sending the files to the transformation scenario.

Using a combination of Ditaval files and user parameters

If you specify conditions both in a Ditaval file and as user parameters, be aware that the TEXTML Server will first apply the conditions specified in user parameters before sending the files to the DITA Open Toolkit. Therefore, the DITA Open Toolkit will apply the filtering specified in the Ditaval to DITA files that have already been filtered by the TEXTML Server.