Edit online

Filtering Profiling Values with a DITAVAL File

You can use a DITAVAL filter file to control the filtering or flagging of profiled content or to identify which values are to be used for conditional processing during a particular output.

DITAVAL Filtering Use-Case

Suppose that a medical publication uses the audience profiling attribute to profile the content for the following types of users: therapist, physician, and surgeon. Suppose that in the output, you want to exclude any content that is profiled as surgeon value for the @audience attribute.

You could use a DITAVAL filter file to exclude anything that is profiled as surgeon:

<val>
     <prop action="exclude" att="audience" val="surgeon"/>
</val>

If you then transform the main DITA map and specify the DITAVAL filter file in the transformation scenario, the output will exclude anything that is profiled as surgeon).

DITAVAL Filter File Editor in Author Mode

The Author editing mode in Oxygen XML Editor Eclipse plugin offer a simple and intuitive editor for creating or modifying DITAVAL files. It provides a series of drop-down menus and text fields that allow you to easily define the filters.

Figure 1. DITAVAL File Editor in Author Mode
Use the +... button to display a drop-down list that contains elements that you can add at that particular location in the DITAVAL file. Clicking this button at the top (next to the DITAVAL FILTER File title, allows you to insert the following elements:
  • Style Conflict - Inserts a <style-conflict> element that declares behavior to be used when one or more flagging methods collide on a single content element. You can use the simple drop-down menus to select values for the @foreground-conflict-color and @background-conflict-color attributes.
  • Filter - Inserts a <prop> element that identifies an attribute to apply a filtering action on. The possible actions that you can select are include, exclude, passthrough, and flag. If you select the flag action, you can use the drop-down menus to select values for the @style, @color, and @background attributes.
  • Flag - Inserts a <revprop> element that Identifies a value in the @rev attribute that should be flagged in some manner. The allowed actions are include, passthrough, and flag. If you select the flag action, you can use the drop-down menus to select values for the @style, @color, @background, and @changebar attributes.

See the DITAVAL Element Specifications for more details about the allowed filters and flags.

How to Create a DITAVAL Filter File

To create a DITAVAL filter file, follow these steps:
  1. Go to File > New.
  2. Scroll to the Framework templates > DITA folder.
  3. Select the Filter template file and click Create.
  4. Define your filters in the DITAVAL file (in Text or Author mode).
  5. Save the DITAVAL file.
Result: The DITAVAL filter file can now be used for all of the following: