A JCA control performs an operation on a EIS. Each JCA control can be configured to do operations that are specific to the associated EIS. The EIS can then be accessed by the business process using the JCA control.
A JCA control can do outbound operations such as enqueue operations (posting messages) to a queue in Oracle Advanced Queueing to create an outbound service. These operations could be outbound operations on a table like Insert, Update, or Delete to create outbound services in the Oracle E-Business Suite or outbound operations on SAP systems.
After generating the adapter-specific services, make sure that the WSDL and the associated artifacts are available in the project folder in Oracle Workshop for WebLogic IDE. Typically for WLI, the WSDL files should be in the Web project/src folder and the business object / payload schema file should be in the Utility project/schema folder. However, for the JCA control, the WSDL files and the associated schema files can be stored anywhere in the project folder. But, you need to make sure that the schema file associated with the WSDL file is properly referenced in the WSDL file. If the WSDL and the schema files are in the same folder, just specify the schema file name in the WSDL. If the WSDL and the schema files are located in different folders, in the WSDL file, use relative path to specify the name and location of the schema file.
Creating a JCA Integration Control
To create a new JCA control
In the Package Explorer pane, double-click the business process to which you want to add the JCA control. The business process is displayed in the Design view.
Click on the Data Palette and from the drop-down list choose Integration Controls to display the list of controls used for integrating applications.
Note:
If the Data Palette view is not visible in Oracle Workshop for WebLogic, click Window > Show View > Data Palette from the menu bar.
Select JCA. The Insert Control : JCA Control dialog appears.
Enter the following details.
In the Field Name, type the variable name used to access the new JCA control instance from your business process. The name you enter must be a valid Java identifier.
In the Insertion point, from the drop-down list, select the point where you want the field name to be inserted in the process file. This can be after the last field, the context, or after serial version UID.
Decide whether you want to make this a control factory and select or clear the Make this a control factory that can create multiple instances at runtime check box.
Click Next. The Create Control wizard appears.
Enter the following details.
In the Source folder field, specify the location of the project source folder.
In the Packages field, specify the package in the project source folder in which the new control is created.
In the Name field, type the name of your new control extension file.
In the Extended interfaces field, the JCA Control interface that is extended by the new control is displayed.
Decide whether you want to add comments as configured in the properties of the current project and select or clear the Generate comments check box.
Click Next. The Insert Control : JCA Control dialog appears.
Enter the following details.
In the WSDL field, enter the location of the WSDL file of the adapter service.
Based on your requirements, the service can be an Oracle Applications adapter service, an Oracle AQ adapter service, or an Oracle Application Adapter for SAP R/3 service. For more information, see “Creating Oracle Applications Adapter Services” and “Creating Oracle AQ Adapter Services” in Working with Adapters; and see the Oracle Application Adapter for SAP R/3 User's Guide.
In the Service field, select the service associated with the specified WSDL.
In the Port type field, select the required port type from the list of port types available in the specified WSDL.
Click Next. The Select Types JAR File Location dialog appears.
In the File name field, specify the name of the JAR file.
This JAR file contains the specified WSDL, any WSDLs referenced in the specified WSDL, and the class files and XML Beans for each of the elements defined in the WSDL.
Click Finish.
The JAR file is created and placed in the Web project/WebContent/WEB_INF/lib folder.
The JCA control methods are created and listed in the data palette.
You can use any of these methods in the business process to interact with the EIS.
on the Data Palette and from the drop-down list choose Integration Controls to display the list of controls used for integrating applications.
