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.
- In the navigation bar, click Friend (Outbound), and then click Add.
- Register the consumer by providing values for Name, Root Services URI (for example, http://focalpointserver.com:9080/fp/resources/rootservices), and OAuth Secret.
- 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
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.
- Go to https://clmserver.com:9443/ccm/admin, and click Project Areas > Active Project Areas. All the Active Project Areas are listed.
- Open a project; for example, "JKE Banking (Change Management)"
- To add a project area association, click Add... in the Associations section. Doing so loads the Add Association window.
- From the Application list, select the container. The list includes all the applications registered as Friends for your application, such as Focal Point.
- From the Association list, select the required association for Rational Team Concert, such as Provides Implementation Requests.
- From Artifact Containers, select the required container. Artifact Containers lists the Rational Focal Point workspaces to which users have access.
- Click OK. The project area association is created.
- 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
Configure the Integration link
The next step is configuring the Integration link.
- Select Configure > Attributes > Integration link.
- 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.)
- Select the Include Description check box. This enables populating of the business needs description in the Publish dialog with the CLM application.
- 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.
- 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
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.
- Configure the Integration link with the Property URI.
- Register Friend (Outbound) in the CLM server.
- Configure the Project associations in the CLM application
- Define a Display and Add view for the module.
- 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.
- Open a work item in the CLM application.
- Go to the Links tab and click Add Link.
- Select Implements Requirement. See Figure 4.
Figure 4. Add a link from the Rational Team Concert project area
This choice opens the Add Link dialog window.
- Select the Focal Point workspace.
- Click the Link to existing radio button. See Figure 5.
Figure 5. The Add Link dialog in CLM
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 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
Now you'll see the available Focal Point artifacts under Select View and Select View Filter.
- Select an artifact and click OK.
- 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
Create a Focal Point business need
You can also create a Focal Point business need from the CLM application with the Delegated Resource dialog.
- Open a work item in your CLM application
- Go to the Links tab and click Add Link.
- Select Implements Requirement. The Add Link dialog window opens.
- 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
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
Click Pick View. It lists the views available in Focal Point. See Figure 11.
Figure 11. Select a view in the CLM application
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
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
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 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
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.
- For more about Focal Point:
- Explore the Rational software area on developerWorks for technical resources and best practices for other Rational Software Delivery Platform products.
- Stay current with developerWorks technical events and webcasts focused on a variety of IBM products and IT industry topics.
- Improve your skills. Check the Rational training and certification catalog, which includes many types of courses on a wide range of topics. You can take some of them anywhere, anytime, and many of the Getting Started ones are free.
- For more about the Rational solution for Collaborative Lifecycle Management (CLM):
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.
- Join the Rational Focal Point forum to ask questions and participate in discussions.
- Get connected with your peers and keep up on the latest information in the Rational community.
- Rate and write a review of Rational Focal Point. It's quick and easy.
- Share your knowledge and help others who use Rational software by writing a developerWorks article. Find out what makes a good developerWorks article and how to proceed.
- Follow Rational software on Facebook, Twitter (@ibmrational), and YouTube, and add your comments and requests.
- Ask and answer questions and increase your expertise when you get involved in the Rational forums, cafés, and wikis.