Linking artifacts by using the drag-and-drop method

Edit online

You can link requirement artifacts with other artifacts across ELM applications by using the drag-and-drop and copy-and-paste methods.

Before you begin

When you link requirement artifacts, OSLC link types are created between the applications. For more information, see Link types in requirements projects. Make sure that the project areas in the ELM applications are registered with each other for link creation.

About this task

You can link requirements artifacts within a single artifact editor, dashboard list, module, or links explorer by using the drag-and-drop method. You can also use these methods to link requirement artifacts to work items in IBM® Engineering Workflow Management (EWM) or test artifacts in IBM Engineering Test Management (ETM).

Note: You cannot link artifacts between different global configurations. If you select a configuration in the EWM application, you cannot create a link to another artifact in a different global configuration.

Procedure

  1. Open a requirement artifact in the editor mode.
  2. Hover the mouse over the left side of an artifact ID until the cursor becomes a four-sided arrow.
  3. Use the drag handle to drag the artifact into another tab or window that uses the same browser instance.
    Drag_Handle
  4. Drop the artifact into the Drop Artifacts window of an editor or grid view.
    Drop_Target_window
  5. In the Select the link type list, select the link type.
  6. Click Create Links.
    Create Link Dialog box
  7. In the Links sidebar section, you can view the linked artifact and the link type.
  8. Optional: To link single or multiple requirement artifacts to work items in EWM, drag the requirement artifacts into another tab or window and drop the requirement artifact in the work item editor. Specify the link type and save the work item. Similarly, you can drag work items and drop them into an artifact editor to create OSLC links.
  9. Optional: To link single or multiple requirement artifacts to test artifacts in ETM, drag the requirement artifacts into another tab, or window and drop the requirement artifact in the test artifact editor. Only requirement collections or modules can be dropped into the test plan editor, while only requirements can be dropped into the test case editor or test script editor. For the test script editor, drop the requirement artifacts into the specific manual script step directly to create the Validates Requirement links, provided that the Test Script Preferences project property has the option enabled to Allow linking between test script steps and requirements. Similarly, you can drag test plans or test cases and drop them into an artifact editor to create OSLC links.

Using copy-and-paste method

Edit online

About this task

You can use the existing Copy Artifact option in a module or artifact list, and the existing Paste As Link option on another artifact to create a new link. You can use the new menu options of Copy Artifact and Paste As Link in a single artifact editor to carry out the same operations.
You can use the following keyboard shortcuts for the copy-and-paste feature everywhere drag and drop is available:
  • Copy Link: Ctrl+C (Windows) or Command+C (Mac)
  • Paste as link: Ctrl+Shift+V (Windows) or Command+Shift+V (Mac)

Procedure

  1. Select the artifact to link from and then click Copy Artifact.
  2. Select an artifact in another artifact and click Paste As Link.
  3. Click Create Links.