K Oracle SOA Suite Properties Road Map

This appendix describes 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:

Section K.1, "Oracle BPEL Process Manager Deployment Descriptor Properties"
Section K.2, "Normalized Message Header Properties"
Section K.3, "SOA Composite Application Properties"
Section K.4, "Fault Policy and Adapter Rejected Message Properties"
Section K.5, "Oracle B2B System Properties"
Section K.6, "Oracle Enterprise Manager Fusion Middleware Control Property Pages"
Section K.7, "System MBean Browser Properties"

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
`reenableAggregationOnComplete`	The number of instances to create and use to route messages in a BPEL 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 in the Property Inspector" and Chapter 13, "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:

Oracle JCA adapters
Oracle BPEL Process Manager
Oracle Web Services Addressing
Oracle B2B

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:

Appendix A, "Oracle JCA Adapter Properties" of Oracle Fusion Middleware User's Guide for Technology Adapters for file, FTP, AQ, JMS, socket, database, and MQ Series properties
Oracle Fusion Middleware Adapter for Oracle Applications User's Guide for Oracle Applications adapter properties

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 12.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 12.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 20.3.2.10, "How to Assign Values" Section 20.3.2.12, "How to Access Headers for Filters and Assignments"
`rolesAllowed`	Specifies role names required to invoke SOA composite applications from any Java EE application.	Section 38.5, "Specifying Enterprise JavaBeans Roles"
`streamIncomingAttachments` and `streamOutgoingAttachments`	Specify these properties to stream attachments with SOAP.	Section 45.1.1.2.1, "SOAP with Attachments"
`oracle.webservices.local.optimization`	Specifies to override a local optimization setting for a policy.	Section 45.1.1.2.1, "SOAP with Attachments" and Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
`one.way.returns.fault`	Controls how faults and one-way messages are handled for one-way interface SOAP calls.	Section 24.1, "One-way Message Exchange Patterns"
`mtomThreshold`	Specifies the attachment size in bytes.	Section 45.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 12.4.1.2, "Creating a Fault Policy File for Automated Fault Recovery"
`retryCount`	Retries an activity a specified number of times.	Section 12.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 22.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:

SOA Infrastructure
Oracle BPEL Process Manager
Human workflow notification and task service
Oracle Mediator
Cross references
Oracle B2B
Service and reference binding components (JCA adapters, web services, and Oracle Service Registry)

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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management 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:

SOA Infrastructure
Oracle BPEL Process Manager
Oracle Mediator
Human workflow notification and task service
Oracle Service Registry

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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management 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 Business Process Management Suite.