1. Developing SOA Applications with Oracle SOA Suite
  2. Getting Started with Oracle SOA Suite
  3. Getting Started with Developing SOA Composite Applications
  4. Creating a SOA Application
  5. Create a SOA Application and Project

Create a SOA Application and Project

  1. Start Oracle JDeveloper Studio Edition.

  2. If Oracle JDeveloper is running for the first time, specify the location for the Java JDK and the user role in which to run Oracle JDeveloper. The JDK version must be later than or equal to 1.7.0_15.

  3. Create a SOA application in any of the following ways:

    • From the File main menu:

      1. Select New > Application.

        The New Gallery opens, where you can select different application components to create.

      2. In the Categories tree, select General > Applications.

      3. In the Items pane, select SOA Application, and click OK.

    • From the Application main menu:

      1. Select New.

        The New Gallery opens, where you can select different application components to create.

      2. In the Categories tree, select General > Applications.

      3. In the Items pane, select SOA Application, and click OK.

    • From the Application menu in the Applications window:

      1. In the Applications window in the upper left, select New Application from the Applications dropdown list.

  4. In the Name your application page, you can optionally change the name and location for your application. If this is your first application, from Application Template, select SOA Application. Accept the defaults for the package prefix, and click Next.

    Note:

    Note the following application naming conventions:

    • Do not create an application name with spaces.

    • Do not create applications and projects in directory paths that have spaces (for example, c:\Program Files).

    • On a UNIX operating system, it is highly recommended that you enable Unicode support by setting the LANG and LC_All environment variables to a locale with the UTF-8 character set. This action enables the operating system to process any character in Unicode. SOA technologies are based on Unicode. If the operating system is configured to use non-UTF-8 encoding, SOA components may function in an unexpected way. For example, a non-ASCII file name can make the file inaccessible and cause an error. Oracle does not support problems caused by operating system constraints.

      In a design-time environment, if you are using Oracle JDeveloper, select Tools > Preferences > Environment > Encoding > UTF-8 to enable Unicode support. This setting is also applicable for runtime environments.

  5. In the Name your project page, you can optionally change the name and location for your SOA project. By default, Oracle JDeveloper adds the SOA project technology, the composite.xml file that describes the SOA composite application, and the necessary libraries to your model project.

  6. Click Next.

    Note:

    Composite and component names cannot exceed 500 characters.

    A project deployed to the same infrastructure must have a unique name across SOA composite applications. The uniqueness of a composite is determined by its project name. For example, do not perform the actions described in Table 2-1. During deployment, the second deployed project (composite) overwrites the first deployed project (composite).

    Table 2-1 Restrictions on Naming a SOA Project

    Create an Application Named... With a SOA Project Named...

    Application1

    Project1

    Application2

    Project1

    The Project SOA Settings page of the Create SOA Application wizard appears.

  7. In the Configure SOA Settings page, click Empty Composite for this example, and click Finish. Table 2-2 describes all of the options on this page.

    Table 2-2 Configure SOA Settings Page

    Element Description

    Empty Composite

    Creates an empty SOA composite application. This type is selected by default.

    Composite With BPEL Process

    Automatically opens the Create BPEL Process dialog to guide you through creation of an initial BPEL process. A BPEL process enables you to design a business process that integrates a series of business activities and services into an end-to-end process flow.

    Composite With Mediator

    Automatically opens the Create Mediator dialog to guide you through creation of an initial Oracle Mediator service component. Oracle Mediator enables you to route events (messages) between different components.

    Composite With Human Task

    Automatically opens the Create Human Task dialog to guide you through creation of an initial human task service component. A human task component enables you to model a workflow that describes the tasks for users or groups to perform as part of an end-to-end business process flow. The tasks are accessed through Oracle BPM Worklist during process runtime.

    Composite With Subprocess

    Automatically creates a SOA composite application with a subprocess. A subprocess is a fragment of BPEL code that can be reused within a particular processor by separate processes.

    Composite With Business Rule

    Automatically opens the Create Business Rules dialog to guide you through creation of an initial business rule service component. A business rule enables you to design a business decision based on rules.

    Composite With Spring

    Automatically opens the Create Spring dialog to guide you through creation of a spring context service component. A spring context service component enables you to integrate components that use Java interfaces instead of WSDL files into SOA composite applications. You can also integrate components that use Java interfaces with components that use WSDL files in the same SOA composite application.

  8. From the File main menu, select Save All.