Improve Rational Focal Point queries by using the Lifecycle Query Engine

Lifecycle Query Engine supports indexing Linked Data from applications supported by the Tracked Resource Set (TRS) specification to provide a SPARQL endpoint for querying. Karthikeyan Dakshinamurthy provides details for configuring Rational Focal Point as one of the query engine sources to improve querying capability.

Share:

Karthikeyan Dakshinamurthy (kdakshin@in.ibm.com), Senior Advisory Software Engineer, IBM China

author photoKarthikeyan Dakshinamurthy is the integration architect for the Rational Focal Point development team. He has led the design and development for integrating Rational Focal Point with the Rational solution for Collaborative Lifecycle Management (CLM).


developerWorks Contributing author
        level

05 April 2013

Introduction

The Lifecycle Query Engine, which was released as part of IBM® Rational® Engineering Lifecycle Manager, indexes Linked Data across tools that implemented the Tracked Resource Set (TRS) server specification, such as IBM® Rational Team Concert™, IBM® Rational® Rhapsody®, Rational® DOORS®, and Rational® Quality Manager. It provides a SPARQL endpoint for querying. Tracked Resource Set is an OSLC draft specification that is defined so that server applications can make a set of resources and their changes available to enable the client applications. The client application automatically updates to the changes. Lifecycle Query Engine is a TRS client application that indexes the resource and their changes from one or more TRS server applications to give an efficient Linked Data querying through the SPARQL endpoint.

Starting with Version 6.5.2, IBM® Rational® Focal Point supports Linked Data, and it became a TRS server application that provides TRS feeds. Therefore, Rational Focal Point Linked Data resources and their changes can be tracked and indexed into the Lifecycle Query Engine for efficient search and queries.

This article explains how to configure Rational Focal Point with Lifecycle Query Engine to index Focal Point data for efficient Linked Data queries.


Advantages

  • With Lifecycle Query Engine configured, Rational Focal Point Linked Data is enabled, so you can use SPARQL, a powerful query language, for queries.
  • Querying across multiple Rational Focal Point modules or workspaces or even across instances is simple with this approach.
  • There is no additional performance impact on Rational Focal Point, because the query execution requests are served by the Lifecycle Query Engine.
  • Traceability reports across any applications that support the Tracked Resource Set (TRS) specification can be generated without affecting the performance of the applications.

Organizing Rational Focal Point Linked Data

Organizing Rational Focal Point Linked Data is an important step before you start indexing that data in Lifecycle Query Engine. Organizing the data includes assigning appropriate Resource Description Framework (RDF) vocabularies to user-defined modules, attributes, and enumerator items.

Starting with Version 6.5.2, all Rational Focal Point resources or elements are retrievable in RDF representations. To retrieve an element in RDF, use the application/rdf+xml value as the HTTP Accept header while making a REST API call. The Linked Data implementation, along with reusing a few standard vocabularies such as FOAF, DCTerms, and OSLC Core, has defined two additional vocabularies, namely the Focal Point Vocabulary and the Focal Point Data Types Vocabulary. For details about these vocabularies and the overall vocabulary approach, see the Vocabulary approach page in the information center.

You can configure vocabularies for user-defined element types, attributes, and enumerator types. Follow the Vocabulary approach instructions in the information center before you start to index Rational Focal Point data in the Lifecycle Query Engine. Focal Point automatically generates default vocabularies if vocabularies are not specified for user defined types and attributes.


Configuration

Follow the steps in this section to configure Rational Focal Point TRS feeds as data sources for the Lifecycle Query Engine.

Prerequisites

  • Rational Focal Point Version 6.5.2 or later is installed and running.
  • Lifecycle Query Engine Version 1.0 or later is installed, by default, as part of Rational Engineering Lifecycle Manager, and running.
  • The Rational Focal Point server URL is accessible from the Lifecycle Query Engine server.

These configuration steps are based on the assumption that Focal Point is installed here:
http://focalpointserver.com:8091/fp/servlet/Login

The Lifecycle Query Engine is installed here:
https://queryengineserver.com:9443/lqe/web

Focal Point exposes workspaces as separate TRS data sources known as TRS feeds. In this way, you can choose the required workspaces for indexing into the Lifecycle Query Engine. The Rational Focal Point root services document lists all of the available TRS feeds in the running Focal Point application, as Listing 1 shows. You and find it here:
http://focalpointserver.com:8091/fp/resources/rootservices

Listing 1. Rational Focal Point root services document showing available TRS feeds
<rdf:Description rdf:about="http://focalpointserver.com:8091/fp/resources/rootservices"
 xmlns:jfs="http://jazz.net/xmlns/prod/jazz/jfs/1.0/"
 xmlns:trs="http://jazz.net/ns/trs#"
 xmlns:fps="http://jazz.net/ns/psm/focalpoint#"
 xmlns:oslc="http://open-services.net/ns/core#"
 ...
 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 xmlns:dc="http://purl.org/dc/terms/">
 <dc:title>IBM Rational Focal Point Application</dc:title>
 ...
 <fps:trackedResourceSetProvider>
    <trs:TrackedResourceSetProvider>
       <trs:trackedResourceSet rdf:resource="http://focalpointserver.com:8091/fp/
resources/workspaces/3/trs"/>
       <trs:trackedResourceSet rdf:resource="http://focalpointserver.com:8091/fp/
resources/workspaces/2/trs"/>
     </trs:TrackedResourceSetProvider>
 </fps:trackedResourceSetProvider>
</rdf:Description>

Register Rational Focal Point and Lifecycle Query Engine applications to each other

Because Focal Point is providing the resources and the changes, it must be registered as a Friend in the Lifecycle Query Engine application. Similarly, Lifecycle Query Engine must be approved as a valid Consumer in Focal Point. The following steps illustrate how to register these applications.

  1. Log in to Rational Focal Point as an administrator. On the Login page (Application > Login), update the Login or Load Balancer URL property to make sure that this Focal Point root services URL is accessible from the Lifecycle Query Engine server:
    http://focalpointserver.com:8091/fp/resources/rootservices
Figure 1. Configure the Login or Load Balancer URL
Screen capture, Login Page Settings view
  1. Make sure that the URLs in the Rational Focal Point root service document are valid according to the value configured at Login or Load Balancer URL
  2. Log in as administrator to the Jazz Team Server where the Lifecycle Query Engine application is deployed. In this example, this is the location:
    https://queryengineserver.com:9443/jts/admin
  3. In the Communication section, Under Server Admin, select the Friends (Outbound) page.
  4. Register Rational Focal Point as one the friends by clicking the Add link and using the Rational Focal Point's root service URL:
    http://focalpointserver.com:8091/fp/resources/rootservices.
Figure 2. Register Rational Focal Point as a friend in Lifecycle Query Engine
Friends (Outbound) Server Administration page
  1. Log in again to Rational Focal Point as an administrator. From the Consumers (Inbound) page, Application > Consumers (Inbound), change the Consumer entry to what you added in the previous step.
  2. Add a valid Rational Focal Point user for Functional User ID, and make sure that the Trusted? flag is set to ON.
Figure 3. Configure Lifecycle Query Engine as a trusted consumer in Rational Focal Point
Configuring a trusted RFP user to the Lifecycle Query Engine consumer connection.

Configure the Rational Focal Point TRS feed as a Lifecycle Query Engine data source

  1. Log in to Lifecycle Query Engine as an administrator; select Administration > Data sources, and click the Add Data Source link to open the dialog window.
  2. In the Data Sources dialog window, click the Root Services document URL option, and enter the Rational Focal Point root services URL:
    http://focalpointserver.com:8091/fp/resources/rootservices

After entering a valid URL, you will see a list of all the available TRS feeds in Rational Focal Point applications, one for each workspace.

  1. Select the required workspace's TRS feed from the list, enter an appropriate label, and click Next.
Figure 4. Select the TRS feeds
Data Sources dialog window

Managing Lifecycle Query Engine data sources

Administrative operations such as starting, pausing, and resuming indexing can be performed from Lifecycle Query Engine's administrative console.

You can use the Lifecycle Query Engine's Query tab to run any valid SPARQL query to verify whether appropriate Rational Focal Point data is indexed.

For additional Lifecycle Query Engine administration and configuration actions, select the Administration tab at the top.

  1. In the next window, enter the consumer key and secret that you created while configuring Rational Focal Point as a friend.
  2. Then enter the appropriate Lifecycle Query Engine configuration values in the subsequent pages to finish registering a Focal Point TRS feed as a Lifecycle Query Engine data source.

Query indexed Rational Focal Point linked data

After successful indexing, you can run the sample queries shown in Listings 2 and 3 from the Query tab in Lifecycle Query Engine and verify the results.

Listing 2. SPARQL query to list all of the Rational Focal Point folder elements and their titles
PREFIX fps: <http://jazz.net/ns/psm/focalpoint#>
PREFIX dcterms: <http://purl.org/dc/terms/>

SELECT *
WHERE {
  ?folder a fps:Folder .
  ?folder dcterms:title ?name
}
Listing 3. SPARQL query to list all of the members and their login counts
PREFIX fps: <http://jazz.net/ns/psm/focalpoint#>
PREFIX dcterms: <http://purl.org/dc/terms/>

SELECT *
WHERE {
  ?member a fps:Member .
  ?member fps:numberOfFocalPointLogins ?logins
}

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, DevOps
ArticleID=863709
ArticleTitle=Improve Rational Focal Point queries by using the Lifecycle Query Engine
publish-date=04052013