Import a Word Document into the Project
Lab 4.3 Import a Document with Text (Create Requirements Using Keywords)
Objectives
Create a RequisitePro document by importing the Vision document.
Create requirements using keywords while importing.
Scenario
The Import wizard creates requirements based on keywords, text delimiters, or Word styles.
Let’s import the existing Vision document into the project. You want
RequisitePro to create requirements from the document text while importing the document. Instruct RequisitePro to create a feature requirement (FEAT) from every sentence that contains the keyword “must.”
Import a Vision Document and Requirements Using Keywords 1. Select the Features and Vision package in the Explorer.
Click File > Import.
The Import Wizard dialog box opens.
2. Click Microsoft Word Document.
Browse to the Exercise CD and open the Additional Files folder.
Select Vision.doc, and then click Open.
Click Next.
4-10 © Copyright IBM Corp. 1998, 2006
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Move the dialog box from the center of the screen.
Enter the following information in the associated boxes.
Click OK to close the Document Properties dialog box.
(Click Enable Macros IF a Microsoft Word dialog box appears.)
The templates are not the same, so the Import Wizard asks if you want to include formatting of the imported document.
Click No.
selected that serve as a basis for requirement creation.
Note: In some circumstances the Import Wizard dialog box may be hidden behind the Word window. Click the RequisitePro icon on the taskbar to display this dialog box.
Once you change the keyword to “must”, click Add.
You have instructed the Import parser how to recognize a requirement in the document to be imported. Notice that other techniques exist and might be useful depending on your own project development standards.
Click Next.
RequisitePro searches the document and creates requirements that are based on the established criteria. Each requirement found is displayed in the Requirement Found box.
Click Yes.
Click Yes to All and bypass confirmation of each requirement.
4-12 © Copyright IBM Corp. 1998, 2006
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
6. Click Commit to update the database.
Unlike the manual creation of requirements in an earlier lab, the Import Wizard saves all discovered requirements as final requirements and does not leave them in a pending state. The requirement document is created in the project folder with requirements defined based on the keyword
“must.”
7. Review the Vision document and its requirements (enclosed with bookmarks).
The requirements have been created under the correct package in the Explorer.
8. Click RequisitePro > Document > Save.
Minimize Word.
The Vision document remains open, but minimized.
Maximize the Explorer.
Continue to the next guided lab.
Lab 4.4 – Import a RequisitePro Document with Requirements
Objectives
Import a requirements document with existing requirements in bookmarks.
Save a requirements document from the project as a Word document.
Scenario
Import a RequisitePro document already containing requirements from a different project into your project.
Import a RequisitePro Document and Requirements 1. Select the Supplementary Requirements package.
Click File > Import.
2. Click Microsoft Word Document for source.
3. Browse to the Exercise CD and open the Additional Files folder.
Choose All Files (*.*) from the Files of type menu.
Hint: The file name extension of the supplementary file is NOT the usual .DOC extension. Be careful when searching for the file in the Word Open dialog box.
Click Supplementary_Specifcation.SUP.
Click Open, and then click Next.
4-14 © Copyright IBM Corp. 1998, 2006
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Click OK.
The Import Wizard asks if you want to include formatting of the imported document.
Click No for formatting the imported document.
Note: In some circumstances the Import Wizard dialog box may be hidden behind the Word window.
5. The Import Wizard prompts you to answer the question:
Click No.
Since RequisitePro generated this document, it already contains bookmarks that indicate existing requirements. As a result, it is not necessary to indicate any delimiters. RequisitePro automatically detects the bookmarks.
Click Commit.
Review the contents of the document.
Click in the requirement text, and then click RequisitePro > Requirement >
Delete (Unmark).
Click Yes to confirm the deletion.
7. Click RequisitePro > Document > Save.
4-16 © Copyright IBM Corp. 1998, 2006
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Export a Document for External Use
A RequisitePro document can be exported as a Word document for customers and non-RequisitePro users to view.
8. Make sure Supplementary Specification.SUP is open in Word.
Click RequisitePro > Document > Save As in the Word menu bar.
The RequisitePro standard assumption with Save As is that you wish to create a Word document outside the project boundary.
Click Save to create a copy of the RequisitePro document.
A dialog box appears notifying you that the document has been saved.
Click OK.
This saves a copy of the RequisitePro document in Word format with a .doc extension. The RequisitePro document remains intact and in the project.
Click Yes if prompted.
Notice that the document in Word is now the document you just saved.
The document from the project has been closed. Changes to this document will not update the RequisitePro project.
9. Click RequisitePro > Document > Close in Word.
Click Yes to save changes if a dialog box appears.
Note: The Vision.VIS may still be open from Lab 4.3.
Continue to the next guided lab.