Configuring Single Effectivity

A system administrator must configure the Astoria application to support Single Effectivity for conditional processing.

Important: Astoria can be configured to support either Effectivity or Filtering. The two methods cannot be used simultaneously. Configuring for Effectivity disables the Filtering method of conditional processing. See Features of Filtering, Effectivity, and DITAVAL Methods. Additionally, effectivity processing can be configured to support either Multiple or Single effectivities. The two methods cannot be used simultaneously.

Single Effectivity configuration requires defining XPath expressions for each DTD used by documents that will be conditionally processed.

  1. In the Workbench, navigate to and select the application document, located in the Administration cabinet.
  2. Right-click the document and select File > Edit.
    The application document webform opens for editing.
  3. Scroll down in the webform and locate the Use Filtering check box.
  4. Ensure the check box is cleared (not selected).
  5. To configure single effectivity processing, ensure the Multiple Effectivities check box is cleared (not selected).
  6. For each DTD, define the Effectivity XPaths settings.
    The Effectivity XPaths settings use a repeat group, allowing you to define settings for multiple DTDs.
    1. In the Effectivity XPaths area, click New.
    2. If necessary, expand the DTD field by clicking , then click Browse and navigate to and select the DTD you are defining.
      The DTD name appears in the DTD field and in a row the Effectivity XPath box.
    1. With the DTD name selected in the Effectivity XPaths area, enter an XPath expression in the Effectivity Definition XPath field.
      This is the XPath in the XML document that defines the list of all possibly effectivities for that document.
      For example, /doc/@effectivityList.
    1. With the DTD name selected, enter an XPath expression in the Effectivity Scope XPath field.
      This is the XPath that defines where the effectivity values are located, relative to that element.
      For example, /@bodyType.
    1. Add additional DTDs and XPath settings in the repeat group as appropriate.
  7. For Separator String, specify the string to use to separate a list of effectivity values.
    For example, enter a single space.
    Once this value is specified and your organization has implemented Single Effectivity processing, do not change the value.
  8. For Range String, specify the string to use when specifying a range of effectivity values.
    For example, a space, hyphen, space ( - ).
  9. Scroll to the top (or bottom) of the webform and click Checkin Document.
  10. When prompted, provide a checkin note indicating what was changed in the webform, then click OK.
The Astoria application is now configured to use Single Effectivity for conditional processing.
Parent topic: About Effectivity