Before you start
Developing applications is a complicated process that can be made easier by using tools from the Rational development suite and following the Rational Unified Process (RUP). These include tools for defining the requirements (IBM Rational RequisitePro), visually modeling the application (IBM Rational XDE) and tools for tracking defects (IBM Rational ClearQuest) and managing changes to the application (IBM Rational ClearCase). To make the process even easier, you can combine the functionality of these individual applications into a single, cohesive, process. Each product has methods for communicating with the other to obtain, update and integrate the necessary information.
In this five-part tutorial series, we're going to look at the integration of these components and how to use them together to manage the application development process from its inception from a client, to the point where bugs and faults need to be traced and tracked through the system after the initial release.
The focus in the first part of the series, is the first stage of the process -- project inception. You're going to be using the Auction system, used as a sample development within WebSphere Studio Application Developer, as the basis of an example. See Prerequisites for more information on how to obtain the auction code and some tutorials for how to produce the system within WebSphere.
The first stage of any development effort is to create the requirements specification that defines the scope of the project. These requirements come from many different places and managing all of this information and merging it together is where RequisitePro fits into the equation. Once you've developed your unified list of requirements, you then need to be able to model your application based on those requirements.
The Rational XDE products provide the methods for application modeling and you can use Rational XDE in combination with RequisitePro to build your application model. The integration between the two products enables you to match application requirements with the components in your model and vice versa, making it easy for all the people involved in the project to understand the approach being used.
This tutorial demonstrates the basics of RequisitePro and Rational XDE and how the two can be linked together to provide an overall picture of requirements for your application, the application model they produce, and how you can monitor changes to requirements and components into the final system.
Key parts of the tutorial include:
- Introduction to the development process
- Developing the Requirements Spec using RequisitePro
- Documenting the project requirements through RequisitePro and Word
- Translating the requirements into an Application Model through XDE
- Tracing model elements back to the Requirements
This tutorial series is primarily targeted for project managers, program managers, and developers. Others in the software development business may also find it useful. In each of the tutorials in this series, you will learn about different Rational tools and the part they play in the software development process. Different team members might be interested in some tutorials more than others, but it is worthwhile to take the complete series from beginning to end to see how all the products work together to form a cohesive process.
This first tutorial focuses on the requirements phase of software development. Anyone involved in gathering and documenting requirements and converting those requirements into models will be most interested in the content covered in this tutorial.
Ideally, you should be familiar with the application development process and be involved in at least one part of the process. Familiarization with Rational tools is also helpful, but is not required.
The focus of this tutorial is on two products in the Rational Suite: RequisitePro and Rational XDE Developer (for Java). Links to download trial copies of these products are below. You will also need Microsoft Word, and optionally Microsoft Project. You might also want to download the Rational Unified Process package, which includes complete documentation on the techniques, methods and systems behind the Rational Unified Process.
Rational XDE Developer trial downloads
Note that you must have the same releases of the tools in order for the integration to work. V2003.06.12 of all the various tools is used in this series.
A demonstration of developing the Online Auction system can be downloaded from the IBM Web site using the following links:
You can also find the code itself supplied as the example with the WebSphere Studio Application Developer, a tool you'll actually be using later in the series. See The Auction application for more details of the auction system and where to obtain the code.

