WebLogic Workshop integrates with the IBM Rational ClearCase. Information about ClearCase is available at http://www-306.ibm.com/software/rational/offerings/scm.html. This topic describes how to put your Workshop application under source control with ClearCase.
WebLogic workshop integrates with these ClearCase products: ClearCase, ClearCase MultiSite and ClearCase LT, versions V2003, V2002 and V4.2.
WebLogic Workshop supports integration with ClearCase for a Workshop application and all of its projects, or for an individual project with an application. In either case, all of the files of the Workshop application or project must be associated with a single ClearCase Version Object Base (VOB). This restriction also means that:
It's possible for a single Workshop application to contain multiple projects that are mapped to different VOBs and have separate associated views.
Note: We recommend that you create a snapshot view in ClearCase to map your Workshop project files to the ClearCase VOB. You may encounter unexpected behavior with Workshop if you are using a dynamic view.
To Add Your Workshop Application or Project to ClearCase
After you've configured WebLogic Workshop to integrate with ClearCase, you can add the files in your application or project to ClearCase through the IDE. To add a file, select the file in the Application pane, right-click, and choose ClearCase-->Add or Add and Checkin.
There are some differences between versions of ClearCase in terms of how files and directories are added to source control. These differences are outlined in the following sections:
With ClearCase version V2003, when you add a file to source control, its parent directories are automatically added as elements and checked out. If you add the application or project root directory, the parent of this directory, which is not visible in the Workshop IDE, is automatically checked out. You must use an external ClearCase tool to check this directory back in.
If you execute the Add and Checkin command on a file, the parent directories of the file are automatically checked in.
If you execute the Add and Checkin command on a directory, you must check in the parent directories of that directory manually in order to commit the addition.
With ClearCase version V2002 or earlier, all parent directories must already exist in the VOB and must be checked out before you can add a file that resides in a subdirectory. You must check in all checked out parent directories to commit the operation.
In some situations you will need to use external ClearCase tools, such as ClearCase Explorer or the cleartool utility, to perform certain operations on files in your application or project. These operations include:
The ClearCase Find Checkouts utility may be useful in conjunction with WebLogic Workshop. This utility shows all checkouts in the view, including those that are not visible in WebLogic Workshop, like the parent directory of the root directory of the application or project.
To check out a file from within WebLogic Workshop, right-click on the file in the Application pane and choose ClearCase-->Checkout.
If the file you are checking out is not the latest version in the VOB, you'll see a warning in the checkout dialog. At this point it's recommended that you dismiss the dialog and update the file before continuing. You can also choose to check the file out and merge your changes in with the head version in the VOB when you submit the file.
Note that you cannot check out a file that is writeable.
Once in awhile a ClearCase command may fail to finish executing. If this happens, you can halt the command by right-clicking in the ClearCase window and choosing Stop. Once you've enabled ClearCase integration, the ClearCase window is available by choosing View-->Windows-->ClearCase.
Warning: Use caution when halting executing ClearCase commands, as doing so can have unpredictable or undesirable results.