Documentation Center

Assigning Applicability

This task describes how to assign Referenced Applicability to data in the DM. Referenced Applicability lets you tag pieces of content within a DM, and process that content by adhering to statements that you add to an applicability notation (applicability expression).

Before you begin

  • Applicability must be defined using the markup as described in the section titled Applicability.
  • For the UI to display a description of the applicability, ensure that the applicability expression contains the <displayText> tag with the description.
  • After displaying the applicability, if you modify the applicability expression outside Applicability Manager, click Refresh to re-read the data.
  • The DM must be open in the XML editor to access the menu options.
  • The applic ID you enter should be text followed by a number. If you do not specify an ID, Applicability Manager assigns a temporary one named TEMP-00n. Before you can edit or delete a temporary ID in the Manage Applicability interface, or assign one to inline text in the Assign Applicability interface, you must edit the XML markup to give it a permanent ID.

Procedure

  1. In the editor, do one of the following.
    • In Arbortext Editor, select Contenta > Applicability.
    • In Oxygen XML Author, select the Contenta S1000D tool panel Applicability tab.
    Note the following:
    • The Assign Applicability interface displays the following label: Implicit applicability references are not supported in this release. For Issue 4.1 or higher, only explicit CIR applicability references (references that include the <dmRef> tag of the applicability CIR DM) are displayed in the Assign Applicability interface. In multi-language CSDBs, only explicit references to applicability CIR DMs in the same language are displayed in this interface.
    • If an Issue 4.1 or higher DM is using CIR applicability but incorrect or missing attribute values invalidate a CIR reference, the an error such as the following is displayed in the editor status bar:
      Some CIR applicability references could not be resolved. See latest log file under <Contenta>\logs\XyArbortextPlugin.
  2. Place your cursor to the right of the begin tag that contains the data to which you want to assign the applicability expression.
  3. Choose the applicability expression, denoted by the applic id: <appli-nnn> : <...displayText data...> that you want to apply.
    Note the following:
    • The applic id: does not have to conform to the <appli-nnn> form. You can specify any textual prefix, followed by a number.
    • displayText data is the data between the <displayText> tags within the applic id tags. <displayText> tags are optional and are typically used to describe the applic expression. If there is no <displayText> tag, only the applic id is shown.
    • If you select an Issue 4.1 or higher CIR applicability notation:
      • The Modify button is deactivated since Contenta S1000D does not support updating the CIR DM while editing a different DM. The CIR DM must be edited directly in order to update it.
      • The New button is deactivated since Issues 4.1 and higher do not permit <applic> tags or <referencedApplicGroup> tags to be added to a DM that contains <applicRef> or <referencedApplicGroupRef> tags respectively.
  4. Click Apply.
    The applicability expression is applied to all information within the start and end tags.