Configuring Oracle JCA Adapters

26 Configuring Oracle JCA Adapters

Learn how to configure inbound and outbound endpoint properties during runtime for Oracle JCA adapters.

For more information about adapter tuning and performance properties, see Understanding Technology Adapters.

Note:

All adapter properties visible in Oracle Enterprise Manager Fusion Middleware Control can be updated on a live basis. Some properties may cause the endpoint to recycle (for example, QueueName), others do not (for example, jca.retry.count). Generally, properties originating from an activation or interaction spec cause the endpoint to recycle. All other (binding / endpoint) properties do not cause it to recycle.

Also, you can add any properties that you want to use and that are specified in Understanding Technology Adapters. However, because there is no validation when you add properties within Oracle Enterprise Manager Fusion Middleware Control, this practice is not recommended.

Configuring the Endpoint Properties for an Inbound Adapter

Learn how to configure the endpoint properties for an inbound adapter.

Editing a Predefined Property for an Inbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, you can 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 the adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click either Services or References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Service or Reference. The Home Page for the adapter is displayed.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

Edit a Predefined Property:

Click Properties to see a list of the currently defined binding properties.
Select the property you want to edit.
Edit the value in the Value text box, and then click Apply.

You have edited a predefined property for an inbound adapter.

Adding Predefined Properties for an Inbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, you can 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 the adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click either Services or References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Service or Reference. The Home Page for the Adapter 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 Apply.
  
  You have added a predefined property for an inbound adapter.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

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 the adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click Services. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Service. The Home Page for the Adapter 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 Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

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 the adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click Services. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Service. The Home Page for the Adapter 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 Yes to confirm.
4. Click Apply.
  
  You have deleted a property for an inbound adapter.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

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 the Adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click Services. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Service. The Home Page for the Adapter 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 Yes to confirm.
4. Click Save.
  
  You have reverted a property value for an inbound adapter.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

Configuring the Endpoint Properties for an Outbound Adapter

Learn how to configure the endpoint properties for an outbound adapter.

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...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Reference. The Home Page for the Adapter 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. You can click Apply to apply the change.
  
  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 Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

Adding a Predefined Property for an Outbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, you can 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 the Adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Reference. The Home Page for the Adapter 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 Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

Creating a New Property for an Outbound Adapter

The properties of an adapter are usually defined in Oracle JDeveloper during design time. However, you can add new properties at a later stage using Oracle Enterprise Manager Fusion Middleware Control.

To create a new property for an outbound adapter:

Navigate to the Adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Reference. The Home Page for the Adapter 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 Apply to apply the changes.
  
  You have created a new property for an outbound adapter.

For more information about configuring adapters, seeConfiguring Service and Reference Binding Component Properties and Understanding Technology Adapters.

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 the Adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Reference. The Home Page for the Adapter 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 Apply to apply the changes.
  
  You have deleted a property for an outbound adapter.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.

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 the Adapter by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Right-click soa-infra in the target menu. Click Services and References. The SOA-Infra page is displayed with Services and References. Click References. The Home page for the Adapter is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. From the Composite Target menu, select Service/Reference Properties. Select the Reference. The Home Page for the Adapter 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, and click Apply.
  
  You have reverted a property value for an outbound adapter.

For more information about configuring adapters, see Configuring Service and Reference Binding Component Properties and Understanding Technology Adapters.