Essentials of IBM Rational Requirements Composer, v3 · PDF fileTitle: Navigating Rational Requirements Composer Author: myers Subject: Essentials of IBM Rational Requirements Composer,

© Copyright IBM Corporation 2010, 2011

Essentials of IBM Rational Requirements Composer, v3

Module 1: Navigating Rational Requirements Composer

2 © Copyright IBM Corporation 2010, 2011

Module overview

After completing this module, you should be able to:

Explain key principles of requirements definition and

management and how IBM® Rational® Requirements

Composer helps you manage requirements

Navigate the Rational Requirements Composer interface

View requirement artifacts and information about requirement

artifacts

Comment on requirement artifacts

Customize a user dashboard


Topics

> = Current topic

>Rational Requirements

Composer Overview

Navigating Rational

Requirements Composer


Requirements definition and management practices

Source: Karl Wiegers

ValidationSpecificationAnalysisElicitation

Rewrite

Reevaluate

Clarify Correct and close gaps

Requirements management

Traceability

Change management

Tracking and reporting

Requirements are managed and

controlled

Requirements definition

Elicitation

Analysis

Specification

Validation

Requirementsare captured and

analyzed


What contributes to project success?

Problem analysis Understand the problem

Create a clear statement of business objectives

Gain stakeholder agreement

Requirements elicitation Identify who will use the system

Elicit the value that the system will provide and how the system will be used

Requirements analysis, specification, and validation Organize requirements

Specify requirements clearly and completely

Review and validate requirements with stakeholders to achieve a shared vision and concurrence

Requirements management Manage expectations, changes, and errors

Control scope creep

Enlist all team members

Identify and capture metrics that help manage the project and mitigate risk


The requirements paradigm is changing

Needs-driven: functional

groups provide input

From

Needs strategic: collaborative

dialogue on differentiation

To

Stakeholders at arms length:

analysts and delegates engage

Direct involvement in solution

discussions and review

Multiple quality control stages to

inspect and fix errors

Visualization and scenarios

reduce downstream issues

Seek parity, satisfy all

stakeholders equally

Active negotiation and trade-offs

driven by business case

Scope: Stakeholder needs are

collected, consolidated, and

prioritized

Scope: Ongoing negotiation of

requirements and priorities as

customer and project team learn

more and business priorities

change


Rational Requirements Composer

Rational Requirements Composer is a collaborative

requirements tool:

Addresses the whole requirements lifecycle

– Users elicit, define, elaborate, organize, and analyze

requirements throughout the requirements lifecycle.

Works for the whole team

– Users access a common repository with a web client and use

rich collaboration features that enable information transparency

and team collaboration from any where in the world.

Functions across the whole project lifecycle

– In the context of Collaborative Lifecycle Management (CLM) and

the Jazz® platform, teams coordinate software development

activities from business needs to system delivery


The Rational solution for CLM is based on the Jazz platform

PLATFORM

Open Services for Lifecycle CollaborationIntegration services

COMMUNITYtransparent collaboration and exchange of ideas

Application frameworks and toolkits

PRODUCTSApplication lifecycle tools that take advantage of the Jazz platform


The Rational solution for Collaborative Lifecycle Management

Software change and configuration management

Rational Team Concert

Qualitymanagement

Rational Quality Manager

The Rational solution for Collaborative Lifecycle Management

Build and deploymentmanagement

Requirementsmanagement

Architecturemanagement

Rational Software Architect*Rational Application Developer*

Rational Developer for System z*

Rational Team Concert Rational Automation Framework

for WebSphere*

Rational Requirements Composer

*Optional add-on solutions


Support for a range of project methodologies

Rational Requirements Composer is highly flexible and

adaptable and supports a range of project

methodologies.

The product comes with defined project templates to

support these approaches:

Traditional development

Use-case development

Agile or scrum development

You can customize Rational Requirements Composer

on a project-by-project basis.


Topics

> = Current topic

Rational Requirements

Composer Overview

> Navigating Rational

Requirements Composer


Logging in to the project repository

URL: https://hostname:9443/rm/web/

You must have a URL, user ID,

and password to log in to the

project repository.


The user dashboard

You can customize

your dashboard by

moving, removing, or

adding new widgets.

The dashboard is composed of “ widgets”

that offer views into your projects.

Most widgets show results for

all projects, but you can add

filters to limit the results.


Key Rational Requirements Composer concepts

Artifacts

Folder structure

Attributes

Links

Tags

Project

Saved

filters

“Artifact” is a general term for an object in the

repository. Requirements and related information

that you manage in Rational Requirements

Composer are stored as artifacts.

With Folders, you can organize and manage

requirements and requirements-related

information in a project.

Each artifact has a set of attributes, which allow

you to record and track data about an artifact.

With links, you can create relationships between

requirements artifacts. Links help you manage

your projects.

With tags, you can categorize artifacts. Then,

you can use tags to filter and create different

views of artifacts.

You can apply filters based on folders, artifact

types, attributes, links, or tags and save them for

personal or shared use.


Opening a project

You can open a project two

ways:

• Click the project name on

the user dashboard

• Click the project name on

the Projects menu


The project artifacts page

Filtering

options

Project

folder

structure

Artifacts that match the

current filter criteria Sidebar


Rich hover information

Content

Attributes

Location

Tags

Links

Hover over an artifact to view

information about the artifact.


Filtering artifacts

Use filters to display requirements

artifacts based on specific criteria.

Filter by tag, attribute, or folder.

Combine filter criteria to create

targeted views of artifacts.

Indicates filters that are applied.


Finding artifacts

Use Quick Search to find specific

requirements artifacts in this

project or in projects in the

repository.

Type a full or partial entry, or search

by ID number.

Use an asterisk (*) as a wildcard in

the middle or at the end of the search

entry.


Viewing recently viewed artifacts

View recently viewed artifacts from

the Artifacts menu.


Viewing links

Links establish relationships between

artifacts and enable traceability.

Traceability through

linking allows you to

perform:

Coverage analysis

Impact analysis

Progress analysis

Click a link to navigate to

the linked artifact.


Accessing help

In-context help provides

information about your

current location in the

web client.

Click the Help icon to open

the information center.


Defining scope of topics in helpTo limit the scope of topics that display in

the Contents column, click Scope.

Select Show only the following

topics and click New.

Select the topics that you want

to see in the help contents, and

then click OK.

1

2

3

4


Viewing the Mini Dashboard

To open, click the vertical

Mini Dashboard bar on the far

left of the window.

To close, click anywhere

outside of the Mini

Dashboard.

Click the pin icon to dock or

undock the Mini Dashboard.

The Mini Dashboard is a small dashboard that

you can open from any page as you work. You

can add, modify, or remove widgets.


Viewing comments on artifacts

Team members can communicate on

requirements artifacts during

development by using comments.

The orange outline indicates

which element of the artifact

the comment applies to. In

this case, the comment

pertains to the entire artifact.

Comments are available in

the Comments section of the

sidebar.


Commenting on artifacts

You can direct the comment

to a particular team member

and set priority.

You can create a new

comment for an artifact or

reply to an existing comment.


The Artifact editor

The artifact sidebar

contains overview

properties, attributes,

comments, links, and

review information for

an artifact.

You can hide the

sidebar.

Artifact content can

include text, images,

hyperlinks, and

embedded artifacts.

The breadcrumb shows the location of the

artifact and aids navigation.

Editing toolbar


Lifecycle coverage and progress analysis

In the context of Collaborative Lifecycle Management

(CLM), links enable you to analyze coverage and

progress throughout the project lifecycle.

Implemented by Rational Team

Concert plan or work item

Validated by Rational Quality

Manager test case


The Home menu

Use the Home menu to navigate between

requirements projects.

In the CLM context, use the Home menu to

access Change and Configuration Management

and Quality Management project areas.


Lab 1: Navigating Rational Requirements Composer

In this lab, you complete these

tasks:

Explore the Rational Requirements

Composer interface

View requirements artifacts and

information about requirements

artifacts

Comment on requirements



Review

What kind of information

about an artifact does the

rich hover view provide ?

What kind of information can

you access by using the right

sidebar?

What information do you

need to know to use Quick

Search?

What kinds of information can

you view on your user

dashboard?


Module summary

In this module you learned to:

Explain the key principles of requirements definition and

management and how Rational Requirements Composer

helps you manage requirements

Navigate the Rational Requirements Composer interface

View requirements artifacts and information about

requirements artifacts

Comment on requirements artifacts


Documents

Essentials of IBM Rational Requirements Composer, v3 · PDF fileTitle: Navigating Rational Requirements Composer Author: myers Subject: Essentials of IBM Rational Requirements Composer,