ShowTable of Contents
This article provides an overview of how to create a Rational Team Concert (RTC) work item from a Lotus Notes database.
It is assumed that your environment includes the following:
- Rational Team Concert Server (18.104.22.168 iFix 3)
- Lotus Notes Client (8.5.1 or later)
Figure 1 is a schematic of the basic architecture, showing the use of the standard RTC API for communication between Lotus Notes and Rational Team Concert.
Figure 1. Basic architecture of the environment
To configure our environment, follow these steps:
1. Add the following two lines in java.policy of Lotus Notes (at end of default permissions, as shown):
permission java.util.logging.LoggingPermission "control";
permission java.lang.RuntimePermission "setContextClassLoader";
2. Restart the Notes client.
3. Unzip the .jar files into folder, Notes\jvm\lib\ext (refer to the attachment, “JazzPlainJavaClient-22.214.171.124iFix3.zip”), and restart the Notes client.
4. Find the sample Notes database with source in the attachment, “create_rtc_wi.nsf”.
The attached Notes database (.nsf) file contains the source with the API to connect to the RTC Server and create work item.
1. Open the database in the Notes client and click the Create Notes Data Document button (see figure 2).
Figure 2. Create Notes Data Document button
2. This action opens “frmNotesData” (see figure 3). Fill in the fields Project Area, Team Area, Summary, Type of Task, Description, and Due Date fields.
3. Click the Create RTC Work Item button.
Figure 3. frmNotesData
4. This opens the form “frmuserdetails”. Enter the User name, password and the RTC server URL (see figure 4).
Figure 4. frmuserdetails
5. When you click OK, the agent “create_rtc_wi” is triggered, and the data is posted on the respective RTC Server. This action take some time as the component tries to establish the connection to RTC Server.
If the action fails, then the logs are stored in the Status / Error Message field (see figure 5). Note that you must click the Refresh button to the see the log for either the success or failure case.
Figure 5. Status / Error Message field
The same attribute values can be seen in the RTC work item, as shown in figure 6.
Figure 6. RTC Work item
In this article you've learned about the API to connect and communicate with an RTC Server from a Lotus Notes environment.
RTC API from jazz.net site:
developerWorks Lotus and Domino product page:
IBM Rational software page:
About the author
Vijayakumar Ramakrishnan joined IBM in 2007 and is currently the Application Architect of the IBM Global Financing (IGF) Notes Development Team that develops/maintains solutions for IGF Lease Management System (LMS) Notes (Australia / New Zealand).