jdeveloper guide

of 19

Voyager – Configuration Management

JDeveloper ClearCase Remote Client Guide

Version 1.3

EDF Energy plc. Registered in England and Wales. Registered No. 2366852. Registered Office: 40 Grosvenor Place, Victoria, London, SW1X 7EN

edfenergy.com

JDeveloper ClearCse Remote Client GuideVoyager – Configuration Management

DOCUMENT CONTROLRelease History

Version Date Author Comments

1.0 21/06/2011 James Nduka Initial draft

1.1 22/06/2011 James Nduka Updated with changes

1.2 22/06/2011 James NdukaProvided more screenshots, further updates

1.3 22/06/2011Steven Armstrong

Made final revisions

Document Approvers

Approver Role Signature

Steven Armstrong

Document Reviewers

Reviewer Role

Steven Armstrong CM Lead

of 19


edfenergy.com


DOCUMENT CONTROL 21. Introduction 41.1 Description 41.2 Purpose 42. Creating a Snapshot View 43. Connection to ClearCase via the JDeveloper Plug-in 74. Creating a Project in JDeveloper 85. Open an Existing Project 116. Setting an Activity 127. Add To Source Control 168. Checking-out a File 179. Checking In a File 18

1. Introduction

of 19


edfenergy.com


1.1 Description

This document outlines the integration between the Oracle JDeveloper Development environment and the Rational ClearCase repository. This document will provide developers a guideline on creating a snapshot view of their project in the development environment, setting and activity and checking in/out source code.

1.2 Purpose

The purpose of ClearCase Remote Client is to allow developers to seamlessly integrate their development work in JDeveloper with ClearCase.

The Voyager Developers will have the ability associate Deliverable Activities and Defects from ClearQuest to the files in their personal JDeveloper environment during check-in and check-out.

This document is intended for the following audience:

- Voyager Developers, to understand how to use the ClearCase Plug-in with JDeveloper.

- Voyager Team Leads that may need to understand how their developers modify and deliver their work into the development stream

2. Creating a Snapshot View

The first step is for the developer to create a snapshot view of the development stream in ClearCase’s Project Explorer

Start -> All Programs -> IBM Rational ClearCase -> Project Explorer

of 19


edfenergy.com


In the Left hand side under the Voyager _PVOB goto Fusion, expand project to reveal Fusion Integration, expand to reveal Fusion_Dev

Right click on the Fusion_Dev stream and ‘Create View’

Ensure that the box for Create a development view and Type: is Snapshot.

The option to ‘Create an integration view’ should be unchecked.

Developers only need access to the source files under the development stream, this is the stream they will perform their activities and their check-ins and check-outs.

of 19


edfenergy.com


Choose a location on the file system (the recommended practice is to place view root under D:\cc\<view-dev>)

Select no other options and proceed to the next step

Choose the AIA_Artefacts component that will be loaded into your snapshot view (D:\cc\<view-dev>\<dev-vob>\<components>)

By default, all components are selected for loading.

of 19


edfenergy.com


3. Connection to ClearCase via the JDeveloper Plug-in

Open JDeveloper

Navigate to the C drive and access the application via the following path;C:\JDEV\Middleware\jdeveloper

Once JDeveloper has started go to Versioning

Select “Connect to ClearCase”

of 19


edfenergy.com


4. Creating a Project in JDeveloper

In the Application Navigator window click “New Application”

Select the Directory to the View component folder, i.e;C:\cc\<Fusion Dev View>\Fusion\ AIA_Artefacts

Select Generic Application as the project and click OK

of 19


edfenergy.com


In the categories section for the new project select SOA Tier then in the items section and select SOA Project

Provide a name for the project then choose the directory

Click ‘Select’ then ‘Next’.

Select any of the Project Technologies needed then select Finish.

of 19


edfenergy.com


of 19


edfenergy.com


5. Open an Existing Project

Within Application Navigator select Open Application

Select the project file which has the .jws extension

Select the project file that should be located under the viewC:\cc\<Fusion Dev View>\Fusion\ AIA_Artefacts

Select Open

of 19


edfenergy.com


6. Setting an Activity

A developer can view all their deliverables and defects in ClearQuest.

Open ClearQuest for Windows Client

Start -> All Programs -> IBM Rational ClearQuest -> ClearQuest for Windows Client

A developer needs to log in with their Active Directory credentials

Once logged into ClearQuest there is a left pane there are 2 folders (Personal Queries & Public Queries)

of 19


edfenergy.com


Expand the ‘Public Queries’ folder, then expand the ‘Deliverables Activity” folder

Double click the “My Deliverables” query to populate the results of the query

The developer will be able to collect the ID of their Deliverable Activity or Defect via the ID field of the activity

The developer must make note of the ID of the activity

In the view created in Section 2 open the components folder in Windows Explorer

C:\cc\<Fusion Dev View>\Fusion\AIA_Artefacts

There will be a .bat file named “Set_Activity.bat”

of 19


edfenergy.com


Double click the set_activity.bat file and enter the Activity ID taken from the activity noted earlier

Enter the ID then select enter

The Deliverable Activity is set in the view as shown below:

Each Deliverable Activity has a set of files changes associated with it.

of 19


edfenergy.com


Once an activity is set all “checkouts”, “check-ins” and “addition to source control” operations will be associated with the latest activity set. A developer must ensure that they are setting activities for every change and addition.

To change the view to have no current set activity a developer would execute the Unset_Activity.bat found here D:\cc\<Fusion View>\Fusion\AIA_Artefacts

of 19


edfenergy.com


7. Add To Source Control

To add a file into source control create new file for the project in Application Navigator

Right Click on the file and go to Versioning then select Add (This will be associated with the activity which is set in the view)

Select OK

of 19


edfenergy.com


NOTE: Never add class files or JDeveloper generated binary files into source control. Only the source files and project files should be added and checked in to source control

8. Checking-out a File

Right Click on the file in the Application navigator

Select Versioning then select Check Out

Click OK

The green circle besides the file indicates the file has been checked out. When checked out a developer will have the ability to edit the file, once finishing the editing a developer will save the file and then check it in.

of 19


edfenergy.com


9. Checking In a File

Right click on the file in Application Navigator

Select Versioning and Check-in

In the Check-in window, leave the option for “Check in even if Identical” unselected

Click OK

The black symbol beside the file indicates the file has been checked in. A developer will not be able to work on the file until the file has been checked-out

of 19


edfenergy.com


of 19

jdeveloper guide

Documents