This chapter describes how to configure 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. You can configure message header properties for Web service binding components or JCA adapter binding components.
This chapter includes the following topic:
See Also:
The following documentation for binding component concepts: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:
Access this page through one of the following options:
From the SOA Infrastructure Menu... | From the SOA Folder in the Navigator... | From the SOA Composite Menu... |
---|---|---|
|
|
|
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.
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.
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 describes the properties available for a Web service binding component.
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 |
Maximum Request Size |
Enter the maximum request size of the Web service. A value of |
Service |
Unit of Maximum Request Size |
Select the request unit of the Web service (either bytes, kilobytes, megabytes, or gigabytes). |
Note that if you manually add a non-registered 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 the Oracle Enterprise Manager Console.
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 |
This section includes the following topics:
Table 33-3 describes the properties available for the Oracle AQ Adapter.
Table 33-3 Oracle AQ Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
Sets the dequeue timeout interval. |
Service |
|
Sets the connection retry interval. |
Service |
|
Number of dequeue threads. |
Service |
|
Number of retries to post the message. |
Service |
|
Time interval between message retries. |
|
|
Indicates the AQ queue name. |
|
|
Database schema name that hosts the queue. |
|
|
Validates the message payload. |
|
|
Specifies ADT entry used as a payload. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
|
|
Specifies if ADT entries except for payload are accessible. |
|
|
Specifies the expression to dequeue messages. |
|
|
Specifies the consumer of a queue. |
|
|
Specifies the message selector to dequeue messages. |
|
|
Specifies if payload is streamed or not. |
|
|
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 |
|
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 |
|
Indicates an AQ queue name. |
Reference |
|
Indicates the Database schema name that hosts the queue. |
Reference |
|
Specify the ADT entry that will be used as a payload. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Specify if ADT entries except for payload is accessible. |
Reference |
|
Specify recipient of the messages. |
Reference |
|
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-4 describes the properties available for the Oracle Database Adapter.
Table 33-4 Oracle Database Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
The key into the TopLink metadata indicating the root relational table. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
The key into the TopLink metadata indicating the named query to execute, with predefined where clause and parameters. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
In conjunction with Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
Indicates the path to the TopLink metadata file which describes how a database schema has been mapped to an XML schema. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
In conjunction with Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
Indicates the number of seconds between queries to the database for new events. |
Service |
|
Indicates the maximum number of XML records that can be raised at a time to Oracle BPEL Process Manager or the activation listener. |
Service |
|
Indicates the method in which events are raised from the database. Also known as Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
Indicates status column used by LogicalDeletePollingStrategy, for indicating which rows have been processed. |
Service |
|
The status of unprocessed rows. |
Service |
|
The status of rows reserved by this polling instance. |
Service |
|
The status of processed rows. |
Service |
|
For example, the |
Service |
|
For example, TABLE_NAME. This column holds the primary keys of the various sequences stored. |
Service |
|
For example, LAST_READ_ID. This is the column that holds the value of the last processed sequence value. |
Service |
|
For example, SCOTT.EMP.EMP_ID. This is the monotonically increasing column on the polled table. |
Service |
|
For example, the |
Service |
|
For example, the |
Service |
|
For |
Service |
|
For |
Service |
|
For the delete polling strategy, this indicates whether to delete detail rows and master rows after XML records have been read. |
Service |
|
For |
Service |
|
For |
Service |
|
Deletes or updates multiple processed rows with a single Data Manipulation Language (DML) statement. |
Service |
|
Indicates whether to delay the commit/destroy action until all rows picked up (across multiple |
Service |
|
Indicates whether an update to a detail row must result in the master row and all its details being picked up for processing. |
Service |
|
For |
Service |
|
Indicates the number of transactional threads to be used by the database adapter. |
Service |
|
Indicates the JDBC level cursor fetch size. |
Service |
|
Indicates the JDBC level statements per batch statement. |
Service |
|
Indicates the JDBC level delete while iterating over ResultSet. |
Service |
|
Enables performance optimization in certain cases. |
Service |
|
Reads from multiple joined tables in a single SQL select rather than many and returns a single giant result set. |
Service |
|
Maximum number of rows to raise as part of one database transaction. |
Service |
|
For FileSequencingPollingStrategy only. The file contains a single value, the last read sequence value / updated time. Timestamps appear in ISO format. |
Service |
|
Validates the xml against the xml schema before raising it. Can only happen if the auto-generated has been hand-edited, that is, to add restrictions. Invalid records are rejected. |
Service |
|
Allows LOBs and multi-record XML files to be streamed through SAX events, allowing only a small part of payload to be kept in memory at a time. |
Reference |
|
The key into the TopLink metadata indicating the root relational table. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates if this interaction execution have an output message that is the input message with primary keys set. |
Reference |
|
The path to the Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
In conjunction with Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Operations within the same JTA transaction use the same TopLink Session and connection, and writes occur together on JTA commit. |
Reference |
|
Indicates the type of Data Modify Language (DML) operation (merge, insert, update, delete, write). |
Reference |
|
Does this interaction execute have an output message which is the input message with primary keys set. Useful when assigning primary keys on insert. |
Reference |
|
Sets some properties to improve performance of the merge. For one, if multiple objects are merged, the read queries to check existence and load database versions into memory for comparison are performed as a single query, using an |
Reference |
|
Indicates whether to differentiate between null and not there in the input XML. The difference between |
Reference |
|
The JDBC level statements per batch statement. |
Reference |
|
Enables performance optimization in certain cases. |
Reference |
|
The key into the TopLink metadata indicating the named query to execute, with predefined where clause and parameters. |
Reference |
|
The query is generated dynamically on each invoke, based on matching the example input xml record. |
Reference |
|
An advanced feature that influences how many total selects TopLink uses when querying against multiple related tables (that is, Master-Detail). Safest is the default (1 per table); setting to true that attempts 1 total, by outer joining all related selects into a single result set. |
Reference |
|
How many records to return at a time when selecting a huge number of rows in a single query. |
Reference |
|
Allows LOBs and multi-record XMLs to be streamed through SAX events, allowing only a small part of payload to be kept in memory at a time. |
Reference |
|
The SQL to execute in the pure SQL interaction. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates whether the pure SQL being executed is a write that must occur within transaction boundaries. |
Reference |
|
Indicates the JDBC level Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates the JDBC level Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
The schema of the stored procedure to execute. |
Reference |
|
The package of the stored procedure to execute. |
Reference |
|
The procedure of the stored procedure to execute. |
Reference |
|
Further identifies the stored procedure to execute (in case of overloading) by the expected number of parameters. |
Reference |
|
Indicates the JDBC level queryTimeout setting. |
Table 33-5 describes the properties available for the Oracle File Adapter.
Table 33-5 Oracle File Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
Specifies the physical directory for the File/FTP adapter. |
Service |
|
Set to |
Service |
|
If set to |
Service |
|
Directory where the inbound File/FTP adapter archives files after they have been processed successfully. |
Service |
|
Indicates the directory where the inbound File/FTP adapter archives files in case of failures, such as translation errors, and errors during publish. |
Service |
|
If set to true, the File/FTP adapter deletes the file after it has been processed. |
Service |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is processed by the File/FTP adapter. |
Service |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the File/FTP adapter. |
Service |
|
This parameter specifies how often does the File/FTP adapter wake up to look for files in the inbound directory. It is specified in seconds. |
Service |
|
This parameter specifies the time interval after which a file should be picked up for processing. For example, this enables a large file to be completely copied into the directory before it is retrieved for processing. The age is determined by the last modified time stamp. For example, if you know that it takes three to four minutes for a file to be written, set the minimum age of pollable files to five minutes. If a file is detected in the input directory and its modification time is less than 5 minutes older than the current time, the file is not retrieved because it is still potentially being written to. |
Service |
|
This parameter indicates that a file contains multiple messages and specifies how many messages should be processed simultaneously. For example, if a certain file has 11 records and this parameter is set to 2, then the file is processed 2 records at a time and the final record is processed in the 6th iteration. |
Service |
|
If set to true, then the File Adapter does not complain if it does not have enough permission to read/write to the inbound directory. By default, this is set to false. |
Service |
|
The directory path where the File/FTP adapter looks for the trigger files. |
Service |
|
The name of the trigger file that causes the inbound File/FTP adapter to activate. |
Service |
|
This parameter defines the strategy that the File/FTP adapter uses to look for the specified trigger file in trigger file directory. The acceptable values are EndpointActivation, EveryTime or OnceOnly. |
Service |
|
This parameter specifies the maximum number of files that the File/FTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the File/FTP adapter submits 100 files every minute. |
Service |
|
This parameter specifies if the File/FTP adapter inbound directory is being polled in a distributed fashion. In other words, there are multiple process polling the same directory in one or more managed servers. |
Service |
|
When you choose multiple directories, the generated JCA files use \";\" as the separator for these directories. However, if you want, you can change the separator to something else. If you do so, manually add |
Service |
|
If set to true, it causes the inbound file to be published as an attachment. |
Service |
|
Set it to the Character Set for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Set it to the Encoding for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Set it to the Mime-Type for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Specifies the sorter that the File/FTP adapter use to sort files in the inbound. You can set this parameter to |
Service |
|
If the value is true, the File/FTP adapter poller processes files in the same thread. In other words, it does not use the global in-memory queue for processing. |
Service |
|
If this parameter is available, the adapter creates it's own processor threads rather than depending on the global thread pool processor threads (by default 4 of them). In other words, this parameter partitions the in-memory queue and each composite application gets its own in-memory queue. If the |
Service |
|
Used by the inbound adapter to configure the recoveryInterval in case of errors. For example, if the PhysicalDirectory is non-existent, then the adapter uses this value to perform periodic sleep/wakeups to check if the PhysicalDirectory has been created and is accessible. |
Reference |
|
Specifies the physical directory for the file/FTP adapter. |
Reference |
|
Specifies the outbound file naming convention used. |
Reference |
|
This parameter is used for outbound batching. When the time specified elapses, the outgoing file is created. The parameter is of type String and is not mandatory. The default value is 1. |
Reference |
|
Indicates if an opaque schema is being used. |
Reference |
|
This parameter is for the naming convention for the outbound write operation file. |
Reference |
|
Use this parameter to specify a static single file name during the write operation. |
Reference |
|
Setting this parameter to \"true\" causes the File/FTP adapter to append to a file on the outbound. If the file does not exist, a new file is created. |
Reference |
|
If \"true\", then the outbound File/FTP adapter writes translated data to a staging file and afterward it streams the staging file to the target file. If \"false\", then the outbound File/FTP adapter does not use an intermediate staging file. |
Reference |
|
The maximum number of translation activities that can be allowed to execute in parallel for a particular outbound scenario. The translation step during the outbound operation is CPU intensive and hence must to be guarded as it might cause starvation in other applications/threads. The max is 100 (same as the max for |
Reference |
|
Specifies the Oracle database sequence name to be used if you have already configured the outbound File/FTP adapter for high availability. |
Reference |
|
Set it to the class name that specifies the mutex you want to use for the outbound write operation. This class must extend the " |
Reference |
|
If set to \"true\", then the translation step is serialized using a semaphore. The number of permits for semaphore (guarding the translation step) comes from |
Reference |
|
This parameter is applicable only if |
Reference |
|
If set to \"true\", the File/FTP adapter deletes the file after it has been processed. |
Reference |
|
Set it to true if you do not want the File/FTP adapter to throw an exception during the outbound read operation if the file could not be found. This parameter is ignored if the schema for the inbound file is anything other than "Opaque". |
Reference |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is processed by the File/FTP adapter. |
Reference |
|
Includes the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the File/FTP adapter. |
Reference |
|
If set to "true", the File/FTP adapter processes files recursively in sub-directories. |
Reference |
|
This parameter specifies the maximum number of files that the File/FTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the File/FTP adapter submits 100 files every minute. |
Reference |
|
When you choose multiple directories, the generated JCA files use \";\" as the separator for these directories. However, if you want, you can change the separator to something else. If you do so, manually add |
Reference |
|
The source file for the File I/O operation. |
Reference |
|
The source directory for the File I/O operation. |
Reference |
|
Set this to \"native\" if the source file is native and \"xml\" if the source file is XML. |
Reference |
|
Set it to the schema for the source file. |
Reference |
|
Set it to the root element name for the source file. |
Reference |
|
Indicates the target file for the File I/O operation. |
Reference |
|
Indicates the target directory for the File I/O operation. |
Reference |
|
Set this to \"native\" if the target file is native and \"xml\" if the source file is XML. |
Reference |
|
Set it to the schema for the target file. |
Reference |
|
Set it to the root element name for the target file. |
Reference |
|
Set it to the XSL transformer between the source and target. |
Reference |
|
Set it \" |
Reference |
|
Set it to the batch size for the batching transformation. |
Reference |
|
Specifies the number of outbound messages. |
Table 33-6 describes the properties available for the Oracle FTP Adapter.
Table 33-6 Oracle FTP Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
This parameter is used by the FTP adapter to tackle time zone issues, typically to convert the time difference between the ftp server and the system on which the ftp adapter is running to millisecond. |
Service |
|
This parameter specifies the physical directory for the File/FTP adapter. |
Service |
|
Set to \"true\" if the File/FTP adapter must publish metadata, for example, file name, directory name, last modified data, file size and exclude the payload. This is typically used in large payload scenarios where-in you simply want to use the inbound adapter as a notifier. |
Service |
|
Set it to either \"ascii\" or \"binary\" depending on the requirement. |
Service |
|
If set to \"true\", the File/FTP adapter processes files recursively in sub-directories. |
Service |
|
Directory where the inbound File/FTP adapter archives files after they have been processed successfully. |
Service |
|
Indicates the directory where the inbound File/FTP adapter archives files in case of failures, such as translation errors, and errors during publish. |
Service |
|
Set this parameter to \"true\" to notify the FTP adapter that the archival directory is on the same FTP server. If set to \"false\", the FTP adapter uses a local file system folder for archival. |
Service |
|
Set this parameter to \"true\" if you need the FTP Adapter to use \"NLST\" FTP command instead of \"LIST\" that the adapter uses by default. |
Service |
|
If set to \"true\", the File/FTP adapter deletes the file after it has been processed. |
Service |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is processed by the File/FTP adapter. |
Service |
|
Indicates the Regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the File/FTP adapter. |
Service |
|
This parameter specifies how often does the File/FTP adapter wake up to look for files in the inbound directory. It is specified in seconds. |
Service |
|
This parameter specifies the time interval after which a file should be picked up for processing. For example, this enables a large file to be completely copied into the directory before it is retrieved for processing. The age is determined by the last modified time stamp. For example, if you know that it takes three to four minutes for a file to be written, set the minimum age of pollable files to five minutes. If a file is detected in the input directory and its modification time is less than 5 minutes older than the current time, the file is not retrieved because it is still potentially being written to. |
Service |
|
This parameter indicates that a file contains multiple messages and specifies how many messages should be processed simultaneously. For example, if a certain file has 11 records and this parameter is set to 2, then the file is processed 2 records at a time and the final record is processed in the 6th iteration. |
Service |
|
The directory path where the File/FTP adapter looks for the trigger files. |
Service |
|
The name of the trigger file that causes the inbound File/FTP adapter to activate. |
Service |
|
This parameter defines the strategy that the File/FTP adapter uses to look for the specified trigger file in trigger file directory. The acceptable values are |
Service |
|
This parameter specifies the maximum number of files that the File/FTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the File/FTP adapter submits 100 files every minute. |
Service |
|
This parameter specifies if the File/FTP adapter inbound directory is being polled in a distrusted fashion. In other words, there are multiple process polling the same directory in one or more managed servers. |
Service |
|
When you choose multiple directories, the generated JCA files use \";\" as the separator for these directories. However, if you want, you can change the separator to something else. If you do so, manually add |
Service |
|
If set to \"true\", it causes the inbound file to be published as an attachment. |
Service |
|
Set it to the Character Set for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Set it to the Encoding for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Set it to the Mime-Type for the attachment. This parameter is not used internally by the File/FTP adapter and it is meant for third party applications that process the attachments published by the File/FTP adapter. |
Service |
|
Specifies the sorter that the File/FTP adapter use to sort files in the inbound. You can set this parameter to \" |
Service |
|
If the value is true, the File/FTP adapter poller processes files in the same thread. In other words, it does not use the global in-memory queue for processing. |
Service |
|
If this parameter is available, the adapter creates it's own processor threads rather than depending on the global thread pool processor threads (by default 4 of them). In other words, this parameter partitions the in-memory queue and each composite application gets its own in-memory queue. If the |
Service |
|
Used by the inbound adapter to configure the |
Service |
j |
This parameter is used to override the encoding specified in the NXSD schema for the inbound File/FTP adapter. |
Service |
|
This property lets you control the size of a rejected message for the inbound File/FTP adapter partner link. For example, if you set it to \"100\", it causes the File/FTP adapter to reject 100 lines from the file since the actual file is too large. |
Service |
|
This parameter is used by the inbound File/FTP adapter during read-only polling in a clustered environment. Setting it to \"true\" causes the adapter to use the file system to store metadata about files that have been already processed. Setting it to \"false\" causes the adapter to use a database table. |
Service |
|
Used by the inbound high-av adapter when using \"FILEADAPTER_IN\" as the coordinator. Remember that when a file is first claimed (enqueued) by a node for processing FILE_PROCESSED column in FILEADAPTER_IN is set to \"0\". At a later point in time, when one of the decoupled Processor threads picks up the file for processing, the value of FILE_PROCESSED column is updated from \"0\" to \"1\". And when the file is processed completely, the FILE_PROCESSED column is updated from \"1\" to \"2\". However, if the processor thread picks up a file but the node crashes before it could process the file, then the file is never processed. This parameter is used to \"undo\" the pick operation. The adapter does this by deleting the entries in FILEADAPTER_IN table that have been picked up but not processed within the value specified here. |
Service |
|
Used by the inbound high-av adapter when using \"FILEADAPTER_IN\" as the coordinator. Remember that when a file is first claimed by a node for processing FILE_PROCESSED column in FILEADAPTER_IN is set to \"0\". At a later point in time, when the decoupled-Processor thread picks up the file for processing, the value of FILE_PROCESSED column is updated from \"0\" to \"1\". And when the file is processed completely, the FILE_PROCESSED column is updated from \"1\" to \"2\". If the node crashes when the FILE_PROCESSED is still \"0\", it would mean that the file is enqueued by a node (this means no other nodes can pick this one up). However, it also means that the decoupled processor threads have still not picked this one for processing. This parameter is used to \"undo\" the claim(enqueue_ operation. The adapter does this by deleting the entries in FILEADAPTER_IN table that have been claimed (for example, FILE_PROCESSED ==\"0\"), but not picked up till now. |
Service |
|
Defines how often would the poller thread purge control files for read-only polling scenarios. Defaults to 5 days. |
Service |
|
Number of milliseconds after which the inbound File/FTP adapter retries to establish database connection in distributed polling scenarios. |
Service |
|
Number of times that the inbound File/FTP adapter retries to establish database connection in distributed polling scenarios. |
Service |
|
Setting to \"true\" causes the File/FTP adapter to reject the original actual content. If set to \"false\", the adapter rejects the XML data created because of to the translation step. |
Service |
|
Setting to \"true\" causes the File/FTP adapter to call the Notification Agent's |
Reference |
|
Directory Path for the File/FTP adapter. |
Reference |
|
Set it to either \"ascii\" or \"binary\" depending on the requirement. |
Reference |
|
This parameter is used for outbound batching. The outgoing file is created when the number of messages condition is met. The parameter is of type String and is not mandatory. The default value is 1. |
Reference |
|
This parameter is used for outbound batching. When the time specified elapses, the outgoing file is created. The parameter is of type String and is not mandatory. The default value is 1. |
Reference |
|
This parameter is used for outbound batching. The outgoing file is created when the file size condition is met. The parameter is of type String and is not mandatory. The default value is 1000 KB. |
Reference |
|
This parameter is for the naming convention for the outbound write operation file. |
Reference |
|
Use this parameter to specify a static single file name during the write operation. |
Reference |
|
Setting this parameter to \"true\" causes the File/FTP adapter to append to a file on the outbound. If the file does not exist, a new file is created. |
Reference |
|
If \"true\", then the outbound File/FTP adapter writes translated data to a staging file and afterward it streams the staging file to the target file. If \"false\", then the outbound File/FTP adapter does not use an intermediate staging file. |
Reference |
|
The maximum number of translation activities that can be allowed to execute in parallel for a particular outbound scenario. The translation step during the outbound operation is CPU intensive and hence must to be guarded as it might cause starvation in other applications/threads. The max is 100 (same as the max for |
Reference |
|
Specifies the Oracle database sequence name to be used if you have already configured the outbound File/FTP adapter for high availability. |
Reference |
|
Set it to the class name that specifies the mutex you want to use for the outbound write operation. This class must extend |
Reference |
|
If set to \"true\", then the translation step is serialized using a semaphore. The number of permits for semaphore (guarding the translation step) comes from ConcurrentThreshold parameter (above). If \"false\", then the translation step occurs outside the semaphore. |
Reference |
|
This parameter is applicable only if |
Reference |
|
Set it to either \"ascii\" or \"binary\" depending on the requirement. |
Reference |
|
Set this parameter to \"true\" to notify the FTP adapter that the archival directory is on the same FTP server. If set to \"false\", the FTP adapter uses a local file system folder for archival. |
Reference |
|
If set to \"true\", the File/FTP adapter deletes the file after it has been processed. |
Reference |
|
Set it to \"true\" if you do not want the File/FTP adapter to throw an exception during the outbound read operation if the file could not be found. This parameter is ignored if the schema for the inbound file is anything other than \"Opaque\". |
Reference |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is processed by the File/FTP adapter. |
Reference |
|
Indicates the regex pattern against which the filenames are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the File/FTP adapter. |
Reference |
|
If set to \"true\", the File/FTP adapter processes files recursively in sub-directories. |
Reference |
|
This parameter specifies the maximum number of files that the File/FTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the File/FTP adapter submits 100 files every minute. |
Reference |
|
When you choose multiple directories, the generated JCA files use \";\" as the separator for these directories. However, if you want, you can change the separator to something else. If you do so, manually add DirectorySeparator=\"<<chosen separator>>\" in the generated JCA file. For example, to use comma (,) as the separator, you must first change the separator to \",\" in the Physical directory and then add DirectorySeparator=\",\" in the JCA file. |
Reference |
|
Set this parameter to \"true\" if you need the FtpAdapter to use \"NLST\" FTP command instead of \"LIST\" that the adapter uses by default. |
Reference |
|
This parameter is used by the FTP adapter to tackle time zone issues, typically to convert the time difference between the FTP server and the system on which the FTP adapter is running to millisecond. |
Reference |
|
Indicates the source file for the File I/O operation. |
Reference |
|
Indicates the source directory for the File I/O operation. |
Reference |
|
Set this to \"native\" if the source file is native and \"xml\" if the source file is xml. |
Reference |
|
Set it to the schema for the source file. |
Reference |
|
Set it to the root element name for the source file. |
Reference |
|
Indicates the target file for the File I/O operation. |
Reference |
|
The target directory for the File I/O operation. |
Reference |
|
Set this to \"native\" if the target file is native and \"xml\" if the source file is xml. |
Reference |
|
Set it to the schema for the target file. |
Reference |
|
Set it to the root element name for the target file. |
Reference |
|
Set it to the XSL transformer between the source and target. |
Reference |
|
Set it to either \"ascii\" or \"binary\" depending on the requirement. |
Reference |
|
Set it to the batch size for the batching transformation. |
Reference |
|
Set it to \"false\" to notify the FTP adapter that the source for the I/O operation is a local file system as opposed to remote FTP server. |
Reference |
|
Set it to \"false\" to I/O notify the FTP adapter that the target for the I/O operation is a local file system as opposed to remote FTP server. |
Reference |
|
Set it to the |
Table 33-7 describes the properties available for the Oracle JMS Adapter.
Table 33-7 Oracle JMS Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
Set the encoding to be used by JMS inbound adapter. |
Service |
|
Set the receive timeout interval. |
Service |
|
Set the interval JMS adapter would retry. |
Service |
|
Set the registration interval. |
Service |
|
Set the number of receive threads. |
Service |
|
Set the reply to destination. |
Service |
|
Whether message id is necessary for correlation. Valid values are 'true' or 'false'. |
Service |
|
Whether correlation id is necessary for correlation. Valid values are 'true' or 'false'. |
Service |
|
Whether to bypass headers or not. Valid values are 'true' or 'false'. |
Service |
|
Whether a reply message is created with a TTL value of other than 0 which is the default value in a request reply scenario. Valid values are 'true' or 'false'. |
Service |
|
A throttling parameter (in milliseconds) that adds a brief sleep between each inbound posted message, thus slowing down the message inflow. |
Reference |
|
Whether correlation is necessary in a request reply scenario. Valid values are 'true' or 'false'. |
Reference |
|
Whether correlation is necessary in a request reply scenario. Valid values are 'true' or 'false'. |
Reference |
|
Name of JMS physical destination. |
Reference |
|
Indicates the JMS Message type. |
Reference |
|
Set JMS delivery mode. Delivery Modes supported by JMS API are |
Reference |
|
Indicates the message lifetime in milliseconds. |
Reference |
|
Indicates the JMS message priority. |
Reference |
|
Specify |
Reference |
|
Specify |
Reference |
|
Indicates the name of JMS physical destination. |
Reference |
|
Indicates the name of JMS physical destination. |
Reference |
|
Allows creation of temporary destination for receiving messages. |
Reference |
|
Indicates the unique name of durable subscription within a client identifier. |
Reference |
|
Message selector expression used for message selection when delivering message to Destination. |
Reference |
|
Indicates the |
Table 33-8 describes the properties available for the Oracle MQ Series Adapter.
Table 33-8 Oracle MQ Series Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
Indicates the message type of outbound/dequeue message. |
Service |
|
Indicates the name of inbound/outbound queue. |
Service |
|
Set to true if characterSet from header is used while translation. |
Service |
|
Indicates the number of threads used in inbound. |
Service |
|
Indicates the name of Backout Queue where rejected message would go. |
Service |
|
Indicates the name of the Backout Queue Manger where rejected message would go. |
Service |
|
Indicates the number of times adapter would retry before sending the message to Backout Queue. |
Service |
|
Indicates the interval between re-try for backout message. |
Service |
|
This encoding value overwrites any encoding specified, either in MQMD or in schema file. |
Service |
|
Set to \"true\" if |
Service |
|
Indicates the |
Service |
|
Indicates the |
Service |
|
Indicates the priority of reply/outbound message. |
Service |
|
Indicates the expiry time for reply/outbound message. |
Service |
|
Indicates the persistence of reply/outbound message. |
Service |
|
Indicates the feedback code of reply/outbound message. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
Indicates the format of reply/outbound message. |
Service |
|
Indicates the behavior of adapter if reply/outbound message delivery fails. |
Service |
|
Indicates the segmentation property for message. |
Service |
|
Indicates the copy persistence from inbound message to reply message in Sync Req-Res(inbound) scenario. |
Service |
|
Indicates the propagate expiry interval from inbound message to reply message in Sync Req-Res(inbound) scenario. |
Service |
|
Indicates the name of inbound/outbound queue. |
Service |
|
Indicates the Get message options for outbound dequeue scenario. |
Service |
|
Indicates the Message id to be used for filtering. |
Service |
|
Indicates the Correlation id to be used for filtering. |
Service |
|
Indicates the Group id to be used for filtering. |
Service |
|
Indicates the message sequence number to be used for filtering. |
Service |
|
Indicates the message sequence number to be used for filtering. |
Reference |
|
Indicates the name of inbound/outbound queue. |
Reference |
|
Indicates the distribution list where message would go. |
Reference |
|
Set to false if message must go to all the Queues in DL else set to true. |
Reference |
|
Indicates the name of secondary queue manager. |
Reference |
|
Indicates the format of reply/outbound message. |
Reference |
|
Indicates the correlation scheme for message Id to be set. |
Reference |
|
Indicates the correlation scheme for correlation Id to be set. |
Reference |
|
Indicates the correlation scheme for outbound message. |
Reference |
|
Indicates the correlation scheme for outbound message. |
Reference |
|
Indicates the COA report to be set on the message. |
Reference |
|
Indicates the COD report to be set on the message. |
Reference |
|
Indicates the exception report to be set on the message. |
Reference |
|
Indicates the expiration report to be set on the message. |
Reference |
|
Indicates if |
Reference |
|
Indicates if |
Reference |
|
Indicates the |
Reference |
|
Indicates the |
Reference |
|
Indicates the priority of reply/outbound message. |
Reference |
|
Indicates the expiry time for reply/outbound message. |
Reference |
|
Indicates the persistence of reply/outbound message. |
Reference |
|
Indicates the feedback code of reply/outbound message. |
Reference |
|
Indicates the ReplyToQueue to be set on the message. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates the ReplyToQueueManager to be set on the message. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates the behavior of adapter if reply/outbound message delivery fails. |
Reference |
|
Indicates the segmentation property for message. |
Reference |
|
Set to true if partial delivery to DistributionList is allowed, else false. |
Reference |
|
Set to true if it is Sync Req-Res(outbound) scenario else false. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Set to true if reply/report message in Sync Req-Res scenario has Opaque schema. |
Reference |
|
Indicates the wait time for reply/report to arrive. |
Reference |
|
Set to true if no message is allowed as reply/report after specified wait interval. |
Reference |
|
Indicates the Get message options for reply/report. |
Reference |
|
Indicates the Open options for reply/report queue. |
Reference |
|
Indicates the Put message options. |
Reference |
|
Indicates the Open options for the queue. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Set to true if |
Reference |
|
Indicates the dynamic queue name. |
Reference |
|
Indicates the alternate user id. |
Reference |
|
Indicates the wait interval for outbound dequeue. |
Reference |
|
Set to true if no message is allowed in outbound dequeue scenario after specified wait interval. |
Reference |
|
Set to \"true\" if |
Table 33-9 describes the properties available for the Oracle Socket Adapter.
Note:
Properties such asTransMode
and XSLT
, which are not listed in Table 33-9, are displayed in the Properties tab. However, you cannot edit properties that are not listed in Table 33-9. Making changes to noneditable properties makes the composite invalid and would require remodeling of the composite.Table 33-9 Oracle Socket Adapter Properties
Service, Reference, or Endpoint | Property Name | Description |
---|---|---|
Service |
|
The port on which the inbound socket adapter listens for incoming socket connections. |
Service |
|
Indicates the character encoding of the native data. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Service |
|
Indicates the byte order of the native data as bigEndian or littleEndian. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates the host to which outbound socket adapter opens a socket connection. |
Reference |
|
Indicates the port to which outbound socket adapter tries to connect to. |
Reference |
|
Indicates the character encoding of the native data. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Reference |
|
Indicates the byte order of the native data as bigEndian or littleEndian. Note that you cannot edit this property in the Oracle Enterprise Manager Console. |
Table 33-10 describes the endpoint properties available for the Oracle JCA Adapters.
You cannot add or remove the endpoint properties without redeploying the composite. However, you can change the endpoint properties by using the Oracle Enterprise Manager Console without redeploying the composite.
Table 33-10 Oracle JCA Adapters Endpoint Properties
Direction (Inbound/Outbound) | Property Name | Description |
---|---|---|
Inbound |
|
This property can be used to increase the number of polling (Worker) threads for any inbound JCA resource adapter. It is only meant to help increase concurrency (scalability) for adapters, which do not natively support multi threading. Since most of the adapters bundled with Fusion Middleware natively support multi threading, this setting would mostly be useful to third party (custom) JCA adapters, which do not natively support multi threading. Set this property to the number of threads that is required for a particular JCA Service (endpoint). |
Inbound |
|
By default JCA adapters use the standard Fusion Middleware WebLogic WorkManager for starting polling (Worker) threads. However, if the user wants a particular JCA service (endpoint) to use custom (user defined) WorkManager, then this property enables the user to specify the name of such a custom WorkManager. The WorkManager is only used to start the JCA Service (endpoint) for which this property has been defined. |
Inbound |
|
When Native Correlation is used to correlate an inbound asynchronous message with a previous outbound message - by way of defining a callback interface (for a Reference) or by a mid process receive (in BPEL) - the JCA framework normally always try to post the message to the composite, whether the inbound message can be correlated or not. By setting this property to true, the JCA framework rejects a message, which cannot be correlated (when Native Correlation is active). |
Inbound |
|
Indicates the maximum number of retries before rejection. |
Inbound |
|
Indicates the time interval between retries (measured in seconds). |
Inbound |
|
Indicates the retry interval growth factor (positive integer). |
Inbound |
|
Indicates the maximum value of retry interval, that is, a cap if backoff is greater than 1. |
Outbound |
|
Indicates maximum number of retries before throwing retryable error condition back to invoking service engine. |
Outbound |
|
Indicates the time interval between retries (measured in seconds). |
Outbound |
|
Indicates the retry interval growth factor (positive integer). |
Outbound |
|
Indicates the maximum value of retry interval, that is, a cap if backoff is greater than 1. |
Outbound |
|
Indicates the maximum total retry period. Retries do not occur longer than the value specified in this parameter. |
The following examples show how to specify the endpoint properties in the composite.xml
file in Oracle JDeveloper:
Example 1: Specifying Endpoint Properties - Inbound
<service name="Inbound"> <interface.wsdl interface="http://xmlns...#wsdl.interface(Inbound_PortType)"/> <binding.jca config="Inbound_db.jca"> <property name="jca.retry.interval">5</property> <property name="jca.retry.interval">1</property> <property name="jca.retry.backoff">2</property> <property name="jca.retry.maxInterval">6</property> </binding.jca> </service>
Notice that the inbound property jca.retry.maxPeriod
is not supported (like it is in outbound).
Example 2: Specifying Endpoint Properties - Outbound
<reference name="Outbound"> <interface.wsdl interface="http://xmlns...#wsdl.interface(Outbound_PortType)"/> <binding.jca config="Outbound_jms.jca"> <property name="jca.retry.count">5</property> <property name="jca.retry.interval">1</property> <property name="jca.retry.backoff">2</property> <property name="jca.retry.maxInterval">6</property> <property name="jca.retry.maxPeriod">30</property> </binding.jca> </reference>