29 Configuring Oracle JCA Adapters

This chapter describes how to configure inbound and outbound end point properties during runtime for Oracle JCA adapters.

This chapter includes the following topics:

Section 29.1, "Configuring the End Point Properties for an Inbound Adapter"
Section 29.2, "Configuring the End Point Properties for an Outbound Adapter"

29.1 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:

Section 29.1.1, "Editing a Predefined Property for an Inbound Adapter"
Section 29.1.2, "Adding Predefined Properties for an Inbound Adapter"
Section 29.1.3, "Creating a New Property for an Inbound Adapter"
Section 29.1.4, "Deleting a Property for an Inbound Adapter"
Section 29.1.5, "Reverting a Property Value for an Inbound Adapter"

29.1.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 using Oracle Enterprise Manager Fusion Middleware Control.

To edit a predefined property for an inbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.1.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 using Oracle Enterprise Manager Fusion Middleware Control.

Note:

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

To add a predefined property for an inbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.1.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 using Oracle Enterprise Manager Fusion Middleware Control.

To create a new property for an inbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.1.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:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.1.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:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2 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:

Section 29.2.1, "Editing a Predefined Property for an Outbound Adapter"
Section 29.2.2, "Adding a Predefined Property for an Outbound Adapter"
Section 29.2.3, "Creating a New Property for an Outbound Adapter"
Section 29.2.4, "Deleting a Property for an Outbound Adapter"
Section 29.2.5, "Reverting a Property Value for an Outbound Adapter"

29.2.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 using Oracle Enterprise Manager Fusion Middleware Control.

To edit a predefined property for an outbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.

From the SOA Infrastructure Menu...

From the SOA Folder in the Navigator...

Click Home.
The SOA Infrastructure page is displayed.
Click the Deployed Composites tab.

The list of deployed composite applications is displayed.
In the Composite section, click a specific SOA composite application.

The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

Under soa-infra, click a specific SOA composite application.
The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2.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 using Oracle Enterprise Manager Fusion Middleware Control.

To add a predefined property for an outbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.

From the SOA Infrastructure Menu...

From the SOA Folder in the Navigator...

Click Home.
The SOA Infrastructure page is displayed.
Click the Deployed Composites tab.

The list of deployed composite applications is displayed.
In the Composite section, click a specific SOA composite application.

The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

Under soa-infra, click a specific SOA composite application.
The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2.3 Creating a New Property for an Outbound Adapter

To create a new property for an outbound adapter:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.

From the SOA Infrastructure Menu...

From the SOA Folder in the Navigator...

Click Home.
The SOA Infrastructure page is displayed.
Click the Deployed Composites tab.

The list of deployed composite applications is displayed.
In the Composite section, click a specific SOA composite application.

The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

Under soa-infra, click a specific SOA composite application.
The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

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, seeSection 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2.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:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.

From the SOA Infrastructure Menu...

From the SOA Folder in the Navigator...

Click Home.
The SOA Infrastructure page is displayed.
Click the Deployed Composites tab.

The list of deployed composite applications is displayed.
In the Composite section, click a specific SOA composite application.

The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

Under soa-infra, click a specific SOA composite application.
The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2.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:

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

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Reference Home page is displayed.

From the SOA Infrastructure Menu...

From the SOA Folder in the Navigator...

Click Home.
The SOA Infrastructure page is displayed.
Click the Deployed Composites tab.

The list of deployed composite applications is displayed.
In the Composite section, click a specific SOA composite application.

The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

Under soa-infra, click a specific SOA composite application.
The SOA Composite home page is displayed.
Click the outbound adapter (reference) from the Services and References section in the right panel.

The Reference Home page is displayed.

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 Section 34.1, "Configuring Service and Reference Binding Component Properties" and Oracle Fusion Middleware User's Guide for Technology Adapters.