Creating Applicability (Arbortext only)
This task describes how to create new applicability using Applicability Manager.
Procedure
- In Arbortext Editor, select Contenta > Manage Applicability.
The Manage Applicability tab of the Applicability Manager window appears showing DM-level applicability (if defined), and Referenced Applicability (if defined).Note: The Reference Count column shows the number of times each Referenced Applicability is assigned to content in your DM
- Select New.
The Build Applicability tab appears with Reference Group Level active. The Saved Assert Statements tab is also active if there are asserts saved in the database.
- Enter Referenced Applicability information.
- In the Display Text field, enter a string.
Describe what the assertion does by entering text in the Display Text field. This text will be inserted between
<displayText>tags in the DM, and appears in the Manage Applicability and Assign Applicability interfaces, and is stored with the assert in the database.Note: Do not enter single quotes in the Display Text field. - In the Applicability ID field, enter a unique ID (this is a required field).
Identify the assertion as Referenced Applicability by accepting the default ID, or entering your own text and a number in the Applicability ID field. This will be inserted between the
<applic>tags of the referenced Applicability in the<referencedApplicGroup>markup. The string that you enter appears adjacent to the Applicability ID field, and serves to identify the Referenced Applicability.Tip: If the Applicability ID is too long, it may be obtrusive when viewed in an IETM. Also, do not use special characters when naming an Applicability ID.Important: If the Applicability does not have an ID, Applicability Manager assigns a temporary one namedTEMP-000n. Before you can edit or delete a temporary Applicability 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 Applicability ID. The Applicability ID you enter should be text followed by a number. Once you name and save an Applicability, the next one you create uses the same base name, incremented by the next available number available from the database.Tip: If you are a system administrator, you can set up a custom Applicability ID naming prefix for use by members of your team. See AppData settings for Contenta S1000D tools.
- In the Display Text field, enter a string.
- Do one of the following:
- From the Create Assert Statement tab, select SELECT THIS ITEM TO ADD NEW OPERATOR OR ASSERT.
- From the Saved Assert Statement tab, select a saved assert statement to seed the new applicability, select Add to Assert Statement, then select the Create Assert Statements tab.
Tip: You can select XML Preview to view the underlying XML markup of the selected Applic ID before you commit to adding it to your assert.
Important: In addition to attributes and conditions in the ACT, CCT, and PCT files, you can add to your new assert by choosing from saved asserts stored in the same database. - Select either AND or OR.
The logical operator is inserted in the Assert Statement field.
- In the Assert Statement field, select SELECT THIS ITEM TO ADD NEW OPERATOR OR ASSERT.
- In the Select field, do one of the following:
- Select Attribute, then select an attribute.
- Select Condition, then select a condition.
- Select By Product, then select a Product ID.
- In the Values field, select a value (or CTRL-click to select multiple values).
Note: If you selected Attribute or Condition, and the value list is empty, enter a value in the Type a value field. You can specify a range value for the desired attribute or condition in the Type a value field. If a numeric range is specified and a single item is selected in the value list, this entry is validated against the selection in the value list. If there are multiple items selected in the value list or the selection is a non-numeric range, the entry is used as an assert value without any validation. If the Type a value field is empty, the value(s) of the item(s) selected in the value list are used to form an assert statement.Tip: If you selected By Product, you can select individual product attributes for each Product ID.
- Select Add to Assert Statement.
The new attribute or condition, and its value, is inserted in the Assert Statement field.Tip: Alternatively, you can double-click a value to add it to the assert statement.
- Select Insert XML.
Applicability Manager writes your edits to the DM, to the database, and then exits. Asserts written to the database are available for selection in future edit sessions.