SoDA Tutorial Template - IBMpublic.dhe.ibm.com/.../pdf/SettingUpRequisitePro.pdfIBM Rational® SoDA Tutorial Rational® SoDA Version 2003.06.00 Exercise 1.1 – Creating a RequisitePro

IBM Rational® SoDA Tutorial Rational® SoDA

Version 2003.06.00

Exercise 1.1 – Creating a RequisitePro Project

Version 2003.06.00 Creating a RequisitePro Project

TABLE OF CONTENTS

INTRODUCTION........................................................................................................................................................................................................ 3 PREREQUISITES........................................................................................................................................................................................................... 3

PC SETUP.................................................................................................................................................................................................................... 3

DIRECTORY REFERENCES ........................................................................................................................................................................................... 3

EXTRACTING GRAPHICS WITH REQUISITEPRO........................................................................................................................................... 4 PART 1 – SETTING UP THE REQUISITEPRO ENVIRONMENT ........................................................................................................................................ 4

PART 2 – SETTING UP THE ENVIRONMENT FOR RETRIEVING GRAPHICS ASSOCIATED WITH A REQUISITEPRO REQUIREMENT ................................ 12

PART 3 – CREATING A NEW ATTRIBUTE FOR A REQUIREMENT ................................................................................................................................ 17

CONCLUSION .......................................................................................................................................................................................................... 26

IBM Rational software ii


Introduction In order to generate a SoDA template that will gather any type of information into a report the environment must be established first.

Prerequisites Rational RequisitePro must be installed on the same computer as SoDA.

PC Setup A test directory structure outside the SoDA provided structure is recommended for creating and testing templates.

This directory can exist anywhere as long as SoDA can access the files. This folder can reside in the SoDAWord\template directory; if it does then no additional set up is required. If this is not the location you’ve selected, then set the User template path via SoDA >Options after creating the directory. Set up the following directory structure:

Custom\reqpro

Directory references The following directory references are used in this section of the tutorial:

• InstallDir refers to the installation path for Rational SoDA (DriveLetter:\Program Files\Rational\SoDAWord is the default path).

• RationalDir refers to the installation path for Rational (DriveLetter:\Program Files\Rational is the default path).

• TestDir refers to the directory structure created in the PC Setup.

Note The graphics used to illustrate the Microsoft Word user interface were captured using Microsoft Word 2000. Depending on the version of Word you use, these dialog boxes may look different.

IBM Rational software Page 3 of 26 Exercise 1.1 - RequisitePro


Extracting Graphics with RequisitePro In this exercise you will go through the process of setting up a RequisitePro Project, locating some graphic files and copying them to a relative (to the Project) directory. You will rename these files to match the name of the requirement. You will also add a new attribute to an existing requirement type.

Part 1 – Setting up the RequisitePro Environment In this exercise, you’ll create a RequisitePro project.

Use Case Steps Details Display

1.1.1.1 Set up a RequisitePro project. From the desktop, click Start > Programs > Rational Software > Rational RequisitePro.

1.1.1.2 The Rational RequisitePro splash screen displays.




1.1.1.3 The Let’s Go RequisitePro dialog may display, if so, close it by clicking on the .

1.1.1.4 When Rational RequisitePro application is finished loading, the Open Project dialog displays.




1.1.1.5 Create a new project. Click New.

1.1.1.6 Each template was developed for a specific need, if you would like further details on what the different templates contain, please refer to the help for RequisitePro.

The New tab displays, showing all the templates available for a new project.




1.1.1.7 Highlight each template; notice that there is a description for each one.

1.1.1.8 Create the new project with the Composite Template.

Highlight Composite Template.

Click OK.




1.1.1.9 The Rational RequisitePro Project Properties dialog displays.

1.1.1.10 In the Name field, type CompositeProject.




1.1.1.11 The Directory defaults to the directory defined in the RequisitePro Tools > Options dialog. The default directory is RationalDir\RequisitePro\Projects; you may want to set up a working area on your computer that is not within the Rational structure. In this exercise, you will use the default directory structure.

If you want to store your project outside the Rational structure (which is recommended), then select the Browse button and traverse to another location.

1.1.1.12 Click in the Directory field.

Press End.

Note that the Name of the directory reflects the name we defined in the Name field.

The default Database type will be used.




1.1.1.13 Click in the Description field, type “Project for SoDA training.”

Click OK.

1.1.1.14 The Rational RequisitePro Project Properties dialog displays.

Click Yes.

1.1.1.15 The Create Rational RequisitePro Project dialog displays.




1.1.1.16 Upon completion, the Create Rational RequisitePro Project dialog refreshes and the Close button becomes active.

Click Close.

1.1.1.17 The structure for a project has now been created, though there is no data in the project.

The Rational RequisitePro application window displays.

Congratulations, you have successfully created a project in RequisitePro.



Part 2 – Setting up the Environment for retrieving graphics associated with a RequisitePro requirement

In this exercise, you’ll set up the external environment to store the graphics.


1.1.2.1 Start the Explore dialog. From the desktop, right click Start, click Explore from the short cut menu.

1.1.2.2 The Microsoft Explore dialog displays.




1.1.2.3 Use either the left pane or the drop down Address field and traverse to the location of the CompositeProject.

Default location is:

RationalDir\RequisitePro\Projects\CompositeProject.

1.1.2.4 Create a sub folder; this folder will be where the graphic files are stored.

In the left pane, highlight CompositeProject; select File > New > Folder.




1.1.2.5 The Explore dialog refreshes with the new folder displayed in the right pane. The default name of this folder is “New Folder.”

1.1.2.6 Rename the newly created folder to Graphics.

Type “Graphic” for the folder name, press Enter.




1.1.2.7 If you have installed the full Rational Suite, including ProjectConsole, this folder will exist. If you installed the Suite without ProjectConsole, you will need to manually locate ten different .jpg files on your computer and place a copy of those files in the RationalDir\RequisitePro\Projects\CompositeProject\Graphics folder.

Traverse to the following folder:

C:\Classics\ClassicsApps\Atbu-vb\images.

1.1.2.8 Select and copy the following files:

• 5th.jpg

• 7th.jpg

• BachBranden.jp

• BachConcerto.jpg

• Haydn94_98.jpg

• Haydn99_101.jpg

• Mozart34.jpg

• MozartJupiter.jpg

• Schubert25.jpg

• Schubert4_14.jpg

Highlight 5th.jpg.

Press and hold Shift

Click on each additional file.

After the last file has been highlighted, with the cursor over one of the highlighted file names right click and select copy from the short cut menu.




1.1.2.9 Using the left pane, traverse to the RationalDir\RequisitePro\Projects\CompositeProject\Graphics folder.

1.1.2.10 In the right pane, right click and select Paste from the short cut menu.

1.1.2.11 The Explore dialog refreshes.

Congratulations, you have successfully set up the external relative folder environment for RequisitePro.



Part 3 – Creating a new attribute for a Requirement In this exercise, you’ll create a new attribute for the SR requirement type.


1.1.3.1 If RequisitePro is not open. Open the CompositeProject.

If RequisitePro is open and the CompositeProject is loaded, then skip to step 1.1.3.7 otherwise, start RequisitePro and load the CompositeProject:

Start > Programs > Rational Software > Rational RequisitePro.

1.1.3.2 The Rational RequisitePro splash screen displays.




1.1.3.3 The Let’s Go RequisitePro dialog may display, if so, close it by clicking on the .

1.1.3.4 When the Rational RequisitePro application window is finished loading, the Open Project dialog displays.




1.1.3.5 Use the scroll bar and locate CompositeProject. Click CompositeProject (it may already be highlighted).

Click OK.

1.1.3.6 The RequisitePro application window displays.




1.1.3.7 Add a new attribute to the requirement type SR: Software Requirement.

Click File > Project Administration > Properties.

1.1.3.8 The Project Properties dialog displays.

Click the Attributes tab.




1.1.3.9 The Project Properties dialog refreshes with the Attributes tab as the focus.

1.1.3.10 From the pull down menu, click SR: Software Requirement.




1.1.3.11 The Project Properties dialog displays showing the SR: Software Requirement attribute list.

Click Add.

1.1.3.12 The Add Attribute dialog displays.




1.1.3.13 In the Label field, type “GraphicName.”

1.1.3.14 Use the pull down menu click Text.




1.1.3.15 Click OK.

1.1.3.16 The Project Properties dialog displays showing newly created attribute.




1.1.3.17 The RequisitePro application window displays.

1.1.3.18 Close RequisitePro. Click File > Exit.

1.1.3.19 Click Yes.

Congratulations, you have successfully added a new attribute to an existing requirement type. This attribute will be used to store the name of the graphic that will be associated to the requirement.



Conclusion Congratulations! You have successfully set a RequisitePro project, and created a new attribute for an existing requirement.

You used the RequisitePro to:

• Set up a new Project

• Create a relational folder for the graphics that will be associated to these requirements

• Copied some graphic files into the relational folder

• Create a new attribute for the SR requirement type


Documents

SoDA Tutorial Template - IBMpublic.dhe.ibm.com/.../pdf/SettingUpRequisitePro.pdfIBM Rational® SoDA Tutorial Rational® SoDA Version 2003.06.00 Exercise 1.1 – Creating a RequisitePro