Before you start
IBM® Workplace™ products provide the front-end to IBM's service oriented architecture (SOA) strategy. The IBM Workplace Collaboration Services API Toolkit allows developers to extend the IBM Workplace Collaboration Services platform with new business components, portlets, and other components using the J2EE programming model. The toolkit provides public APIs (Application Programming Interfaces) and SPIs (Service Provider Interfaces) that you can use in your applications. In this tutorial, you explore how to access these extensions via Web Services.
In this tutorial you explore the Web services made available with IBM Workplace Collaboration Services API Toolkit. First, take a look at a simple Web service sample, included with the toolkit. Then, take a look at another sample based on the Application Web Service.
At the completion of this tutorial, you will know how to use Rational® Application Developer to access Web services exposed by the IBM Workplace Collaboration Services Server. Going through this tutorial won't make you an expert in all the Web services provided, but it will give you some background. You can then apply this knowledge with the details in the toolkit documentation to take advantage of these Web services in your applications. The toolkit comes with good documentation that includes both overview and in-depth descriptions. In this tutorial you will also learn how to use Rational Application Developer to minimize your coding efforts by using the Web Services Wizards to generate most of the code required to access these Web services.
This tutorial is written for developers who want to understand how to use Web services to simplify accessing the extension point of the IBM Workplace Collaboration Services. Users should have a basic background in Web services and the Java™ Technology.
It is also recommended that you look through the toolkit documentation to see the different types of extensions that are available through this toolkit. A general understanding of the toolkit will help you gain the most out of this tutorial.
To complete the steps in this tutorial, you will need to have the following software installed:
- IBM Workplace Collaboration Services V2.5.1 Server
- The IBM Workplace Collaboration Services API Toolkit. Install the toolkit over your IBM Workplace Collaboration Services v2.5.1 Server. Follow the installation steps provided in the toolkit documentation.
To obtain the IBM Workplace Collaboration Services API Toolkit, click the link above to display a listing of the IBM Workplace API toolkits available for download. Click "Tool: IBM Workplace Collaboration Services API Toolkit 2.5.1 Dev Files and Documentation for Windows and Linux" and follow the instructions provided to download the toolkit zip file. - Rational Application
Developer 6.0.0.1 with fixpacks 001, 002, and 003 with WebSphere Appserver 5.0 Test Environment.
A trial version of IBM Rational Application Developer is available to download.
You also need to download and unzip the sample code, WebServicesClient.zip, included with this tutorial. This file contains java code needed later in the tutorial. Remember the location where you unzipped the files so you can access them later.


