OSLC Workshop and Jazz Extensions Workshop

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 2.0.0.2

Note: This training material is an evolving document and incremental improvements will be published on a regular basis. Feedback is welcome. Please direct your comments, questions, and suggestions to Dan Toczala (dtoczala@us.ibm.com).

Introduction

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.  If you decide to do both of these workshops, then you can skip the setup phase in Lab 1 of the second workshop (because they are identical, and you will have already established your environment).  

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.  

OSLC Workshop: Consumer and Producer Labs

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.

Remember that you can always find addtional information on OSLC at the OSLC Home Webpage, and also at Jazz.net.

Use this link to download the OSLC Workshop: Consumer and Producer Labs.

IBM Rational Team Concert Extensibility Workshop

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.

Use this link to download the IBM Rational Team Concert Extensibility Workshop.