RMC 7.5.3.1 Web-based Authoring Tech Preview Lab...RMC 7.5.3.1 – Web-based Authoring Tech Preview Lab The Web-based Authoring tech preview, introduced in RMC 7.5.3.1, enables subject

© Copyright IBM Corp. 2018 Web-based authoring tech preview - 1

Course materials may not be reproduced in whole or in part without the prior written permission of IBM.

RMC 7.5.3.1 – Web-based Authoring Tech Preview Lab

The Web-based Authoring tech preview, introduced in RMC 7.5.3.1, enables subject matter experts to contribute

Method Content via a web-based interface. When this feature graduates from Tech Preview status, subject matter

experts will no longer have to install the Rational Method Composer (RMC) thick client. Instead, they can use

Rational DOORS Next Generation (DNG), which is a web-based tool normally used for defining requirements. We

have used a customized DNG project template with attributes and link types that are mapped into RMC.

The long-term strategy is to have an RMC extension to DNG that can replace the need for the RMC thick client.

Initially, however, the approach is to export from RMC into DNG, subject matter experts contribute via DNG’s web

interface, and that content is then imported into RMC for additional changes and for publishing.

The goal of this Tech Preview is to gather customer feedback regarding the suitability of the DNG interface for

authoring method content, and feedback on what are the highest value capabilities of RMC that should be provided

by an RMC add-on. This Lab walks you through how to explore the tech preview.

You may use your own installation of RMC and DNG – or you may use a cloud-based image.

Task 0. Download and Install

In this task you will download a sample practice library which you will use in the later tasks. Note that this task is

only necessary if you intend to use your own installation. If you are using the cloud-based image then you may skip

this task and proceed to Task 1.

1. Install Rational Method Composer version 7.5.3.1 from Jazz.net: https://jazz.net/downloads/rational-

method-composer

2. Download the sample library and published method content:

a. In a web browser, open this page:

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/W6b0a089a62f

3_4493_bcc1_ebe60a2ebb41/page/Tech%20preview%20-

%20Web%20based%20method%20authoring%20with%20RDNG

b. Scroll to the bottom of the page and click Attachments:

c. Click web_auth_sample_lib.zip to download the sample library

d. Click risk_management_published.zip to download the published content

https://jazz.net/downloads/rational-method-composer

https://jazz.net/downloads/rational-method-composer

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/W6b0a089a62f3_4493_bcc1_ebe60a2ebb41/page/Tech%20preview%20-%20Web%20based%20method%20authoring%20with%20RDNG



Rational Method Composer

Web-based authoring tech preview © Copyright IBM Corp. 2018


TIP: Instead of downloading the published content you can instead open the sample library in Method Composer

and publish it yourself.

e. Unzip the file(s)

TIP: On the cloud image, the library is unzipped to C:\IBM\web_auth_sample_lib and the published content is is

unzipped to C:\IBM\risk_management_published

Task 1. Create a DOORS Next Generation Project

In this task you will create a new blank DOORS Next Generation project area.

1. Open DOORS Next Generation:

a. In a web browser, open DOORS Next Generation

TIP: On the cloud image DNG is located here: https://clmweb.ibm.com:9443/rm/web.

b. Login as a user with administrative rights to create DNG project areas

TIP: On the cloud image, login with userid/password rebecca/rebecca.

2. Create a New Project Area:

a. Click Manage All Projects

b. Click Create Project Area

c. Give the project any name you like (for example RMC-Tech-Preview)

d. Click Save.

TIP: You should get a message “Project area created successfully”.

3. Add Members:

a. Scroll down to the Members section and click Add.

b. Add yourself (Rebecca if using the cloud image) as a member with the Administrator role.

c. Click Save.

https://clmweb.ibm.com:9443/rm/web

Overview of RMC

© Copyright IBM Corp. 2018 Web based authoring Tech Preview - 3


TIP: Note that Rebecca does NOT appear under the Administrators section, which is a different type of

Administrator.

4. Open the project:

a. Click Explore Project

b. Close the popup window that says “This project has no artifact types …”

TIP: Artifact types will be created later when you import the library from Rational Method Composer

Task 2. Browse the Demo Content

In this task you will browse the published method content to become familiar with the content that you

will be working with in the demo.

1. Open the published content:

a. In the web browser, open a new tab

b. Open the Risk Management website (index.htm) from the published content

TIP: If you published this yourself or downloaded the content, then index.htm will be in Publish/rmcwebsite

TIP: On the cloud image, index.htm is in C:\IBM\risk_management_published.




TIP: This is an example process Web site generated by Rational Method Composer. It shows a selection of

elements that you will be working with in this demo.

Overview of RMC



2. Explore the Manage Risks Task:

a. In the browser on the left, click the Manage Risks Task:

b. Observe that the Primary Performer is the Project Manager role

c. Observe that the Output work product is the Risk List

Task 3. View in RMC, and Export to ReqIF

In this task, you will view the library that was used to create the demo web site, and then export the

library into ReqIF, the XML format for importing into RDNG.

1. Open Rational Method Composer:

a. From the start menu, launch Rational Method Composer 7.5.3.1

b. If prompted to “Copy Library” click Skip

2. Open the method library:

a. Click File → Open → Method Library

b. In the Path field, click Browse and browse to the location where you unzipped the sample

library:




c. Click Finish.

3. Explore the practice library:

a. In the Library panel expand risk_management → Method Content → Content Packages →

Content Elements → Tasks:

b. Double-click on the manage_risks Task to open it.

c. Select the Roles tab at the bottom of the manage_risks panel:

d. Note that the Primary performers section contains the project manager:

Overview of RMC



e. Click the Work Products tab

f. Note that the Outputs section contains risk_list:

TIP: Feel free to explore the practice library on your own before continuing

4. Export the library to ReqIF:

a. From the menu, select File → Export

b. Select ReqIF




c. Click Next

d. Click Next again.

e. In the ReqIF Directory field, click Browse and select a folder in which to export the ReqIF file:

f. Click Finish.

Task 4. Import the Practice Library into RDNG

In this task you will import the RMC library ReqIF file into Rational DOORS Next Generation.

1. Import the ReqIF file:

a. In the web browser, switch to the DOORS Next Generation project area tab

b. In the menu bar, click Artifacts

c. Click Create → Import Artifact…

d. Select Import requirements from a ReqIF file:

Overview of RMC



e. Click Next

f. Click Choose File and select the file that you exported earlier:

g. Click Upload

h. Click Next

i. Click Next again

j. Wait for the content to be imported:




k. Click Close

l. Refresh the web page

Task 5. View Imported Method Content in RDNG

In this task you will browse the imported practice library and observe how the different RMC element

types, attributes, and links are represented.

1. Explore the Risk Management content:

a. In the sidebar, expand the folder structure:

TIP: Note that folders were created for the risk_management plugin and the Content Packages in it as shown

below

Overview of RMC



2. Explore the Manage Risks Task:

a. Click the Content Elements folder

b. Note the types of artifact that have been created:

c. Click the Manage Risks Task to open it:




TIP: Each rich text attribute in RMC is represented as Heading 1 style. They are matched by name, so you can

place them in any order you like. Missing rich text attributes like “Main Description” are present, but

blank.

TIP: Individual steps are Heading 2 style:

Overview of RMC



d. Observe how the Brief description from RMC has become the Description of the DNG artifact:

3. Observe the DNG artifact attribute rmc_filename:




TIP: This is used to preserve the RMC name attribute (which is used as a filename in RMC)

b. In the right-hand sidebar, click the Overview tab to collapse it:

c. Click the Links tab to expand it:

Overview of RMC



d. Observe the relationships to work products and roles:

e. Observe that the artifact is Referred by the Risk Management practice

TIP: This means it is included as part of the Risk Management practice

f. Hover your mouse over any of the links to see a rich-hover popup for that element:




4. Explore the Project Manager Role:

a. In the breadcrumb at the top of the page, click Content Elements:

5. Click the Project Manager Role to open it:

a. In the right-hand sidebar, click the Links tab

b. Note the Project Manager has a Responsible For link to the Risk List artifact:

Overview of RMC



6. Explore a Tool Mentor:

a. In the web browser, click Back

b. Click the Supporting Package folder:

c. Click the Managing Risks with IBM Rational Team Concert Guidance




d. Note that the artifact has a Guidance Kind attribute of Tool Mentor:

e. Note that this artifact contains a graphic:

Overview of RMC



7. Modify the view to show custom attributes:

a. In the breadcrumb at the top of the page, click Supporting Package

b. Observe that there are several Guidance artifacts named Risk List:

c. Click the Configure Page Settings button at the top of the second column in the table:




d. Click Configure Columns to Display:

e. In the Type to filter by attribute or name field, type gui to filter the list as shown below:

f. Select the Guidance Kind attribute

g. Click Add

h. Click OK

Overview of RMC



TIP: Now you can easily distinguish between different types of Guidance artifact. Note that Work Product Kind

can be used to similarly distinguish between Artifact, Deliverable, and Outcome type work products.

Task 6. Make Changes and Export to ReqIF

In this task you will make some changes to the practice content in DNG and then export the new library

as a ReqIF file for import back to RMC.

1. Edit the Manage Risks Task:

a. Click the Content Elements folder

b. Click the Manage Risks Task to open it:

c. At the top, right-hand corner of the page, click Edit.

d. In the editor window, under Purpose add a new bullet with the text Communicate risks to the

as shown below:




2. In the menu bar, click Insert → Add Link:

a. Select the Project Manager:

b. Click OK

Overview of RMC



c. In the right-hand sidebar, in the Links section, click the pencil icon next to Vision:

d. Click Remove

e. Click Yes:

f. In the Links panel, click Add Link to Artifact:

g. Select Output:




h. In the Folders panel, select Supporting Package

i. Select the Vision Work Product

TIP: Use the icons or rich hover to ensure you are selecting the Work Product, and not the checklist with the

same name. In future, we will use Link Constraints to ensure only valid element types are selected.

j. Click OK

k. Click Save

3. Export the library as a ReqIF file:

a. At the top, right-hand side of the page, click the gear icon, and select Manage Project

Properties

Overview of RMC



b. Select the ReqIF tab

c. Click the pencil icon next to the ReqIF Definition and select Export:

4. Click Download to save the resulting ReqIF file:

Task 7. Import to RMC

In this task you will see how changes exported from RDNG can be imported into RMC.

1. Create a new RMC library:

a. Switch to Rational Method Composer

b. From the menu, select File → New → Method Library.

c. Specify a path for the new library and click Finish

2. Import the ReqIF file:

a. From the menu, select File → Import

b. Select ReqIF




c. Click Next.

d. Click Browse and select the ReqIf file downloaded in the previous task.

e. Click Finish.

3. Observe the changes you made using DNG, now appearing in RMC.

Summary

In this lab you have:

• Exported an RMC library into DNG

• Made changes in DNG

• Imported those changes into a new RMC library

This was just a brief overview of this tech preview. For more information, contact:

Bruce MacIsaac [email protected] or Amy Silberbauer [email protected]

mailto:[email protected]

mailto:[email protected]

Documents

RMC 7.5.3.1 Web-based Authoring Tech Preview Lab...RMC 7.5.3.1 – Web-based Authoring Tech Preview Lab The Web-based Authoring tech preview, introduced in RMC 7.5.3.1, enables subject