Sharing your integration project

WebSphere® Integration Developer provides the capability to develop applications in a team environment by allowing you to share resources with a central repository.

Through Eclipse, WebSphere Integration Developer provides a client for the Concurrent Versions System (CVS). You can also share a project using Rational® ClearCase® or other repositories. For more information about using ClearCase, see Developing applications in the team environment and Working with ClearCase repositories. This topic focuses on sharing a project with a CVS repository. You can also refer to a technical paper on the IBM® developerWorks® site, "Team development with WebSphere Integration Developer and WebSphere Process Server: Developing applications using CVS."

The Business Integration view provides a logical view of the resources in each module, mediation module, and library. Within each project, the resources are categorized by type. Logical resources shown in the navigation tree in the Business Integration view do not necessarily have a one-to-one mapping to physical files. When you use the Team menu options you will notice that the physical files presented in the Synchronize and CVS Repositories views do not directly map to the resources that you see in the Business Integration view. Always work from the Business Integration view when sharing a project or committing changes, so that you share or commit all the necessary resources.

The topics that follow illustrate the basic steps to share a project when working in a team environment. For more information, see Team programming with CVS.

Adding a CVS repository

Before you can share a project with a CVS repository, you need to add the repository to the CVS repositories view. Switch to the CVS Repository Exploring perspective, right-click and select New > Repository Location. In the Add CVS Repository wizard, enter the location, authentication, and connection information. Click Finish.

Sharing a module or library
  1. In the Business Integration view, select the module or library that you want to share, right-click, and select Team > Share project.
  2. In the Share Project wizard, Select CVS as the repository type, and click Next.
  3. Choose to use the existing repository connection that you created previously and click Next.
  4. Choose to use the project name as the module name and click Next.
  5. The next page shows you the project that is to be shared. Expand the project to view the physical files within it. The decorator showing an arrow with a plus sign indicates that the file is new, and does not exist on the server. Select the project and click Finish. A version of the module including all its resources will be created in the shared repository.
    Share project page showing all new resources in a module

Committing changes

Now let’s suppose we have made some changes to our shared module, DataMergeModule. In the assembly diagram, we added a BPEL process named TransferFromBrokerageToBankProcess and connected it to two new Java™ components. The Java components are implemented as Component1Impl and Component2Impl. After the assembly diagram is saved, the Business Integration view shows a > decorator beside the changed resources, as shown below:


Business Integration view showing changed resources

Before committing our resources, we can synchronize the project with the repository to see the resources that have changed in the local workspace and in the repository. Select the project, right-click and select Team> Synchronize with Repository. The Synchronize view shows the physical files in the module. Change decorators indicate the changed files. The image below shows DataMergeModule in the Synchronize view, and the arrows with the plus signs indicate the changes that we made.


Synchronize view showing local changes

Switch to the Physical Resources view. This view also shows the changed physical files, indicated by a > decorator.


Physical Resources view showing local changes

To commit your changes, work from the Business Integration view. Select the module, right-click, and select Team > Commit.

Checking out a project from the shared repository

Before you check out a project, synchronize it to view changes that another team member may have made to the server version of the project. Select the project from the Business Integration view, right-click, and select Team > Synchronize. The left facing arrow beside a file shows that it has changed in the shared repository.


Synchronize view showing file changed in remote repository

To check out a project, switch to the CVS Repositories view, select the project, right-click and select Check Out

Comparing files

To view the difference between the local and remote files, you can open the files in the Compare editor. In the Synchronize view, select a file, right-click and choose Open in Compare Editor. The remote and local files will open in a text editor, with the changes highlighted. .

Related concepts
Best practices: Sharing projects
Working with ClearCase repositories

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.