Configuring Traceability Options

You can configure traceability processing for your installation.

You can configure these traceability options:

  • Support documents in documents traceability (in addition to requirements in documents traceability)
  • Exclude document subtypes shown when expanding the Design Input bookmark in the traceability view
  • Propagate DHF Traceability from lower revision content to higher revision content

The traceability"include" and "exclude" properties that you configure in this section work as follows:

  • The property "emxLPI.DHFTraceability.DesigInput.IncludeTypes" is considered first to fetch the required types from the design input bookmark and then the types specified inside "emxLPI.DHFTraceability.DesigInput.ExcludeTypes" are filtered out.
  • If you provide the same types in both properties, the system overrides "emxLPI.DHFTraceability.DesigInput.IncludeTypes" properties with "emxLPI.DHFTraceability.DesigInput.ExcludeTypes" and excludes those types in traceability. In case those types are required in traceability, you should modify "emxLPI.DHFTraceability.DesigInput.ExcludeTypes" to remove those type entries.
  • The possible values for "emxLPI.DHFTraceability.DesigInput.IncludeTypes" are type_DOCUMENTS (which includes type_RequirementSpecification ) or type_RequirementSpecification.

Another property lets you propagate DHF Traceability (applicable to DHF classified bookmark content, namely Design Input, Design Output, and Design Verification) from lower revision content to higher revision content.

  1. Create or open the text file to contain customized properties. For more information, see Editing Properties Using MQL.
  2. To support "documents to documents" traceability (in addition to requirements to documents traceability), follow these steps:
    1. Add or edit this line in the file used to import properties into a page object:

      emxLPI.DHFTraceability.DesigInput.IncludeTypes

      The default value is "type_SoftwareRequirementSpecification" which supports only requirement to documents traceability functionality.

    2. Replace the default value with "type_DOCUMENTS" to support documents to documents traceability along with requirement to documents traceability functionality.
    3. Add or edit this line in the file used to import properties into a page object:

      RiskMgmt.DHFTraceability.DesigInput.IncludeTypes

      Make this key have the same value as emxLPI.DHFTraceability.DesigInput.IncludeTypes.

  3. To exclude document subtypes shown when expanding the Design Input bookmark in the traceability view, follow these steps:
    1. Add or edit this line in the file used to import properties into a page object:

      emxLPI.DHFTraceability.DesigInput.ExcludeTypes

      The default value is blank. Only sub types of DOCUMENTS can be specified.

    2. Specify document sub types to be excluded.
    3. Add or edit this line in the file used to import properties into a page object:

      RiskMgmt.DHFTraceability.DesigInput.ExcludeTypes

      Make this key have the same value as emxLPI.DHFTraceability.DesigInput.ExcludeTypes.

  4. To propagate DHF Traceability from lower revision content to higher revision content, follow these steps.

    This traceability setting is applicable to DHF bookmark contents for Design Input, Design Output and Design Verification only.

    1. Add or edit this line in the file used to import properties into a page object:

      emxLPI.DHFTraceability.PropagateToHigherRevision=YES/NO

      "Yes" enables automatic DHF Traceability propagation from lower revision content to higher revision content.

      "No" disables DHF Traceability propagation from lower revision content to higher revision content.

    2. In the following step, activate this trigger:

      Trigger Name Revision
      RelationshipVaultedObjectsCreateAction PropagateDHFTraceabilityOnContentRevision

    3. Open MQL from the server and run the MQL command below that sets the context user as admin if the admin user does not have a password:

      MQL>set context user creator;

      If the admin user has a password, run the MQL command where PASSWORD is the admin user password:

      MQL>set context user creator password PASSWORD

    4. Run the MQL command to enable VERBOSE:

      MQL> verb on;

    5. Run the MQL command below to activate the triggers:

      MQL> modify bus "eService Trigger Program Parameters" RelationshipVaultedObjectsCreateAction PropagateDHFTraceabilityOnContentRevision current Active;

      Note: The above MQL command uses the following syntax:

      MQL> Modify bus <TYPE> <NAME> <REVISION> current <STATE>;

      Where

      TYPE – type of business object

      NAME – name of business object

      REVISION – revision of business object

      STATE – target state of business object (for triggers Inactive/Active)

    6. Log in as VPLMAdminUser and reload the cache using the "Utilities > Reload Cache" command in the user interface.
  5. When finished updating the text file with the properties you want to modify, including the ones shown here, use the text file to modify the emxLPI.properties page object and the RiskMgmt.properties page object. For more information, see Editing Properties Using MQL.