Lab 1: Importing a Microsoft Word file as a module

883 views

Published on

At the end of this lab you will be able to:
► Describe how Microsoft® Word paragraph styles affect a module that is created by an import
► Prepare for an import by identifying and fixing paragraph style problems in Microsoft Word
► Import a Microsoft Word file to create a module and its supporting artifacts.
Given
► Automated Meter Reader (Water) project (AMR)
Description
► In this lab, you are Bob the analyst. Your stakeholders provided you with a vision document that you want to import into your project. You decide to import the document as a module because the document contains a few vision statements that you want to manage individually, and eventually use to show traceability and acceptance throughout the lifecycle.
Exercise tasks
In this exercise, you complete these tasks:
► Task 1: Explore the content and styles of a rich-text document
► Task 2: Import and extract requirements from a document

Published in: Education, Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
883
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Lab 1: Importing a Microsoft Word file as a module

  1. 1. Student Workbook Module: Capturing requirements : importing a documentLab 1: Importing a Microsoft® Word file as a RM module© Copyright IBM Corp. 2013 1Course materials may not be reproduced in whole or in part without the prior written permission of IBM.Lab 1: Importing a Microsoft Word file as a moduleObjectivesAt the end of this lab you will be able to:► Describe how Microsoft® Word paragraph styles affect a module that is created by an import► Prepare for an import by identifying and fixing paragraph style problems in Microsoft Word► Import a Microsoft Word file to create a module and its supporting artifacts.Given► Automated Meter Reader (Water) project (AMR)Description► In this lab, you are Bob the analyst. Your stakeholders provided you with a vision document that you wantto import into your project. You decide to import the document as a module because the document containsa few vision statements that you want to manage individually, and eventually use to show traceability andacceptance throughout the lifecycle.Exercise tasksIn this exercise, you complete these tasks: Task 1: Explore the content and styles of a rich-text document Task 2: Import and extract requirements from a document
  2. 2. Student Workbook Module: Capturing requirements : importing a documentLab 1: Importing a Microsoft® Word file as a RM module2 © Copyright IBM Corp. 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.Task 1: Explore the content and styles of a rich-text document1. In the lab environment, on the desktop, exists a folder named Requirements. In this folder, you can find afile: AMR Vision Requirements V2.doc. The content of the file are depicted bellow (Error! Reference sourcenot found.). The content of this file are a vision document that needs to be part of the project.Figure 1: In the AMR Vision Requirements V2.doc file, paragraph style namesare displayed in the style area of the document2. Notice the Heading structure of the file. Can you spot one inconsistency?TIP: Look at the Vision Statements heading level 1, as well as the sub-headings. Scope and Product Solution.
  3. 3. Student Workbook Module: Capturing requirements : importing a documentLab 1: Importing a Microsoft® Word file as a RM module© Copyright IBM Corp. 2013 3Course materials may not be reproduced in whole or in part without the prior written permission of IBM.Task 2: Import and extract requirements from a documentIn most cases, you review a document and fix any inconsistencies before you import the document. However, in thisexercise, you import the file as is and fix the inconsistencies in the artifacts in the Requirements Management (RM)application.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 Automated Meter Reader (Water) project Artifact page.3. From the Artifacts menu, click Import.Figure 2: The Import menu item4. In the import wizard, select Import requirements from within a text document and click Next.5. Click Add Files, and then click Desktop > Requirements > AMR Vision Requirements V2.6. For the location of the imported files, browse to the Automated Meter Reader (Water) folder and select the01 Requirements folder.7. Click Yes, Import the requirements and create a module.TIP: You can import multiple documents as separate modules.8. For the name of the new module, type Vision Document.9. For the artifact type of the new module, type Requirements Specification.10. Click Next.
  4. 4. Student Workbook Module: Capturing requirements : importing a documentLab 1: Importing a Microsoft® Word file as a RM module4 © Copyright IBM Corp. 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.11. In the “Specify how to identify requirements” window, specify how to extract the information from thedocument to create artifacts:a. For each heading, select Information as the artifact type to create.b. For each image, select Information as the artifact type to create.c. Use the information in the next table to enter keywords and select their match types and artifact types tocreate.Keyword Match type Artifact type to createshould Sentence Visionmust Sentence Visionwill be Sentence Visiond. Do not specify text delimiters.e. For all other text, select Information as the artifact type to create, and then click Next.f. Review the results.g. Click Finish, and then click Close.TIP: To see the new artifacts, you might need to refresh by pressing F5.12. Review the new Vision Document artifact in Automated Meter Reader (Water)01 Requirements. Noticethe new folder: Vision Document Artifacts.13. Open the Vision Document artifact and fix the hierarchy by taking these steps:a. Display the Scope artifact as a heading.b. Demote the “The AMR should reuse our existing infrastructure as much as possible in order to saveon costs” artifact so that it is the child of the Scope artifact.

×