Tool Mentor:
Detailing a Use Case Using Rational RequisitePro
Purpose
This tool mentor describes how to use Rational RequisitePro® to describe a
system use case in detail. The description of the system use case is performed
by the system analyst.
Related Rational Unified Process (RUP) information: Activity:
Detail a Use Case.
Overview
After the use cases for the proposed system have been identified (as
described in the Rational Rose® Tool
Mentor: Finding Actors and Use Cases), you can use RequisitePro to develop a
Use-Case Specification document.
Note: You can develop the use cases in Rose and
generate them in RequisitePro using the Integrated Use-Case Management feature.
Refer to Tool Mentor: Managing
Use Cases with Rational Rose and Rational RequisitePro for more information.
Sections of the Use-Case Specification document can be used to create
specific requirements. These requirements can be traced (or linked) to other
requirements, such as product features.
The textual information for the selected use cases is detailed by a requirements
specifier who writes a Use-Case Specification for each use case. This
document defines all textual properties of the use case and may elaborate on the
name and description of the use case produced in the RUP activity Find
Actors and Use Cases.
Tool Steps
To detail a use case using RequisitePro:
- Create a Use-Case Specification document
- Complete the Use-Case Specification document
- Create requirements in the detailed Use-Case
Specification
- Add
diagrams to the Use-Case Specification (optional)
If you created your RequisitePro project using the Use-Case Template, your
project already contains a Use-Case Specification document type.
The Use-Case Specification
document contains the use case’s textual properties. This includes the
following use-case properties: name, brief description, basic flow of events,
alternate flow of events, preconditions, postconditions, and special
requirements.
Note: If you have developed your use cases in Rose,
you can use the procedures described in Tool
Mentor: Managing Use Cases Using
Rational Rose and Rational RequisitePro to create a new use-case document that is associated with your Rose use case. If not, use the
following tool steps to create a use-case document.
To create a Use-Case Specification document in RequisitePro:
- In the Explorer, select the package in which you want the new document to
reside. Then click File > New > Document. The Document
Properties dialog box appears.
- Type a name, description, and file name for the document.
- From the Document Type drop-down list box, select "Use-Case
Specification Document Type."
- Click OK. The outline for the Use-Case Specification
document opens in Microsoft® Word.
For More Information
Refer to the topic
titled Creating requirements documents (Index: documents>creating) in the RequisitePro online
Help.
In the newly created Use-Case Specification document, type use-case-specific
information in each section. The name and the brief description properties
should already have been documented in Activity:
Find
Use Cases and Actors in Rational Rose.
To complete the Use-Case Specification document:
- Replace the "Use Case Name" text that is displayed in the
outline with the actual name of the use case.
Note: If you created the use-case document using the
procedures described in Tool Mentor:
Managing
Use Cases Using Rational Rose and Rational RequisitePro, the use-case
name is inserted automatically in the title of the document. Use the RequisitePro
> Requirement > Cut and Paste
commands to move the use-case requirement to the "Use Case Name"
text.
- Read the instructions in the Brief Description field, and
then delete them and type a brief description.
Note: If you developed the use case in Rose and
want to include the Rose documentation field as part of the brief
description section in your RequisitePro use-case document, copy the text
from the Documentation field in the Rose Use-Case
Specification dialog box and paste it into your Use-Case Specification
document.
- Replace the default text located in the Basic Flow of Events section with
the text for this use case’s basic flow of events. Identify each step on a
separate line.
- Repeat this procedure for the other use-case properties (alternate flow of
events, special requirements, preconditions, postconditions, and so on).
- Click RequisitePro > Document
> Save.
For More Information
Refer to the topic
titled Saving requirements documents (Index: documents>saving) in the RequisitePro online
Help.
In order to track traceability
links between use cases and other information, such as the use-case model or
product features, create RequisitePro requirements
from the Use-Case Specification sections. Make the use-case name a parent requirement, and make
child requirements from its properties. These properties may include brief
descriptions, actions within the basic or alternate flow of events,
preconditions, postconditions, special requirements, and extends relationships.
- In the Use-Case Specification document, select the use-case name.
- Do one of the following:
- Right-click and select Create Requirement.
- Click RequisitePro > Requirement
> New.
The Requirement Properties dialog box appears.
- Select UC as the requirement type.
- On the Attributes tab, select the Property
attribute value of "Name" from the drop-down list
of use-case properties.
- Repeat the preceding steps for the brief description (setting the Property
attribute to "Brief Description"). On the Hierarchy
tab, select <choose parent> and identify the UC
requirement representing the use-case name.
- In the basic flow of events section of the Use-Case Specification
document, create UC requirements for each step or group of steps (subflow)
to which you want to set traceability links. Set the Property attribute to Basic
Flow, and set the requirement’s parent
to the use-case name requirement created in Steps 1-3 above. You have the
option of indicating groups of steps that are always performed together. If
necessary, use hierarchical requirements to distinguish subflows from the
basic flow of events.
Note: You do not need to create requirements for each step
in a flow of events. The value of creating flow of events requirements is in
tracing from a higher level requirement, such as a product feature, to a
specific part of the flow of events. A flow of events often spans several
pages, so this may be preferable to considering the flow of events as a
whole.
- In each alternate flow of events, create UC requirements for each step or
group of steps (subflow) to which you want to set traceability links. Set
the Property attribute to Alternate Flow and
the parent requirement as indicated previously. Similar to the basic flow of
events, use hierarchical requirements to indicate complete subflows.
- The following steps are optional:
- In the preconditions section of the Use-Case Specification document,
select each precondition separately and create a UC requirement
(Property = pre-conditions, parent = use-case name
requirement).
- Repeat the step above for the postconditions (Property = Post-conditions)
and the special requirements section (Property = Special).
Set the use-case name requirement as their parent.
For More Information
Refer to the
topic Creating requirements in a document (Index:
requirements>creating) in the RequisitePro online
Help.
Some of the use-case properties are nontextual, such as "use-case
diagrams" and "other diagrams". See the RUP Artifact:
Use Case. These diagrams are stored in Rose. Using Rational SoDA®,
you can create a Use-Case Report from the use-case textual properties stored in RequisitePro and the use-case diagram information stored in Rose. See Report:
Use Case on how to create this report.
Copyright
© 1987 - 2001 Rational Software Corporation
| |
|