Configure a ditaval

You can add, remove, or modify the rules in a ditaval using the Ditaval Editor. The rules tell CCMS Web how to handle conditional profiling attributes when generating an output.

A ditaval is a set of rules that specify which values for conditional profiling attributes CCMS Web must include or exclude when generating an output.

The Ditaval Editor is like a simplified version of Topic Editor with only the required controls need to configure a ditaval.

To configure a ditaval:

  1. In Ditaval Editor, click +....
  2. From the dropdown list, select +filter.
    A filter row is added to the ditaval in a <prop> element.
  3. From the first dropdown list, select how to handle content that matches the conditional profiling attribute and its value by choosing one of the following attributes:
    Table 1. Conditional profiling attribute options

    Item

    Action

    Flag

    Includes flagged content, but through formatting in output

    Note: Once you chose it, the flag item provides you with additional options about how to format the flagged content, such as style, color, and background.

    Include

    Includes content in the output

    Exclude

    Excludes content in the output

    Passthrough

    Includes content in the output and also retains the condition as part of the output

  4. From the second dropdown list, select an attribute.
    Available attributes depend on your system configuration. Typical attributes include things like audience, platform, and product.
  5. In the field, enter the value for the attribute you want.
    Note: If you do not set any value for the attribute, the action you picked will be applied to all matching attributes with any value. This is a quick way of including or excluding attributes entirely from an output.
  6. Optional: To add a description for a ditaval that does not have one, take the following actions:
    1. After the title, click Add Description.
      A shortdesc element appears.
    2. In the shortdesc element, enter a description for the ditaval.
    The description will appear in menus where the ditaval appears, such as in Search.
  7. To save your changes and make them usable, click Check in.
You can now apply your current configuration of the ditaval when generating output. You can see a quick summary of the configuration of the ditaval in the expanded row for it in Search.