Skip Headers
Oracle® Fusion Middleware Developer's Guide for Oracle SOA Suite
11g Release 1 (11.1.1.5.0)

Part Number E10224-09
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

K Oracle SOA Suite Properties Road Map

This appendix provides an overview of Oracle SOA Suite design time and runtime configuration properties and provides references to documentation that describes how to configure these properties.

This appendix includes the following sections:

K.1 Oracle BPEL Process Manager Deployment Descriptor Properties

Deployment descriptors are BPEL process service component properties used at runtime by Oracle WebLogic Server, Oracle Enterprise Manager, or both. You set these properties during design time in the composite.xml file of the SOA composite application. The types of properties shown in Table K-1 can be set:

Table K-1 Properties for the configurations Deployment Descriptors

Property Name Description

completionPersistPolicy

How to save instance data

disableAsserts

Whether to disable assertions in BPEL 1.1 projects

globalTxMaxRetry

The maximum number of retries for a remote fault

globalTxRetryInterval

The time interval in milliseconds between retries for a remote fault

inMemoryOptimization

In-memory optimization on the instances of a process

keepGlobalVariables

Whether the server can keep global variable values in the instance store when the instance completes

oneWayDeliveryPolicy

The persistence policy of the process in the delivery layer

sensorActionLocation

The location of the sensor action XML file

sensorLocation

The location of the sensor XML file

transaction

The transaction behavior of the BPEL instance for initiating calls

idempotent

An idempotent activity is an activity that can be retried (for example, an assign activity or an invoke activity). The instance is saved after a nonidempotent activity. This property is applicable to both durable and transient processes.

nonBlockingInvoke

Whether to spawn a separate thread to do invocations so that the invoke activity does not block the instance

validateXML

The enabling of message boundary validation


For more information about available deployment descriptor properties, see Section C.1.1, "How to Define Deployment Descriptor Properties" and Chapter 12, "Transaction and Fault Propagation Semantics in BPEL Processes."

K.2 Normalized Message Header Properties

Header manipulation and propagation are key business integration messaging requirements. You can set normalized message header properties during design time in the Properties tab of receive activities, invoke activities, OnMessage branches of pick and (for BPEL 1.1) scope activities, and reply activities. You can set properties for the following components:

For more information, see Appendix H, "Normalized Message Properties."

K.2.1 Oracle JCA Adapter Message Header Properties

Oracle JCA adapters expose the underlying back-end operation-specific properties as header elements and allow for manipulation of these elements within a business process.

For more information about available Oracle JCA adapter message header properties, see the following guides:

K.2.2 Oracle BPEL Process Manager and Oracle Web Services Addressing Message Header Properties

Oracle BPEL Process Manager and Oracle Web Services Addressing rely extensively on header support to solve customers' integration needs.

For more information about available Oracle BPEL Process Manager and Oracle Web Services Addressing message header properties, see Appendix H, "Normalized Message Properties."

K.2.3 Oracle B2B Message Header Properties

In B2B, you can manipulate headers with reserved key words.

For more information about available Oracle B2B message header properties, see Appendix C, “Back-End Applications Interface" of Oracle Fusion Middleware User's Guide for Oracle B2B.

K.3 SOA Composite Application Properties

While most updates you make to the composite.xml file are performed from within the dialogs of the SOA Composite Editor during design time, other properties must be added manually to this file from within Source view. Table K-2 lists these properties and provides references to documentation that describes how to configure these properties.

Table K-2 Oracle SOA Suite Properties

Property Description See...

endpointURI

Specifies multiple partner link endpoint locations. This capability is useful for failover purposes if the first endpoint is down.

Section 8.2.2.8, "Multiple Runtime Endpoint Locations"

oracle.composite.faultPolicyFile

Specifies the location of the fault policy file if it is different from the default location. This option is useful if a fault policy must be used by multiple SOA composite applications.

Section 11.4, "Using the Fault Management Framework"

oracle.composite.faultBindingFile

Specifies the location of the fault binding file if it is different from the default location. This option is useful if a fault policy must be used by multiple SOA composite applications.

Section 11.4, "Using the Fault Management Framework"

passThroughHeader

By default, SOAP headers are not passed through by Oracle Mediator. To pass SOAP headers, add this property to the corresponding Oracle Mediator routing service.

Section 19.2.2.9, "How to Assign Values"

Section 19.2.2.11, "How to Access Headers for Filters and Assignments"

rolesAllowed

Specifies role names required to invoke SOA composite applications from any Java EE application.

Section 35.5, "Specifying Enterprise JavaBeans Roles"

streamIncomingAttachments

and

streamOutgoingAttachments

Specify these properties to stream attachments with SOAP.

Section 42.1.1.2.1, "SOAP with Attachments"

oracle.webservices.local.optimization

Specifies to override a local optimization setting for a policy.

Section 42.1.1.2.1, "SOAP with Attachments"

and

Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite

one.way.returns.fault

Controls how faults and one-way messages are handled for one-way interface SOAP calls.

Section 23.1, "Understanding a One-way Message Exchange Pattern"

mtomThreshold

Specifies the attachment size in bytes.

Section 42.1.1.3, "Adding MTOM Attachments to Web Services"


K.4 Fault Policy and Adapter Rejected Message Properties

A fault policy file defines fault conditions and their corresponding fault recovery actions. Each fault condition specifies a particular fault or group of faults, which it attempts to handle, and the corresponding action for it.

You can also enter additional properties in a fault policy framework file. Table K-3 lists these properties and provides references to documentation that describes how to configure these properties.

Table K-3 Oracle SOA Suite Fault Policy Properties

Property Description See...

retryInterval

Provides a delay between retries of an activity (in seconds).

Section 11.4.1.2, "Creating a Fault Policy File for Automated Fault Recovery"

retryCount

Retries an activity a specified number of times.

Section 11.4.1.2, "Creating a Fault Policy File for Automated Fault Recovery"

org.quartz.scheduler.idleWaitTime

Specifies a time in seconds for the scheduler to wait before retrying.

Section 21.1.1.2, "Actions"


You can also enter adapter rejected message properties in the fault policy framework file during design time.

For more information, see Section "Error Handling" of Oracle Fusion Middleware User's Guide for Technology Adapters.

K.5 Oracle B2B System Properties

You can set most B2B properties on the Configuration tab of the Oracle B2B interface. These settings override property settings performed at Oracle Enterprise Manager Fusion Middleware Control.

For more information about available Oracle B2B properties, see Chapter 15, "Configuring B2B System Parameters" of Oracle Fusion Middleware User's Guide for Oracle B2B.

K.6 Oracle Enterprise Manager Fusion Middleware Control Property Pages

You can configure properties for the following components during runtime in the property pages of Oracle Enterprise Manager Fusion Middleware Control:

K.6.1 SOA Infrastructure Properties

You can configure properties for the SOA Infrastructure. These property settings can apply to all SOA composite applications running in the SOA Infrastructure. The following types of properties can be set:

  • Audit level

  • Composite instance state to capture

  • Payload validation

  • Universal Description, Discovery, and Integration (UDDI) registry

  • Callback server and server URLs

  • Instance and fault count metrics retrieval

  • Java Naming and Directory Interface (JNDI) data source

  • Web service binding properties

For more information about available SOA Infrastructure properties, see Chapter 3, "Configuring the SOA Infrastructure" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.2 Oracle BPEL Process Manager

You can configure BPEL process service engine properties. These properties are used by the BPEL process service engine during processing of BPEL service components. The following types of properties can be set:

  • Audit trail level

  • Audit trail and large document thresholds

  • Dispatcher threads

  • Payload schema validation

  • BPEL monitor and sensor enabling

For more information about available Oracle BPEL Process Manager properties, see Chapter 9, "Configuring BPEL Process Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.3 Human Workflow Notification and Task Service

You can configure human workflow notification and task service properties. These properties are used by the human workflow service engine during processing of human workflow service components. The following types of properties can be set:

  • The notification mode for messages

  • The actionable addresses

  • The actionable e-mail account name

  • The workflow session time out and custom class path URL values

  • The dynamic assignment and task escalation functions of the assignment service

For more information about available human workflow notification and task service properties, see Chapter 18, "Configuring Human Workflow Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.4 Oracle Mediator

You can configure Oracle Mediator properties. These properties are used by the Oracle Mediator service engine during processing of Oracle Mediator service components. The following types of properties can be set:

  • Audit level and metrics level

  • Parallel worker threads

  • Parallel maximum rows retrieved

  • Parallel locker thread sleep and error locker thread sleep

  • Custom configuration parameters

  • Container ID refresh time and container ID lease timeout

  • Resequencer locker thread sleep, maximum groups locked, and worker threads

For more information about available Oracle Mediator properties, see Chapter 14, "Configuring Oracle Mediator Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.5 Cross References

You can configure cross references to dynamically map values for equivalent entities created in different applications.

For more information about available cross reference properties, see Chapter 15, "Managing Cross-References" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.6 Oracle B2B

You can enable Oracle B2B Dynamic Monitoring Service (DMS) metrics.

For more information about available Oracle B2B properties, see Chapter 30, "Configuring Oracle B2B" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.6.7 Service and Reference Binding Component Properties

You can configure the following service and reference binding component properties:

  • Activation specification (for services), interaction specification (for references), and endpoint properties (such as time outs, thresholds, maximum intervals, and others) for the file, FTP, AQ, JMS, socket, database, and MQ Series adapters

  • Web services properties such as enabling REST; enabling the WSDL, metadata exchange, and endpoint of the web service; and others

  • Endpoint reference and service key properties for Oracle Service Registry integration

For more information about available service and reference binding component properties, see Chapter 33, "Configuring Service and Reference Binding Components" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.7 System MBean Browser Properties

The System MBean Browser of Oracle Enterprise Manager Fusion Middleware Control enables you to modify advanced properties that do not display in the property pages described in Section K.6, "Oracle Enterprise Manager Fusion Middleware Control Property Pages." These advanced properties display beneath a link at the bottom of properties pages for the following components:

Note:

In addition to advanced properties, the same properties that display for modifying in the property pages described in Section K.6, "Oracle Enterprise Manager Fusion Middleware Control Property Pages" also display for modifying in the System MBean Browser.

K.7.1 SOA Infrastructure Properties

Click the More SOA Infra Advanced Configuration Properties link at the bottom of the SOA Infrastructure Common Properties page to immediately display System MBean Browser properties for the SOA Infrastructure. Properties that display for modifying include the following:

  • The maximum number of times an invocation exception can be retried

  • The number of seconds between retries for an invocation exception

  • The HTTP proxy authentication realm

  • The HTTP proxy authentication type

  • The HTTP proxy host

  • The password for HTTP proxies that require authentication

  • The HTTP proxy port number

  • The user name for HTTP proxies that require authentication

  • The HTTP protocol URL published as part of the SOAP address of a process in the WSDL file

  • The HTTPS protocol URL published as part of the SOAP address of a process in the WSDL file

  • The path to the Oracle SOA Suite keystore

  • The UDDI endpoint cache life span

For more information about available SOA Infrastructure System MBean Browser properties, see Chapter 3, "Configuring the SOA Infrastructure" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.7.2 Oracle BPEL Process Manager Properties

Click the More BPEL Configuration Properties link at the bottom of the BPEL Service Engine Properties page to display System MBean Browser properties for the BPEL process. Properties that display for modifying include the following:

  • The extra BPEL class path to include when compiling BPEL-generated Java sources

  • The maximum number of times a failed expiration call (wait/onAlarm) is retried before failing

  • The delay between expiration retries

  • The size of the block of instance IDs to allocate from the dehydration store during each fetch

  • The number of invoke messages stored in in-memory cache

  • Whether one-way invocation messages are delivered

  • The size of the most recently processed request list

  • The maximum time a request and response operation takes before timing out

For more information about available Oracle BPEL Process Manager System MBean Browser properties, see Chapter 9, "Configuring BPEL Process Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.7.3 Oracle Mediator Properties

Click the More Mediator Configuration Properties link at the bottom of the Mediator Service Engine Properties page to display System MBean Browser properties for Oracle Mediator. Most of the System MBean Browser properties that display for Oracle Mediator can also be modified on the Mediator Service Engine Properties page.

For more information about available Oracle Mediator System MBean Browser properties, see Chapter 14, "Configuring Oracle Mediator Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.7.4 Human Workflow Notification and Task Service Properties

Click the More Workflow Notification Configuration Properties link at the bottom of the Workflow Notification Properties page or click the More Workflow Taskservice Configuration Properties link at the bottom of the Workflow Task Service Properties page to display System MBean Browser properties for human workflow. Properties that display for modifying include the following:

  • The address at which to receive incoming instant messages (IMs)

  • Whether to return custom notification service property names

  • The return number of configured fax cover pages

For more information about available human workflow notification and task service System MBean Browser properties, see Chapter 18, "Configuring Human Workflow Service Components and Engines" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

K.7.5 Oracle Service Registry WSDL URL Caching Configuration

You can increase the amount of time that the endpoint WSDL URL is available in cache for inquiry by the service key with the UddiCacheLifetime property.

For more information about the UddiCacheLifetime property, see Chapter 33, "Configuring Service and Reference Binding Components" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.