Viewing Services and References Accessing Oracle B2B Reports from the Oracle B2B Composite Flow Trace Page

32-8 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Part XIV Administering Binding Components This part describes how to administer binding components. This part includes the following chapters: ■ Chapter 33, Configuring Service and Reference Binding Components ■ Chapter 34, Monitoring Service and Reference Binding Components ■ Chapter 35, Managing Service and Reference Binding Components 33 Configuring Service and Reference Binding Components 33-1 33 Configuring Service and Reference Binding Components This chapter describes how to configure properties for web service and JCA adapter service and reference binding components that are included in SOA composite applications. Binding components are network protocols and services that connect the SOA platform with the outside world. This chapter includes the following topic: ■ Section 33.1, Configuring Service and Reference Binding Component Properties For more information about binding components, see the following documentation: ■ Section 1.2.5, Introduction to Binding Components ■ Oracle Fusion Middleware Developers Guide for Oracle SOA Suite

33.1 Configuring Service and Reference Binding Component Properties

You can configure message header properties for the service and reference binding components included in a deployed SOA composite application. To configure service and reference binding component properties: 1. Access this page through one of the following options: Notes: ■ You cannot configure message header properties for direct binding components that invoke a SOA composite application through a remote RMI call. For this reason, the Properties tab does not display for direct binding components. ■ You cannot change the httpBinding property for the HTTP binding component. ■ Support is provided for adding MTOM attachments to web services. For more information, see Oracle Fusion Middleware Developers Guide for Oracle SOA Suite. 33-2 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The following binding component properties appear for a web service. The following binding component properties appear for a file adapter. Depending upon your selection of JCA adapter, different parameters display for configuring.

2. Change properties based on your selection of binding component. See sections

Section 33.1.1, Configuring Properties for Web Services and Section 33.1.2, Configuring Properties for Oracle JCA Adapters for available properties. From the SOA Infrastructure Menu... From the SOA Folder in the Navigator... From the SOA Composite Menu... 1. Select Services and References . 2. Select a specific service or reference. 3. Click the Properties tab. 1. Right-click soa-infra. 2. Select Services and References . 3. Select a specific service or reference. 4. Click the Properties tab. 1. Select ServicesReference Properties . 2. Select a specific service or reference. 3. Click the Properties tab. Configuring Service and Reference Binding Components 33-3

33.1.1 Configuring Properties for Web Services

Table 33–1 describes the properties available for a web service binding component. Note: To see adapter header properties and their values on this page, ensure that you change the value of the Audit Level property from Production the default to Development in the SOA Infrastructure Common Properties page. If this property is set to Production, the properties and their values do not display. Table 33–1 Web Service Properties Service, Reference, or Endpoint Property Name Description Service REST Enabled Enable or disable the web services port to accept messages in Representational State Transfer REST format. Service WSDL Enabled Enable or disable the WSDL of the web service. Service Metadata Exchange Enabled Enable or disable a metadata exchange of the web service. Service Endpoint Test Enabled Enable or disable an endpoint test of the web service. Service Logging Level Select the level of logging to perform on the web service. Service Schema Validation Enable or disable schema validation. Service Atomic Transaction Version Select the WS-AtomicTransaction WS-AT supported version 1.0, 1,1, 1,2, or default. Service Atomic Transaction Flow Option Select the transaction participation value: ■ Never No transaction context is imported for services or exported for references. ■ Supports If a transaction exists, a transaction context is imported for services or exported for references. This information is added to the composite.xml file. ■ Mandatory A transaction context is imported for services or exported for references. For exports, a web service exception message is thrown if there is no active transaction. For imports, a fault is returned to the client if there is no transaction context in the request. Service Maximum Request Size Enter the maximum request size of the web service. A value of -1 indicates the size is unlimited. Service Unit of Maximum Request Size Select the request unit of the web service either bytes, kilobytes, megabytes, or gigabytes. 33-4 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

33.1.2 Configuring Properties for Oracle JCA Adapters

Note that if you manually add a nonregistered JCA binding level property in the composite.xml file, then you cannot subsequently edit that property or also any other registered properties for that service or reference through Oracle Enterprise Manager Fusion Middleware Control. Table 33–2 describes the JCA adapter property types. This section includes the following topics: ■ Section 33.1.2.1, Oracle AQ Adapter ■ Section 33.1.2.2, Oracle Database Adapter ■ Section 33.1.2.3, Oracle File Adapter ■ Section 33.1.2.4, Oracle FTP Adapter ■ Section 33.1.2.5, Oracle JMS Adapter ■ Section 33.1.2.6, Oracle MQ Series Adapter ■ Section 33.1.2.7, Oracle Socket Adapter ■ Section 33.1.2.8, Oracle JCA Adapters Endpoint Properties

33.1.2.1 Oracle AQ Adapter

Table 33–3 describes the properties available for the Oracle AQ Adapter. Table 33–2 Types of JCA Adapters Property Type Description Restrictions Activation specification and interaction specification Activation specification properties operate as services and interaction specification properties operate as references in a SOA composite application. Do not add or remove these properties. You can only change their values. These properties require the adapter endpoint to be recycled. These types of properties are also dependent upon other properties. If you attempt to add one of these properties, you have no way of knowing which dependent properties must also be added. Endpoint These are tuning-related properties that are not exposed through the activation or interaction specification properties, such as specifying time outs, thresholds, maximum intervals, and so on. There are no restrictions on adding, removing, or changing endpoint properties. The adapter is notified when these properties are added, removed, or changed, but it does not require redeployment. Note that you cannot add or remove jca.retry. endpoint properties without redeploying the composite. However, you can change these properties by using Oracle Enterprise Manager Fusion Middleware Control without redeploying the composite. Table 33–3 Oracle AQ Adapter Properties Service, Reference, or Endpoint Property Name Description Service DequeueTimeOut Sets the dequeue timeout interval. Service ConnectionRetryDelay Sets the connection retry interval. Service adapter.aq.dequeue.threads The number of dequeue threads. Configuring Service and Reference Binding Components 33-5

33.1.2.2 Oracle Database Adapter

Table 33–4 describes the properties available for the Oracle Database adapter. Service jca.retry.count The number of retries to post the message. Service jca.retry.interval The time interval between message retries. Service QueueName Indicates the AQ queue name. Service DatabaseSchema Database schema name that hosts the queue. Service SchemaValidation Validates the message payload. Service ObjectFieldName Specifies the ADT entry used as a payload. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Service PayloadHeaderRequired Specifies if the ADT entries, except for the payload, are accessible. Service DequeueCondition Specifies the expression to dequeue messages. Service Consumer Specifies the consumer of a queue. Service MessageSelectorRule Specifies the message selector to dequeue messages. Service StreamPayload Specifies if the payload is streamed or not. Service Correlation Specifies a correlation criterion or search criterion for the dequeue operation. For the enqueue operation, the value becomes the correlation of the message sent to AQ. Reference Username Identifies a user name requesting access to a secure environment or program, such as an Oracle database or Oracle applications system. Reference Responsibility Specifies a collection of functions within Oracle E-Business Suite. Each user is assigned one or more responsibilities to allow access to the appropriate functions and data. Reference QueueName Indicates an AQ queue name. Reference DatabaseSchema Indicates the database schema name that hosts the queue. Reference ObjectFieldName Specify the ADT entry to use as a payload. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference PayloadHeaderRequired Specify if ADT entries, except for the payload, are accessible. Reference RecipientList Specify recipient of the messages. Reference Correlation Specifies a correlation criterion or search criterion for the dequeue operation. For the enqueue operation, the value becomes the correlation of the message sent to AQ. Table 33–3 Cont. Oracle AQ Adapter Properties Service, Reference, or Endpoint Property Name Description