Essentials Of Rational Clearcase Appendix A: Using Rational Clearcase Within Websphere Studio Application Developer

®

IBM Software Group

Essentials of Rational ClearCase Appendix A: Using Rational ClearCase Within WebSphere Studio Application Developer

1

Objectives When you complete this module, you should be able to:  Set up your WebSphere Studio Application Developer and ClearCase work area  Create or import projects under ClearCase control in Application Developer  Perform ClearCase functions from within Application Developer

2

WebSphere Studio/ClearCase Terms: View WebSphere Studio

ClearCase

• Views offer alternative presentations of information in your workbench.

• A view is a ClearCase mechanism that lets you access particular versions of elements in a VOB.

3

WebSphere Studio/ClearCase Terms: Project WebSphere Studio

ClearCase

• A project is the top level of organization of your resources in the workbench.

• A project is a UCM object that contains configurations and policies relating to a development effort.

4

WebSphere Studio/ClearCase Terms: Workspace WebSphere Studio

ClearCase

• The workspace is the collection of projects and resources you are currently developing in the workbench.

• The workspace in base ClearCase is a ClearCase view. • The workspace in ClearCase UCM is an isolated work area that includes a development view and a development stream.

• Contains metadata that describe resources in the workspace.

5

Application Developer and ClearCase Workflow Set up work area • Create a ClearCase view • Create a WebSphere Studio workspace

Create or import a WebSphere Studio project

Work on files within Application Developer

Integrate changes 6

Create a ClearCase View

For snapshot view, select elements to load into the view.

In ClearCase Explorer, create a view for your development work.

7

Create a WebSphere Studio Workspace

 WebSphere Studio workspace stores project metadata  Maintain a separate WebSphere Studio workspace for each ClearCase view that you use  Include the view name (view tag) in the directory name of the WebSphere Studio workspace

8

Create a New Project under ClearCase Control File > New > Project 2 Name the project.

1 Select the type of project to create.

3 Clear the Use default check box and place the project in a directory under a ClearCase VOB root directory, within a ClearCase view.

9

Create a New Project under ClearCase Control (cont.) 4 When prompted, click OK to add elements to source control.

10

Accessing ClearCase Functions ClearCase Toolbar

11

Accessing ClearCase Functions (cont.) ClearCase Menu

12

Accessing ClearCase Functions (cont.) Team Menu

13

ClearCase Icon Decorations Blue pane indicates items under ClearCase source control. Green checkmark indicates an item is checked out.

Green checkmark with red slash indicates a hijacked file.

14

Work on Files: Add New File When you create new files and directories within a source controlled project, ClearCase prompts you to add them to source control.

15

Work on Files: Check Out and Check In

By default, ClearCase prompts you to check out any file you try to edit without first checking it out.

16

Work on Files: Refactoring To rename Host.java to HostData.java, click File > Refactor > Rename.

ClearCase automatically checks out the files that are changed. ClearCase automatically updates references to the renamed class. 17

Working on Files: Refactoring (cont.)

When you refactor, ClearCase creates a new version of the renamed element’s parent directory.

18

Integrate Your Changes To merge your changes, click ClearCase > Run Merge Manager.

19

Setting Preferences Window > Preferences

20

Accessing Help Help > Help Contents > Rational ClearCase

21

Module Review 1.

What is the recommended relationship between WebSphere Studio workspaces and ClearCase views?

2.

In Application Developer, how do you create a new project that is under ClearCase control?

3.

In Application Developer, what happens when you try to edit a file under ClearCase source control without first checking it out?

4.

How can you change the default behavior of ClearCase in Application Developer to automatically check in parent directories of renamed files?

22

Lab  In this lab, you will create a WebSphere Studio project that is under ClearCase control and perform ClearCase tasks from within WebSphere Studio Application Developer

23

24