1. Developing SOA Applications with Oracle SOA Suite
  2. Advanced Topics
  3. Customizing SOA Composite Applications
  4. Creating the Customizable Composite
  5. How to Create the Customizable Composite

How to Create the Customizable Composite

To create the customizable composite:

  1. Start Oracle JDeveloper and select the Default Role.
  2. From the File menu, select New > Applications > SOA Application, and click OK.
  3. Follow the steps in the Create SOA Application wizard.
  4. In the Configure SOA Settings dialog of the Create SOA Application wizard (Step 3 of 3), select both Composite With BPEL Process and the Customizable check box, and click Finish.
  5. Design the BPEL process.

    Note:

    If you design a transformation, note the following customization restrictions in the XSLT Map Editor:

    • The Create in Template option that is displayed by right-clicking a node in the target panel is disabled.

    • The Test XSL Map option is disabled for the call templates and apply templates for imported XSL files. This option works for named templates, but not for template rules with a match attribute.

  6. Customize the BPEL process by creating a scope activity. This action is required because by default the BPEL process is not customizable.

    Note:

    You can only customize the composite.xml file, .bpel file (for Oracle BPEL Process Manager), .xsl map file, and .mplan file (for Oracle Mediator) when logged into Oracle JDeveloper with the Customization Developer role.

  7. Right-click the scope and select Customizable. If you expand the scope and right-click it, you do not see the Customizable option.
  8. In the Applications window, expand Application Resources > Descriptors > ADF META_INF.
  9. Open the adf-config.xml file and select the MDS tab.
  10. Click the Add icon to add the required customization classes, as shown in Figure 53-1.

    In real environments, the customization classes are provided by the core applications team, as described in the example scenario in Introduction to Customizing SOA Composite Applications. When you use your own customization classes, you must add your customization class JAR file to your project to make the classes available for the adf-config.xml file.

    Figure 53-1 Customization Classes

    Description of Figure 53-1 follows
    Description of "Figure 53-1 Customization Classes"
  11. Right-click the SOA project and select Deploy.

    Note:

    You can receive a compilation error if your scope activity is empty. You can drag an empty activity into the scope activity to pass compilation.

  12. On the Deployment Action page, select Generate SAR File. This creates a JAR file package. This JAR is also known as a SOA archive (SAR).
  13. Check the application into a source code control system. The file is now ready for delivery to the vertical applications team.

For information on how to write customization classes, see Developing Fusion Web Applications with Oracle Application Development Framework.