This document provides instructions for a lab on importing a rich text file and extracting requirements from it in IBM Rational Requirements Composer. The lab has two tasks: 1) importing meeting notes from a document as a rich text artifact and 2) extracting a requirement from the notes and linking it as a new artifact. The extracted requirement maintains a link back to the original artifact for traceability.

1. Student Workbook Module: Editing rich-text artifacts
Lab 1: Import a rich text file and extract linked requirements
© Copyright IBM Corp. 2013 1
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Lab 1: Import a rich text file and extract linked
requirements
Objectives
At the end of this lab you will be able to:
► Create requirements artifacts at the project level
► Import a rich text file as a single artifact
► Extract requirements from artifacts
Given
► The JKE Banking Money That Matters project
Description
► In this lab, you log in as Bob. You had a meeting with a customer. You want to save the meeting minutes,
and even extract a few requirements from them You also want to keep continuity, and assure you will
know in the future were the requirements were extracted from.
Exercise tasks
In this exercise, you complete these tasks:
 Task 1: Import a document as a rich-text artifact
 Task 2: Extract requirements from a rich-text artifact

2. Student Workbook Module: Editing rich-text artifacts
Lab 1: Import a rich text file and extract linked requirements
2 © Copyright IBM Corp. 2013
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Task 1: Import a document as a rich-text artifact
In this task, you import notes that you took during an off-site meeting with architects to discuss browser support for
the JKE Business Recovery Matters project.
1. You are in the lab environment All Projects page of the RM application (https://jazz-
server:9443/rm/web). You are logged in as bob with password bob.
2. Navigate to the the JKE (Requirements Management) project Artifact page. Hint: In the My Projects section,
find the JKE Banking (Requirements Management) project and click Show Artifacts.
3. If necessary, go to the JKE Business Recovery Matters Project folder.
4. From the Artifacts menu, click Import.
5. Select Import a text document and convert to a rich-text artifact, and then click Next.
6. In the “Select text document” window, specify information about the document to import:
a. Browse to the Desktop directory and click Requirements > JKE Browser Support.doc.
b. In the Artifact Name field, type Browser Support Requirements.
c. For the artifact type, select Supporting Resource.
d. For the folder to place the imported content in, browse to the JKE Business Recovery Matters Project
folder and click Project Meetings.
e. Ensure that Import for editing and viewing is selected.
7. Click Finish.
Task 2: Extract requirements from a rich-text artifact
As you are reviewing your minute notes (just imported from a document into a rich text artifact) you realize that
there they contain one or more requirements. You extract a requirement artifact from the notes.
1. Open the Browser Support Requirements artifact for editing.
2. Scroll down and select the text in the artifact that specifies the requirements for browser support, and then click
the Save Selection as New Artifact and Link icon on the toolbar.
Figure 1: The Save Selection as New Artifact and Link icon.

3. Student Workbook Module: Editing rich-text artifacts
Lab 1: Import a rich text file and extract linked requirements
© Copyright IBM Corp. 2013 3
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
3. In the Save Selection as New Artifact (Link) window, specify information about the artifact to link to:
a. In the Name field, type Browser support.
b. For artifact type, select Feature.
c. For artifact format, select Text.
d. Verify the description and ensure that the link type is Extracted.
e. To specify the folder to place the artifact in, browse to the JKE Business Recovery Matters Project
folder and click Features.
4. Click Finish. The new feature requirement is displayed as a link in the Browser Support Requirements artifact.
Figure 2: The new feature artifact maintains an extracted link to the original artifact.
5. Save the artifact.
6. In the right sidebar, expand the Links section and confirm that the new link is listed as an Extracted link.
7. Hover over the the extracted link and review the information in the rich hover view.. Notice the link. The
“Extracted from” link in the Links section points to the original meeting notes artifact.
8. Click the link to go to the new artifact.
9. Return to the Artifacts page of the JKE Banking (Requirements Management) project.