Professional Documents
Culture Documents
Get Started With IBM CLM
Get Started With IBM CLM
Lightning Lab
CLM 6.0.5
Get started
with
IBM Collaborative Lifecycle Management (CLM)
Bhawana Gupta
WW Enablement Lead - CE, Enterprise Scaled Agile
IBM Watson IoT
bhawana.gupta@in.ibm.com
Table of Contents
Overview ...................................................................................................................................................... 3
Learning Objectives ................................................................................................................................... 3
The Workshop Environment ..................................................................................................................... 4
Time required .............................................................................................................................................. 4
Skill level ...................................................................................................................................................... 4
Prerequisites ............................................................................................................................................... 4
Getting Started ............................................................................................................................................ 4
Lab Instructions .......................................................................................................................................... 7
1. Getting Started with CLM applications ............................................................................................ 7
1.1. Login ................................................................................................................................................... 7
1.2. All Projects Page ............................................................................................................................... 8
1.3. Home icon .......................................................................................................................................... 9
2. Working with Dashboards ...................................................................................................................... 10
2.1. Explore Dashboards ......................................................................................................................... 12
2.2. Add a widget to the Dashboard ........................................................................................................... 13
2.3. Explore Mini Dashboards ..................................................................................................................... 16
3. Getting started with the Requirements Management application .......................................................... 17
3.1. Explore the Requirement Management (RM) application Interface .............................................. 18
3.2. Work with Artifacts ............................................................................................................................ 19
4. Explore the Change and Configuration Management application ........................................................... 21
4.1. Explore the Change and Configuration Management Web Client ................................................. 22
4.2. Explore the Eclipse Client ................................................................................................................ 36
5. Explore the Quality Management application ........................................................................................ 41
5.1. Explore the Quality Management application interface .................................................................. 42
5.2. Explore Test Plans, Test Cases, Test Scripts and Execution Records ........................................ 43
Summary ....................................................................................................................................................... 50
Overview
The IBM® Rational® Collaborative Lifecycle Management (CLM) solution is a set of seamlessly
integrated application lifecycle management (ALM) tools that work together as one.
IBM® Rational® Collaborative Lifecycle Management combines IBM Rational Team Concert, IBM
Rational DOORS Next Generation and IBM Rational Quality Manager. It delivers requirements
management, quality management, change and configuration management and project planning and
tracking. These integrated capabilities foster greater communication, collaboration and visibility to
accelerate delivery, improve quality and support better development decisions.
This lab introduces a new user to the basic navigation of the applications (Requirements Management,
Change and Configuration Management and Quality Management) of IBM Collaborative Lifecycle
Management(CLM) solution. The Lab also covers basic concepts and terminologies that a CLM user
should be familiar with.
Learning Objectives
This workshop demonstrates:
• How to work with Project and Personal Dashboards.
• How to navigate and explore artifacts in the Requirement Management application.
• How to navigate and explore work items and plans in the Change and Configuration
Management application
• How to work in the Rational Team Concert Eclipse client.
• How to navigate and explore test plans and test artifacts in the Quality Management
application.
This workshop can also be done using any CLM 6.0.5 installation that has the Money that Matters
sample project created. The project names may differ slightly.
Time required
Plan to take 2 hours to complete this workshop. If you explore other concepts that are related to this
workshop, it can take longer to complete.
Skill level
Basic.
Prerequisites
No prior knowledge of the IBM Collaborative Lifecycle Management solution is required.
Getting Started
1. Power on the Demo Environment image: IBM CLM 6.0.5 for Scaled Agile using SAFe 4.5
2. Log in as Administrator/passw0rd.
3. Double-click on the Deploy demo config.bat on the Desktop. This launches the
C:/IBM/DemoConfigurations/CLMConfigurationManager/ DeployConfiguration.bat
4. Deploy a Configuration:
a. Enter the number ‘0’ corresponding to the ScaledAgilePoT_605 configuration you want
to deploy.
b. The command will automatically try to stop your Jazz Team Server, waiting for you to
confirm that it is stopped.
e. Wait for the processing to complete. The command-line window will close on its own at
the end.
5. Start the Jazz Team Server by double-clicking the 02_Start Jazz Server icon on the desktop.
6. A CLM Server Startup command window is displayed. When it disappears, CLM has been started.
7. Use the 00_Getting Started document for more details on setup and configuration of the Demo
Environment.
Lab Instructions
1.1. Login
Access URL
__c. Type marco for both the User ID and Password and then click Log In.
Important!
The User ID and password are case sensitive.
In these labs, all IDs and passwords are lower case.
__1. You land on the All Projects page of the requirements management application which lists the
requirements management projects you have access to. From the All Projects page, you can
open a project dashboard or go directly to the Artifacts page of the project, navigate to the
modules of the project, and depending on your access rights, manage the project areas.
__1. Locate the Home icon, in the top left corner of the page.
__2. Click the down arrow next to the Home icon to see the menu.
Home menu
__3. Notice the navigation choices that are available from this menu.
Dashboards
Each dashboard can be easily customized many times over the course of a
project as needed. All project members have access to Dashboards but
require special permissions to modify it.
There are four types of dashboards: personal, project, team, and mini. Their
association implies their intended usage:
Important!
For simplicity, we will not be working all type of Dashboards in the lab.
Most descriptions apply to all Dashboards as they are managed in the
same manner.
__1. Navigate to the Project Dashboard for the Requirements Management application.
__b. The Project Dashboard for JKE Banking (Requirement Management) has been designed
with two tabs - General and Development tabs. Each tab has widgets that show
different data to the user.
__d. Locate the New Unassigned Stories widget and place your cursor (hover) over the
requirement Frequency of dividend transfer. Notice that a pop-up window
appears that shows information related to the requirement.
Rich Hover
__a. Select Add Widget (top right corner) and then the Requirements Management catalog
from the “Select Catalog” drop down list):
__b. The Requirement Management widgets are displayed. Select Next to page through the
available widgets and notice the variety of available widgets that can be placed on your
Personal Dashboard.
__c. Add the Requirements Tracing widget, by selecting Add Widget directly below that
widget’s name and once it has been added (you will see a small green box that says
“Added”), then close the list of available widgets by selecting Add Widget in the top right
of the page.
__b. Select the following in the Requirements Tracing widget’s settings dialog, to scope the
widget to see requirements that are associated with test cases that have failed.
__1. Click on the small dashboard icon on the upper left side of the page to access the Mini
Dashboard.
__2. The Mini Dashboard can be configured by adding widgets that are of interest and can be pinned
to stay in place and be visible, regardless of where else you navigate.
Artifact
__2. At the project level, the Artifacts page is divided into four sections:
__a. The Project Banner, which is at the top of the page. In the project banner you see
information about the Jazz Team Server you are logged into, the project name,
administration options, and access to help documents. You can minimize the banner by
clicking on the minimize banner icon on the top right edge of the project banner.
__b. The Content Pane, which displays the Artifacts that match the current filter criteria, as
selected in the left sidebar. The content section can be customized to show different
attributes and link information in columns.
In the image above you see the following
attributes: ID, Name, Artifact type, Modified By, and Modified On
__c. The left pane or left Sidebar which offers ways to filter the information in the content,
such as by folder. You can also create views so you can quickly switch perspective of
your data based on your filter criteria and desired columns.
__d. You can show, hide, or resize the sidebars by clicking click to collapse options or the
Resize sash that are shown when you hover near the edge of the sidebars.
__a. Menu bar: to navigate between the Project Dashboard, Artifacts, Reviews and Reports
__d. Filter: Use this to filter on the results shown in the content pane.
__e. Column Display: Use this dropdown to select or modify the columns to display.
__f. Folders: Folders and subfolders used to organize the artifacts. Click on the folder to see
the contained artifacts in the content section
__g. Additional actions menu: Use this burger menu to see additional action options.
__4. Expand the folders and select different sub folders to observe the artifacts contained within them.
__1. Select the Features folder and click on artifact Organizations can apply, to view its details.
__ii. The right sidebar, is divided in different sections which contain details about this
artifact:
• Content: Rich-text content that can contain text, images, and embedded
artifacts. This format is useful for text-based artifacts types, such as actor
and use-case specifications, user stories, features, business goals, and
glossary terms.
• Attributes: All artifacts have attributes, which are consistent for each artifact
type. Attributes are properties of the artifact, used to track project status and
organize artifacts by common properties such as owner, priority, and risk
__1. Utilize the Home icon, in the top right corner and navigate to the JKE Banking (Change
Management), under the Change and Configuration Management group:
Work Items
Queries
The primary method for finding work items is to run queries against
the repository. Queries retrieve work items whose attributes contain
values that match the values specified in the query. For example,
you might run a query that retrieves all work items whose status
attribute is in an unresolved state.
Jazz provides a set of predefined queries, and you can create
additional queries. You can also retrieve a specific work item by
entering its ID, and you can search for an item by entering a text
string. You can also find work items from the plan.
__d. Click on the Shared Queries tab, and from the list of predefined queries, click on
New Unassigned Stories to run the query.
__e. Review the results of running the query – the work items that are returned and the
columns that are displayed.
__f. On the Work Items query results, there are icons to:
__v. Re-run the Query and View the Full Results Set in a printable format.
__4. Now, let’s explore a work item to see how it is organized and what details are associated
with it.
__a. Click on Allocate Dividends to Multiple Causes to open the work item and explore
its details.
Plans
__5. Next let’s explore Plans, and Plan Views, and how Plans organize work items.
__a. Expand the Plans menu option, and click on Welcome to Plans
__c. Click on the sprint plan named BRM Sprint 2 (1.0) Plan
- Snapshots: Use this tab to create, edit, compare, and delete snapshots
of a plan
- Dashboard: Use this tab to display the plan dashboard, which tracks the
status and progress of a specific plan and provides plan statistics, such as
burndown reports or other reports that show progress over time.
- Notes: Enter notes about the plan
• Plan View: selecting different views alters how the planned items can be viewed.
The different Plan Views are:
- Planned Time: Displays work items based on a timeline such as past,
today, or tomorrow, and groups them by owner.
- Ranked List: Displays work items based on rank.
- Roadmap: Displays work items that are sorted by rank. The Accumulated
Time column displays the duration bar for each work item, which indicates
the duration that is taken to resolve the work item. You can drag the right
end of the duration bar to change the estimate of the work item.
Rescheduling changes the work sequence as defined in the My Work
view.
- Taskboard: Displays plan items in the left column and execution items in
the columns to the right. You can drag the child execution items to any of
the state groups to change status. Use the Colors option to highlight a
plan item's state. Work items are sorted by status.
- Traceability: Displays Collaborative Lifecycle Management traceability
columns for Test By and Affected By.
• Work breakdown: Groups work items by owner. Displays a hierarchical view
based on the parent-child relationship of the work items.
• Filters : Allow you to select which plan items that you want to exclude from
display
• Plan Icons:
- Collapse All
- Expand All
- Apply Ranks
- Export to .csv file
• Add a Work Item to the Plan
__6. Source Control Management or Version Control is a key capability of the Change and
Configuration Management application.
Source Control
The built-in source control system is component-based and
built on the Jazz™ platform. It has strong support for
parallel and agile development and geographically
distributed teams. It integrates tightly with defect tracking,
builds, and process-centric automation.
Builds
__a. Expand the Builds menu option, and click on Welcome to Builds.
The Change and Configuration Management application supports\integrates with many development
IDE’s to support developers working on different platforms and technologies.
In this section, you will explore the Eclipse Client and the different views that are available.
Workspace
__a. Accept the default workspace, which is C:\RTCworkspace and click on OK.
__3. From the menu, select Window > Open Perspective to change perspective. The following
perspectives are popularly used:
__a. Work Items perspective: On the left side of the workbench, this window contains the
following views:
__i. Team Artifacts: Manages your connections to a repository and a project area.
When you are connected to a project area, you can access its artifacts. The
artifacts are grouped into different nodes.
__ii. My Work view: Shows the work that is currently assigned to you. You
typically start to work on a work item from this view. It contains sections
that are related to your work items: Inbox, Current Work, and Future
Work.
__iii. Work Items view: displays the results of the query that was most
recently run. If you select a work item from the Work Items view, the Work
Items editor opens.
__iv. Work Items editor: is displayed on the right side of the workbench, above
the Work Items view.
__b. Java perspective: On the left side of the workbench, this perspective contains
the following views:
__i. Package Explorer view: which contains a navigable list of your project
artifacts.
__iii. Package Explorer view: Select a file from this view to open a Source File
editor, which in this image is above the Work Items view.
__4. The Team Artifacts view is used the most when working with projects in the Jazz
repository. It has some important sections:
__a. Repository Connections: Shows the user and the jazz repository they are
connected to.
__b. Projects: Lists the Projects the user is connected to. For each project it shows us
the Builds, Plans, Reports, Streams, and Work Items in the project.
__5. All the activities that we performed in the earlier section are possible in the RTC Eclipse
Client. Let us explore queries and work items.
__a. On the Team Artifacts view, expand under the project area JKE Banking (Change
Management)
__b. Under it, further expand Work Items > Shared Queries > Predefined
__c. Double-click the query named New Unassigned Stories.
__d. This will run the query (the same one that you ran previously in the web client and
the results will be displayed in the Work Items view.
__e. Double-click the work items Allocate Dividends to Multiple Causes to open it.
__f. Select the tabs at the bottom of the work item, such as Overview, Acceptance,
Links, Approvals and History to examine the information on each.
__g. When finished exploring the RTC Eclipse client, close it by selecting File > Exit.
__1. Utilize the Home icon, in the top right corner and navigate to the JKE Banking (Quality
Management), under the Quality Management group.
__2. Let’s start by exploring the capability menu of the tool. The capability menu has the following
items:
__a. Requirements: Allows you to create Requirements and Requirements Collections
in the Requirements Management application associated with this project. Selecting
View Requirements will navigate to the Requirements Management application.
__b. Planning: Allows you to Browse, Create and Import Test Plans.
__c. Construction: Allows you to Browse and Create Test Cases, Test Scripts, Test
Suites, Test Data and Keywords. Additionally, allow for the import of Test Cases
and Test Scripts.
__d. Lab Management: Allows you Browse and Create Lab Management details, such
as Resource Groups, Requests, Reservations, Test Cells, etc.
__e. Builds: Allows you to Browse and Create Build Records and Definitions
__f. Execution: Allows you to Browse Execution details, such as Execution Records
and Results for Test Cases and Test Suites and Create an Execution Schedule.
__g. Reports: Allows you to Browse and Create Reports.
__h. Change Management: Allows you to Create a Work Item or Task in the Change
Management application or Navigate to the Work Items Home in Change
Management.
5.2. Explore Test Plans, Test Cases, Test Scripts and Execution Records
__1. Now let’s work with Test Plans. To browse through an existing Test Plan
Test Plan
The test plan describes the scope of the overall test effort
and provides a record of the test planning process. The test
plan can be configured to meet the needs of your team.
Typically, a test plan identifies requirements, risks, test
cases, the test environments to be tested, business and
quality objectives, test schedules, and other items.
__b. A View shows all the Test Plans with its details. The view has a list of icons:
__d. The test plan is now open for editing. Review the Sections that are listed on the left and
the Progress Information for the Test Plan.
__i. Summary: Summary level information of the plan
• Sections: Additional details about the test plan, such as Summary, Business
Objectives, Links to Requirements and Development Plans, Test Cases, etc.
__ii. Snapshots and History: Display snapshots and history of changes to the Test
Plan
__iii. Attributes: Properties of the Test Plan
__iv. Progress Information: Execution progress of Test Cases and Test Suites
__3. The Test Case section lists all the test cases related to the Test Plan. To explore a Test Case:
__e. Select the Test Cases section of the Test Plan to see the list of test cases that are
associated with this plan.
Test Case
__f. Click on the Allocate Dividends by Percentage test case to review the details.
__2. An important section of the Test Case is the Test Script section. To explore Test Scripts:
__a. Select the Test Scripts section of the test case and note that there is a test script
associated with this test case.
Test Script
__b. Select the test script Allocate Dividends by Percentage to open it and look at its
details.
__c. The test script contains the steps that can be manually executed to run the test case.
__3. The other important section of a Test Case is Test Execution Records and Results. To explore
Test Execution Records:
__a. Return to the test case, by selecting Allocate Dividends by Percentage from the
breadcrumb above the Test Script.
__b. Select the Test Case Execution Records section for the Test Case and notice that
there are two execution records and from the Last Result column, one had a last result
of passed and one failed.
Summary
In this lab, you have learned how to navigate the three applications on the Jazz platform- Requirements
Management, Change and Configuration Management and Quality Management. You learned how to
use the home button to locate the different dashboards (such as Project, Personal and Mini dashboards)
and customize them, and navigate between the different applications. You explored each of these
applications, learned about the artifacts they contain, and how to navigate between the different pages
and locate pertinent information.