# Using the Oracle Developer Cloud Service

OEPE includes integration for Oracle Developer Cloud Service, which exposes the most common development tasks from the cloud directly from within the IDE. Oracle Developer Cloud Service is a collection of software and services hosted on the Oracle Cloud. It is a cloud-based software development Platform as a Service (PaaS) and a hosted environment for your application development infrastructure. It provides open-source, standards-based solutions to develop, collaborate, and deploy applications within Oracle Cloud.

Oracle Developer Cloud Service integration with OEPE includes the following:

- A dedicated Oracle Cloud view that displays Oracle Developer Cloud Service projects that you are a member of.

- Integration with Eclipse Mylyn and Oracle Developer Cloud Service Tasks system.

- Source Control System integration with Oracle Developer Cloud Service GIT repository.

- Build node in Oracle Developer Cloud Service that displays the status of Hudson builds.

For more information about the Oracle Developer Cloud Service see, `http://cloud.oracle.com/developer_service`.

## How to Work with Oracle Developer Cloud Service

You can create a connection to Oracle Developer Cloud Service from the Oracle Cloud view, described in How to Create an Oracle Cloud Connection.

After validating credentials, you are logged in to Oracle Developer Cloud Service from OEPE. After you log in, all the projects that are assigned to you are displayed in the Oracle Cloud view, as shown in Figure: Oracle Developer Cloud Service Connection.

Oracle Developer Cloud Service Connection

The Oracle Cloud view displays all your projects, and links to the common features of your service.

You can have multiple Oracle Developer Cloud Service accounts in the Oracle Cloud view. To add another account, create a new connection for the account, as described in How to Create an Oracle Cloud Connection.

The Oracle Cloud view enables you to run the following actions for each project:

- Import projects from Oracle Developer Cloud Service, and push projects to Oracle Developer Cloud Service (see Synchronizing Eclipse Projects with Oracle Developer Cloud Service.)

- Search and manage tasks (see How to Work with Tasks.)

- Monitor builds of your project (see How to Work with Hudson Builds.)

## Synchronizing Eclipse Projects with Oracle Developer Cloud Service

OEPE helps makes it easy for you to push Eclipse projects in the workspace and synchronize them to a remote Git repository. The first time you drag an Eclipse project from the Project Explorer and drop it in the Oracle Cloud view, OEPE performs a number of actions.

- If there are no local Git repositories, OEPE creates a local Git repository and commits the Eclipse projects to the local Git repository. If one or more local Git repositories already exist, drop the project on the Git repository you want to use.

- OEPE pushes the local Git repository to the Oracle Developer Cloud Service Git repository.

- OEPE creates a Maven `pom.xml` build file (if no build files exist) and pushes the Maven jar dependencies into the Oracle Developer Cloud Service project Maven repository.

- OEPE creates Hudson build jobs to automatically build the Eclipse projects in the Oracle Developer Cloud Service project.

The synchronization wizard, shown in Figure: Synchronize Eclipse Projects, allows you to choose whether to create Maven artifacts and specify the Maven group id, and whether to create a Hudson build job.

Synchronize Eclipse Projects

## How to Push a New Project to Oracle Developer Cloud Service

To push a new project to Oracle Cloud Developer Service:

1. Create the new project in Eclipse.

2. Expand the your Oracle Developer Cloud Service project node so that the Git repository is visible.

3. Drag the project onto the Git repository node. This opens the Synchronize dialog.

4. In the synchronize dialog, select the options you want.

   - To use Maven, select Generate or update Maven artifacts for build in Developer Cloud and enter a Maven group id.

   - To create a Hudson build job, select Hudson build job.

5. Click Finish. The project is pushed to Oracle Developer Cloud Service.

## How to Synchronize an Existing Project to Oracle Developer Cloud Service

- After making further changes to your project, right-click the project in the Project Explorer and choose Synchronize with Oracle Cloud.

## How to Import an Oracle Developer Cloud Service Project

Importing a project from Oracle Developer Cloud Service to OEPE Workspace creates a local clone of Oracle Developer Service Git repository. After creating the local Git clone, Eclipse projects in the Oracle Developer Service Git repository appear in the OEPE Workspace.

Eclipse projects contain artifacts checked into Oracle Developer Service Git repository by developers using OEPE as their primary IDE. Other types of project checked into Oracle Developer Service Git repository (for example, JDeveloper projects or Maven projects) do not appear in the OEPE workspace when you create a local clone of the Oracle Developer Service Git repository.

To import a Project from Oracle Developer Cloud Service to OEPE Workspace:

1. In the Oracle Cloud view, expand the project, and select the Git repository from the Source node.

2. Double-click the selected Git repository to clone it to local machine. Alternatively, right-click and choose Activate.

3. Expand the Eclipse Projects node that appears under the Git repository node to view the Eclipse projects in the Oracle Developer Service Git repository that have been imported into the OEPE Workspace.

   Figure: Oracle Developer Cloud Service Connection in section How to Work with Oracle Developer Cloud Service shows an Oracle Developer Cloud Service connection with one Git repository node that has been cloned on the local machine, and other Git repository nodes which have not been cloned.

## How to Work with Tasks

By default, following task queries are available in the Tasks node of Oracle Cloud view:

- All: Lists all tasks of the project

- Mine: Lists all tasks assigned to you

- Open: Lists all open tasks

- Recent: Lists all recently changed tasks

- Related: Lists all tasks related to you

Double-click a query to run it, and then double-click a task to open it in the Task Editor.

You can also perform the following tasks related actions from OEPE:

- Create a new query and import tasks, features, and defects from Oracle Developer Cloud Service

- Update imported tasks from OEPE

- Create local tasks and push them to Oracle Developer Cloud Service

### Creating a Local Task

To create a task:

1. In the Oracle Cloud view expand the project, right-click Tasks and choose New Task.

2. In the New Task dialog, enter details of the task and click Submit. OEPE synchronizes with Oracle Developer Cloud Service, and adds the task to the Open list in the Oracle Cloud view.

Creating a New Task

### Editing Tasks

To view and edit a specific task:

1. Right-click the task in the Oracle Cloud view and choose Open.

2. Update the task, and click Submit. The task is updated in Oracle Developer Cloud Service task repository.

### Synchronizing Tasks

To synchronize tasks with incoming information from Oracle Developer Cloud Service:

1. Right-click the task in the Oracle Cloud view and choose Open.

2. In the menu bar of the task open in the task editor, click . The task is updated in the local task repository.

### Importing Tasks from Oracle Developer Cloud Service With a Custom Query

To import tasks from Oracle Developer Cloud Service, you would need to create a search query. For example, you can create a query to import all open defects assigned to you.

To import tasks with a custom query:

1. Select Tasks node of your project in Oracle Cloud view.

2. Right-click, and choose New Query.

3. In the Oracle Developer Cloud Service Tasks Query dialog, shown in Figure: Creating a Task Query, enter the search criteria.

   For example, if you want to import all open defects assigned to you, enter the name of the query, select your name from the Person list, select Defect as Type, and Assigned as Status.

   Creating a Task Query

4. Click Finish.

All tasks matching the specified criteria are listed in the Oracle Cloud view under the name of the query.

### Synchronizing Tasks with Oracle Developer Cloud Service

To synchronize a task (or a query) between OEPE and Oracle Developer Cloud Service, right-click the task (or the query) in Task List view, and choose Synchronize.

### Associating a Task with a Commit Transaction

If you want to associate a task with a commit transaction, you should activate the task first. To activate a task, select and right-click the task in Task List view, and choose Activate.

OEPE also provides integration with Mylyn. Activating a task enables Mylyn to track which files are related to the current task. Mylyn automatically hides files that are not related to the active task. When committing changes to Git for the Active task, your commit message automatically references the Task ID in Oracle Developer Cloud Service. This effectively creates a link between the code commit and the task allowing for easy traceability. Links between source commits and Tasks are also reflected in the web interface of Oracle Developer Cloud Service.

You can find more information about working with Mylyn Tasks and the Tasks user interface in the Mylyn User Guide at the following URL:

`http://wiki.eclipse.org/Mylyn_User_Guide`

## How to Work with Hudson Builds

To view all jobs of the Hudson builds, expand the Build node of a project in Oracle Cloud view. To perform any action, select the job (or the build) and click Open in Browser. The Builds module of Oracle Developer Cloud Service opens in the web browser. Figure: Builds in Oracle Cloud View shows the Build node in the Oracle Cloud view.

Builds in Oracle Cloud View

### How to Run Hudson Builds

To run a Hudson build:

1. Expand the Build node of a project in Oracle Cloud view.

2. Right-click the build you want to run and choose Run Build.

### How to Monitor Hudson Builds

To view all jobs of the Hudson builds, expand the Build node of a project in Oracle Cloud view. To perform any action, select the job (or the build) and click Open in Browser. The Builds module of Oracle Developer Cloud Service opens in the web browser.