Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
11g Release 1 (11.1.1.4.0)
Part Number E10226-05
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

31 Configuring Oracle JCA Adapters

This chapter describes how to configure Oracle JCA Adapters.

This chapter includes the following topics:

31.1 Searching for Rejected Messages for an Inbound Adapter

Use the Search feature to search for faults and rejected messages for an inbound adapter.

To search for faults and rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Click the Faults and Rejected Messages tab.

  3. Enter any or all of the following search criteria:

    • Error Message Contains

      Enter any part of the error message text.

    • Fault ID

      Enter the ID of the fault.

    • Fault Time From

      Enter the lower limit of the time when the fault could have occurred.

    • Fault Time To

      Enter the upper limit of the time when the fault could have occurred.

    • Composite Instance ID

      Enter the ID of the composite.

    • Fault Type

      Select a type from the list of faults available.

  4. Click Search to start the search operation.

    The fault or rejected message matching the criteria you specified is displayed.

  5. Click Reset to reset the search criteria.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.2 Deleting Rejected Messages for an Inbound Adapter

You can directly delete rejected messages from the database by specifying a search criteria.

To delete rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Click the Faults and Rejected Messages tab.

  3. Click Delete Rejected Messages....

    The Delete: Rejected Messages dialog is displayed.

  4. Specify a selection criterion for deleting rejected messages directly from the database, and then click Delete.

Note that to delete a fault, you must delete the associated composite instance from the Instances page.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.3 Searching for Faults for an Outbound Adapter

Use the Search feature to search for faults for an outbound adapter.

To search for faults for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Click the Faults tab.

  3. In the Search section, enter any or all of the following search criteria:

    • Error Message Contains

      Enter any part of the error message text.

    • Fault ID

      Enter the ID of the fault.

    • Fault Time From

      Enter the lower limit of the time when the fault could have occurred.

    • Fault Time To

      Enter the upper limit of the time when the fault could have occurred.

    • Composite Instance ID

      Enter the ID of the composite.

    • Fault Type

      Select the type of the fault from the list of types available.

  4. Click Search to start the search operation.

    The fault matching the criteria you specified is displayed.

  5. Click Reset to reset the search criteria.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.4 Configuring the End Point Properties for an Inbound Adapter

This section describes how to configure the end point properties for an inbound adapter. It includes the following topics:

31.4.1 Editing a Predefined Property for an Inbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible edit the predefined properties at a later stage.

To edit a predefined property for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Edit a predefined property:

    1. Click Properties to see a list of the currently defined binding properties.

    2. Select the property you want to edit.

    3. Edit the value in the Value text box, and then click Save.

      You have edited a predefined property for an inbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.4.2 Adding Predefined Properties for an Inbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible to add properties at a later stage.

Note:

Though the Properties tab list both endpoint and the binding properties, you can only add endpoint properties.

To add a predefined property for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Add a predefined property:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Click the Add button.

      A new empty row is appended to the existing list of properties.

    3. Click the Select Values icon in the Name field of the new row.

      The Properties dialog is displayed.

    4. Select a property that is valid for the particular adapter from the list of properties, and then click OK.

    5. Click Save.

      You have added a predefined property for an inbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.4.3 Creating a New Property for an Inbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible to add new properties at a later stage.

To create a new property for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Create a new property:

    1. Click the Properties tab to see the list of the currently defined binding properties.

    2. Click the Add button.

      A new empty row is appended to the existing list of properties.

    3. Specify the property name and value in the Name and the Value fields of the new row.

    4. Click Save.

      You have created a new property for an inbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.4.4 Deleting a Property for an Inbound Adapter

You can delete only properties that you added from the predefined list of properties or the ones that you newly created.

To delete a property for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Delete a property:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Select the property you want to delete, and then click Delete.

      A message asking you to confirm your action is displayed.

    3. Click OK to confirm.

    4. Click Save.

      You have deleted a property for an inbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.4.5 Reverting a Property Value for an Inbound Adapter

You can only revert the properties that you have changed. Also note that you can perform the revert operation only on the existing property values and not on those that you added from the predefined list of properties or the ones that you created.

To revert a property value for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

  2. Revert a property value for an inbound adapter:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Select the property you want to revert, and then click Revert.

      A message asking you to confirm your action is displayed.

    3. Click OK to confirm.

    4. Click Save.

      You have reverted a property value for an inbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.5 Configuring the End Point Properties for an Outbound Adapter

This section describes how to configure the end point properties for an outbound adapter. It includes the following topics:

31.5.1 Editing a Predefined Property for an Outbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible to edit the predefined properties at a later stage.

To edit a predefined property for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Edit a predefined property:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Select the property you want to edit.

    3. Edit the value in the Value text box, and then click Save.

      You have edited a predefined property for an outbound adapter.

Note:

For Oracle MQ Series Adapter in an asynchronous outbound request/reply scenario, properties are differentiated by an (Enqueue) or (Dequeue) label. For example, QueueName(Enqueue) is used for putting a message and QueueName(Dequeue) is used for dequeuing the reply.

When editing Oracle MQ Series Adapter properties in this scenario, note the following:

  • If you change the ReplyToQueueName(Enqueue) property, you must also change the QueueName(Dequeue) property to the same value.

  • If you change the MessageId(Dequeue) property, you must also change the MessageId(Enqueue) property to the same value.

  • If you change the CorrelationId(Dequeue) property, you must also change the CorrelationId(Enqueue) property to the same value.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.5.2 Adding a Predefined Property for an Outbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible to add predefined properties at a later stage.

To add a predefined property for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Add a predefined property:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Click the Add button.

      A new empty row is appended to the existing list of properties.

    3. Click the Select Value icon in the Name field of the new row.

      The Properties dialog is displayed.

    4. Select a property that is valid for the particular adapter from the list of properties, and then click OK.

    5. Click Save.

      You have added a predefined property for an outbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.5.3 Creating a New Property for an Outbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, it is possible to add new properties at a later stage.

To create a new property for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Create a new property:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Click the Add button.

      A new empty row is appended to the existing list of properties.

    3. Specify the property name and value in the Name and the Value fields of the new row.

    4. Click Save.

      You have created a new property for an outbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.5.4 Deleting a Property for an Outbound Adapter

You can delete only properties that you added from the predefined list of properties or the ones that you newly created.

To delete a property for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Delete a property for an outbound adapter:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Select the property you want to delete, and then click Delete.

      A message asking you to confirm your action is displayed.

    3. Click OK to confirm.

    4. Click Save.

      You have deleted a property for an outbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

31.5.5 Reverting a Property Value for an Outbound Adapter

You can revert changes made, if any, only for the already existing property values and not those that you added from the predefined list of properties or the ones that you newly created.

To revert a property value for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.
    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

  2. Revert a property value for an outbound adapter:

    1. Click the Properties tab to see a list of the currently defined binding properties.

    2. Select the property you want to revert, and then click Revert.

      A message asking you to confirm your action is displayed.

    3. Click OK to confirm.

    4. Click Save.

      You have reverted a property value for an outbound adapter.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

Go to previous page
Previous		 Go to next page
Next
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