Linking from artifact elements

You can add links from any artifact element to other artifacts in your project repository, files that are uploaded from your local file system, or any URL. For example, you can link from a use-case element in a use-case diagram to a screen flow that presents a series of user interfaces that are associated with steps in the use case.

Procedure

  1. Open an artifact that is not a document, such as a business process diagram, a use-case diagram, a user interface sketch, or a glossary.
  2. Select an element, such as a business process task, a use case, a user interface element, or a glossary term, and then click the Link to other artifacts icon.
  3. In the Links window, click the Add Link button.
  4. Type a description for the new link in the Link Description field and click Set Target
  5. In the "Link to" window, select one of following options:
    • Click Choose Existing Artifact and browse to a project and folder in the repository or type a partial entry for an artifact name in the Search field. Select a target artifact and click OK.
    • Click Create New Artifact. Enter the artifact type, location, optional tags, and name. Click Advanced to use a template for initial artifact content. Click OK.
    • Click Specify External Resource. Type or paste a URL and click OK.
    • Click Choose a File to Upload. Enter the upload information and click OK. The artifact is linked to the new uploaded artifact. For more information, see Uploading files to a repository.
  6. To navigate to the target artifact, double-click the link in the Links window or open the Links section in the sidebar.

What to do next

To change or delete a link:
  1. Select an element, such as a business process task, a use case, a user interface element, or a glossary term.
  2. Click the Link to other artifacts icon.
  3. In the Links window, right-click a link and select Edit Link or Delete Link.

Feedback