The Jazz Jumpstart Team: Steve Wasleski, Philippe Krief, Steve Speicher, Original Authors
The Jazz Jumpstart Team: Dan Toczala, Technical Focal Point
Last updated: July 22, 2010
Build basis: Rational Team Concert 18.104.22.168
Note: Updated versions of these work shops are available for Rational Team Concert 3.0.
The two workshops downloadable here were initially created and delivered at the IBM/Rational Innovate 2010 User Conference. Participant feedback, and the stream of customer questions regarding OSLC and Rational Team Concert (RTC) Extensibility have convinced us that we need to make this available here on Jazz.net. Both of these workshops work with a similar setup of the RTC SDK, and use the same tar file to populate initial assets for the labs. Section 1 of each guide covers this setup phase.
Note that the “look and feel” of these labs may change if you do them with a different version of RTC, or on a different platform. I was able to do these labs on Linux, with some minor changes for pathnames and a couple of other typical Linux changes.
The OSLC Workshop is usually a good start, as it allows you to get comfortable with the environment, and discover how OSLC can be leveraged to provide robust tool integrations, and how you can create your own customer clients and interfaces to the Jazz.
The Extensibility Workshop is more Java heavy, and shows how you can easily extend and enhance the capabilities of Jazz. While you don’t need to be a Java developer to do this lab, Java development experience is helpful in your ability to understand this workshop. The labs in this workshop explain in some detail what the Java code is doing, so if you are a more experienced Java developer you may wish to skim over these sections.
Both of these workshops require you to use a repository that has been pre-built for helping you understand and work with these concepts. You should remember to download the workshop tar file.
These labs will help guide you to leverage the Open Services for Lifecycle Collaboration (OSLC) standard interfaces for interoperating with IBM Rational Team Concert as well as other Jazz-based products. These labs will highlight key aspects by leveraging web browser access and programmatic access via Java client programs. The final lab will illustrate by an example how to write your own server using Java servlets. After you complete these labs, you will have a good foundation by which to leverage OSLC to implement in an interoperability project.
These labs will help guide you in the creation and enhancement of an RTC process extension. You will be able to quickly define and write a simple extension for the Jazz environment. You will see it working in a debug environment, and be able to test your new extension. You will then enhance the operation of the extension by providing parameters and error checking that will make the extension easier to configure, maintain, and consume.
In order to complete and get the most out of this workshop, it is recommended that you are already familiar with RTC as a user. Of particular help would be familiarity with work items, build definitions and basic process customization. In addition, you should be familiar with Java programming and debugging using Eclipse. Some familiarity with Eclipse plug-in programming would also be helpful but is not strictly required.