jdeveloper guide
TRANSCRIPT
Page 1 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
Page 2 of 19
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 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
Page 3 of 19
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
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
Page 4 of 19
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
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.
Page 5 of 19
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
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.
Page 6 of 19
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
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”
Page 7 of 19
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
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
Page 8 of 19
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
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.
Page 9 of 19
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
Page 10 of 19
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
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
Page 11 of 19
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
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)
Page 12 of 19
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
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”
Page 13 of 19
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
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.
Page 14 of 19
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
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
Page 15 of 19
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
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
Page 16 of 19
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
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.
Page 17 of 19
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
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
Page 18 of 19
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
Page 19 of 19