Leverage the OSLC service provider capabilities of IBM Rational Focal Point 6.6

Create and select Rational Focal Point artifacts from an application that supports OSLC and use rich hover text to preview more details

IBM® Rational® Focal Point™ had been only a consumer of Open Services Lifecycle Collaboration (OSLC) services. With the release of Rational Focal Point 6.6, however, Focal Point now offers OSLC service provider capabilities for the Rational solution for Collaborative Lifecycle Management (CLM) and other OSLC consumer applications. This article demonstrates how to leverage the new OSLC service provider capabilities of Focal Point.

Share:

Vipin Kumar Agrawal (vipin.kumar@in.ibm.com), Senior Staff Software Engineer, I.B.M.

author photoVipin Agrawal works in quality assurance for the Rational Focal Point functional verification test (FVT) team. He has worked in the portfolio management domain for products such as Rational Portfolio Manager, Rational Project Conductor, and Rational Team Concert. He has published articles in devWorks and Jazz.net and been a speaker at the QSE conference.



17 September 2013

Also available in Chinese

Until now, IBM® Rational® Focal Point™ was known for consuming the Open Services Lifecycle Collaboration (OSLC) services that other applications provided. But Rational Focal Point 6.6 offers OSLC service provider capabilities for Collaborative Lifecycle Management (CLM) applications and other OSLC consumer applications.

With this enhanced capability, any OSLC consumer application can use the Focal Point Delegated Resource Creation dialog to create Focal Point artifacts, and the Focal Point Delegated Resource Selection dialog to select Focal Point artifacts. You can also see rich hover text to preview the Focal Point linked artifacts from the OSLC consumer applications. This article demonstrates how to leverage the new OSLC service provider capability of Focal Point.

Simplifying the management of business needs

Focal Point provides capabilities for managing project portfolios, business opportunities, and high level project scoping in terms of stakeholder requests termed as business needs. These business needs are captured in Focal Point and then scoped to a project. Managers communicate the business needs to the implementation team and ensure adequate understanding and traceability by publishing them to IBM® Rational Team Concert™ as work items.

During implementation, new business needs for the project might get added in Focal Point. These business needs must be published to Rational Team Concert for implementation. Similarly, new work items might be defined within the project scope as business needs in Rational Team Concert that must be communicated to the management and defined within the project scope as business needs in Focal Point.

Previously you couldn't create an artifact in Focal Point from other applications, and there was a dependency to log into Focal Point. But now any OSLC consumer application — from its own user interface — can create an artifact in Focal Point on the fly. To do this, you must configure Focal Point and the CLM application.


Configure Focal Point and CLM applications

To configure Focal Point and a CLM application, your first step is to register Focal Point as an incoming consumer in the CLM application server. Here I'll use Rational Team Concert as the example for configuration. In the CLM applications, the consumer key is generated for Rational Team Concert. It identifies Focal Point to the CLM application server.

Register a Friend (Outbound) in the CLM application

The following configuration steps assume that Focal Point is installed at http://focalpointserver.com:9080/fp/servlet/Login and CLM is installed at https://clmserver.com:9443/jts/admin. This installation pathway is required for the Delegated Resource dialog and viewing rich hover data in the CLM application.

  1. In the navigation bar, click Friend (Outbound), and then click Add.
  2. Register the consumer by providing values for Name, Root Services URI (for example, http://focalpointserver.com:9080/fp/resources/rootservices), and OAuth Secret.
  3. Click Create Friend. This action generates a consumer key and adds an entry in Focal Point under Application > Consumer (Inbound). See Figure 1.
Figure 1. Register Friend (Outbound) in the CLM application
The Add Friend page in the CLM application

Configure project associations in the CLM application

Now you're ready to configure the project associations in Rational Team Concert. You can configure links for more than one Focal Point workspace.

  1. Go to https://clmserver.com:9443/ccm/admin, and click Project Areas > Active Project Areas. All the Active Project Areas are listed.
  2. Open a project; for example, "JKE Banking (Change Management)"
  3. To add a project area association, click Add... in the Associations section. Doing so loads the Add Association window.
  4. From the Application list, select the container. The list includes all the applications registered as Friends for your application, such as Focal Point.
  5. From the Association list, select the required association for Rational Team Concert, such as Provides Implementation Requests.
  6. From Artifact Containers, select the required container. Artifact Containers lists the Rational Focal Point workspaces to which users have access.
  7. Click OK. The project area association is created.
  8. Click Save on the Project Areas page.

To see how this configuration process looks, see Figure 2.

Figure 2. Add the project area association in the CLM application
Configuring project associations

Configure the Integration link

The next step is configuring the Integration link.

  1. Select Configure > Attributes > Integration link.
  2. In Allowed Service Providers, click the friend's server name (for example, FP-RTC, for Focal Point-Rational Team Concert) to get a list of CLM projects. Select the project for which you want to publish business needs. (Selected CLM projects will be shown as choices while you create requirements.)
  3. Select the Include Description check box. This enables populating of the business needs description in the Publish dialog with the CLM application.
  4. In Property URI, provide the URI for the supported link type. For example, the Property URI for the Implements Requirement link is http://open-services.net/ns/rm#implementedBy.
  5. Select the Log Changes check box to enable history logging.

Figure 3 shows the Integration link configuration.

Figure 3. Configure the Integration link in Focal Point
The Integration link configuration page

Select and create business needs from CLM into Focal Point

Before you can select and create business needs into Focal Point, you must complete several tasks.

  1. Configure the Integration link with the Property URI.
  2. Register Friend (Outbound) in the CLM server.
  3. Configure the Project associations in the CLM application
  4. Define a Display and Add view for the module.
  5. Select the Preview view in Focal Point (Configure > Module).

After these prerequisites are met, you're ready to use Focal Point Delegated Resource dialog. You can do this in either of two ways:

  • Select an existing Focal Point business need from the CLM application.
  • Create a new Focal Point business need from the CLM application.

The next sections describe both methods.

Select an existing Focal Point business need

You can select an existing Focal Point business need from the CLM application using the Delegated Resource dialog.

  1. Open a work item in the CLM application.
  2. Go to the Links tab and click Add Link.
  3. Select Implements Requirement. See Figure 4.
Figure 4. Add a link from the Rational Team Concert project area
The Links page in CLM

This choice opens the Add Link dialog window.

  1. Select the Focal Point workspace.
  2. Click the Link to existing radio button. See Figure 5.
Figure 5. The Add Link dialog in CLM
Completing the Add Link dialog

Clicking the Link to existing radio button opens a Select Focal Point Artifacts dialog window. Click Pick View/Filter. See Figure 6.

Figure 6. Choose View/Filter
The Pick View/Filter screen in CLM

The resulting dialog lists the display views and respective filters available in Focal Point. Select a view and filter and click OK. See Figure 7.

Figure 7. The View and Filter lists displayed in CLM
Select from the View and Filter lists

Now you'll see the available Focal Point artifacts under Select View and Select View Filter.

  1. Select an artifact and click OK.
  2. Save the CLM work item. The link from the CLM work item to the selected Focal Point artifact is created under the Focal Point artifact with the Integration link attribute. See Figure 8.
Figure 8. CLM work item with a link to a Focal Point artifact
Work item showing a link to an artifact

Create a Focal Point business need

You can also create a Focal Point business need from the CLM application with the Delegated Resource dialog.

  1. Open a work item in your CLM application
  2. Go to the Links tab and click Add Link.
  3. Select Implements Requirement. The Add Link dialog window opens.
  4. Select the Focal Point project and click the Create New radio button. See Figure 9.
Figure 9. Add the link to create a new Focal Point artifact
Choose Create new in the Add Link dialog in CLM

Clicking the Create new radio button opens up a Pick View dialog window. See Figure 10.

Figure 10. The Pick View dialog in the CLM application
Choosing views from the Pick View dialog

Click Pick View. It lists the views available in Focal Point. See Figure 11.

Figure 11. Select a view in the CLM application
Pick a view in Create Focal Point Artifact window

Select a view and click OK. This action opens the Create Focal Point Artifact dialog. See Figure 12.

Figure 12. The Create Focal Point Artifact dialog
Use Create Artifact dialog for attribute values

Next, provide the values for the attributes in the dialog and click OK. Save the CLM work item. A new artifact is created in Focal Point under selected view. The link from the CLM work item to the new Focal Point artifact will be created under the Integration Link attribute. See Figure 13.

Figure 13. Newly created artifact in Focal Point
New artifact is under Integration Link attribute

Check rich hover views from Focal Point

When you hover your mouse cursor over an artifact in Focal Point, you'll see the respective requirement from the CLM server through a rich hover pop-up window. See Figure 14.

Figure 14. Rich hover view in Focal Point
Rich hover view of an artifact link

Rich hover view from a CLM server

Similarly, you can get rich hover data when you hover your mouse cursor over an artifact link in a CLM server. See Figure 15.

Figure 15. Rich hover view from a CLM application artifact link
Rich hover pop-up window

Conclusion

The new functionality of Focal Point 6.6 means that Focal Point now offers OSLC service provider capabilities for CLM applications and other OSLC consumer applications. This article demonstrates how you can leverage these capabilities and use the Delegated Resource creation dialog to create Focal Point artifacts, and the Delegated Resource selection dialog to select Focal Point artifacts. You can also use rich hover text to preview the Focal Point linked artifacts from the OSLC consumer applications.

Resources

Learn

Get products and technologies

  • Download a free trial version of Rational software.
  • Evaluate other IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.

Discuss

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Rational software on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=945056
ArticleTitle=Leverage the OSLC service provider capabilities of IBM Rational Focal Point 6.6
publish-date=09172013