Using the Apply Ditaval Command to Filter with Conditions

Steps for using a ditaval file to apply conditional filtering to topics.

When run interactively, the ditaval file must be registered with DITA-FMx. To create a new ditaval file or register an existing ditaval file, use the Ditaval Manager command.

  1. Open the document or book to apply the conditions.
  2. Run the DITA-FMx > Utilities > Apply Ditaval command.
  3. In the Apply Ditaval dialog, select the Filter with Conditions option, then select the ditaval file to use from the list box.
  4. For each “action” type defined in the ditaval file, set up the options in the appropriate “action=” section.

    For example, if your ditaval file contains two prop elements where each action attribute is set to “exclude”, you need to decide if the condition to apply to the matching elements should be a specific name (one name for all “excluded” elements) or if you want it to apply a unique name for each prop element. If you’re OK with using a single condition name, just select the radio button under Condition Name and enter that name in the text box. If you’d like a unique name for each prop element, select the “<attribute>=<value>” radio button. This will make two conditions (one for each prop element), and apply each to the corresponding elements.

    Select the visibility option for the condition. You can always change the visibility after applying the conditions using the standard FrameMaker condition management commands.

  5. Choose the OK button to apply the conditions.