Linking to requirements from documents and artifact elements

You can create links to existing requirements from a document or from an artifact element, such as a business process task or a use case. You can use existing text in the document or element as the link to the requirement or modify the link description.

About this task

Do not use any of the following characters when creating or renaming an artifact:
\ / | : * ? " < > & 

Procedure

To link to a requirement from a document or an artifact element complete the following steps:

  1. Open a document or artifact.
  2. Do one of the following actions:
    • Highlight a range of text in the document. Right-click the highlighted text and click Mark As Requirement.
    • Select an element in the artifact. Click the Show Requirements icon above the element. In the Requirements window, click Add Requirement, type a description for the link, and then click Set Target.
  3. In the Mark As Requirement window, click Choose Existing Requirement option.
  4. Modify the Link Description and the selected repository, if necessary.
  5. Use the Search field or the browse through the displayed projects and folders to locate and select a requirement.
  6. (Optional) To add your Link Description text to the existing requirement text, click Append Requirement Text.
  7. Click OK. A link to the requirement is created at the text in the document.

What to do next

To navigate to the requirement in a document, press Ctrl and click the link. To navigate to the requirement in an element, double-click the link in the Requirements window.

Feedback