IBM Rational SoDA Tutorial

(1)

IBM Rational® SoDA Tutorial

Rational® SoDA

Version 2003.06.00

(2)

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:

• InstallDirrefers 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.

(4)

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.

(5)

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.

(6)

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.

(7)

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.

(8)

1.1.1.9 The Rational RequisitePro Project Properties dialog displays.

1.1.1.10 In the Name field, type CompositeProject.

(9)

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.

(10)

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.

(11)

1.1.1.16 Upon completion, the Create Rational RequisiteProProject 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.

(12)

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.

(13)

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\CompositePr

oject.

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.

(14)

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.

(15)

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\Comp

ositeProject\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.

(16)

1.1.2.9 Using the left pane, traverse to the

RationalDir\RequisitePro\Projects\CompositePr

oject\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.

(17)

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

(18)

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.

(19)

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

(20)

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.

(21)

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

(22)

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.

(23)

1.1.3.13 In the Label field, type “GraphicName.”

(24)

1.1.3.15 Click OK.

1.1.3.16 The Project Properties dialog displays

showing newly created attribute.

(25)

1.1.3.17 The RequisitePro application window displays.

1.1.3.18 Close RequisitePro. Click File > Exit.

1.1.3.19 Click Yes.

(26)

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

IBM Rational SoDA Tutorial