Essentials of IBM Rational Requirements Composer, v3

  © Copyright IBM Corporation 2010, 2011

Essentials of IBM Rational Requirements Composer, v3

  Module 1: Navigating Rational Requirements Composer 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

Requirements definition

   Elicitation Requirements

   Analysis are captured and analyzed

   Specification  Validation

Requirements management Requirements are

   Traceability managed and controlled

   Change management  Tracking and reporting

  Reevaluate

  Elicitation Analysis Specification Validation

  Clarify Correct and close gaps Rewrite

  Source: Karl Wiegers 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 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 Rational Requirements Composer Rational Requirements Composer is a collaborative requirements tool: whole requirements lifecycle

   Addresses the

• – 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

COMMUNITY

  Open Services for Lifecycle Collaboration Integration services

  transparent collaboration and exchange of ideas Application frameworks and toolkits

  PRODUCTS Application lifecycle tools that take advantage of the Jazz platform The Rational solution for Collaborative Lifecycle Management The Rational solution for Collaborative Lifecycle Management

  

Requirements

management

Rational Requirements

Composer

  Quality Software change and Architecture

management configuration management management

  Rational Software Architect* Rational Quality Manager Rational Team Concert

  Rational Application Developer* Rational Developer for System z*

Build and deployment

management

  

Rational Team Concert

Rational Automation Framework

for WebSphere*

• 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

  The dashboard is composed of “ widgets” that offer views into your projects.

  You can customize your dashboard by moving, removing, or

  Most widgets show results for adding new widgets. all projects, but you can add filters to limit the results. Key Rational Requirements Composer concepts

Project

  With Folders, you can organize and manage requirements and requirements-related

  

Folder structure information in a project.

  “Artifact” is a general term for an object in the repository. Requirements and related information that you manage in Rational Requirements

  Artifacts Composer are stored as artifacts.

  Each artifact has a set of attributes, which allow

  Attributes you to record and track data about an artifact.

  With links, you can create relationships between

Saved Links

  requirements artifacts. Links help you manage

  filters your projects. Tags

  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

Hover over an artifact to view information about the artifact

  Content Location Tags

  Attributes Links 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

  Click the Help icon to open the information center.

  In-context help provides information about your current location in the web client. Defining scope of topics in help

  To limit the scope of topics that display in the Contents column, click Scope.

  1

  to see in the help contents, and then click OK.

Select Show only the following topics and click New

  4

  3 Viewing 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.

  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. Viewing comments on artifacts Team members can communicate on

  The orange outline indicates

  requirements artifacts during

  which element of the artifact development by using comments. 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 breadcrumb shows the location of the artifact and aids navigation.

  Editing toolbar Artifact content can include text, images, hyperlinks, and embedded artifacts.

  The artifact sidebar contains overview properties, attributes, comments, links, and review information for an artifact.

  You can hide the sidebar. 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  Customize a user dashboard

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  Customize a user dashboard