Viewing Adapter Logs Oracle Fusion Middleware Online Documentation Library

2-44 Oracle Fusion Middleware Users Guide for Technology Adapters ■ Legacy adapters: In addition to the J2CA resource adapter, legacy adapters consists of Oracle Connect, which consists of native adapters for communicating with the mainframe application and data stores. Oracle Connect logs can be viewed using Oracle Studio, which is the mainframe adapter design-time tool and Oracle Connect management tool. Oracle Connect generates various types of logs, such as the daemon log, workspace log, and server process log. For more information, see Section 2.24, Setting the Trace Level of Oracle JCA Adapters .

2.26 Creating a Custom Adapter

You can configure a Custom JCA Adapter wizard as a generic adapter wizard within the JDev IDE that reads and displays its interactionactivation specs, properties and default values from a configuration file. The wizard enables you to select the specs, override the default property values, and add new properties. The Custom Adapter wizard has several purposes: ■ You can use the Custom Adapter Wizard on an as-is basis to support custom runtime adapters. You only need to supply or extend the Custom Adapter configuration file, customAdapter-config.xml to use the Custom Adapter. ■ You can modify or extend the Custom Adapter classes if you want to create a more specific adapter for example, you can change the text to match your adapter ■ You can use the Custom Adapter wizard to see a simple example of how to develop a new adapter wizard by using the JCA Adapter framework and by hooking into the SCAEndpoint interface. After the SOA jdev extension is installed, the Custom Adapter java source files can be found in JAVA_HOME jdeveloperintegrationadapterssamplescustom

2.26.1 Configuring a Custom Adapter

When you select SOA as an installable option with JDev, by default the Custom Adapter is not available. To ensure that the Custom Adapter is available, edit theJDEV_HOME\jdeveloper\integration\seed\soa\configuration\ soa-config.xml file, search for custom, and uncomment its adapterType element. The JDEV Component Palette displays the Custom Adapter for the SOA Diagram. The JDEV_HOME\jdeveloper\integration\seed\soa\configuration\ customAdapter-config.xml file contains the detailed options for the Custom Adapter connection-factory location, interaction-spec className, activation-spec className, and properties. The properties within an activation-spec are properties that are specific to an inbound adapter. The properties within an interaction-spec are the properties specific to an outbound adapter. The property values are the default values shown by the Custom Adapter. See the screenshots below for examples. You can modify the contents of the customAdapter-config.xml to match options needed by your custom runtime adapter. For example, you can change all property names and their default values, add new properties, or add multiple activation or interaction specs. The displayResourceKey and resourceBundle attributes are optional. If an activation-spec, interaction-spec, or property element has a displayResourceKey, ADAPTER Life-Cycle Management 2-45 the attribute value is used as a key to retrieve displayable text from a resource bundle. If a resource bundle is not available or the key is not found in the bundle, the key itself is used as the displayable text it is not required to have a resource bundle. The resource bundle you want to use can be specified by putting the resourceBundle attribute on the connection-factory element. Here is an example of a customAdapter-config.xml that has been modified. adapter-config xmlns=http:platform.integration.oracleblocksadapterfwmetadata connection-factory location=eisCustomCustomAdapter resourceBundle=oracle.tip.tools.ide.pm.modules.bizintegration.adapter.custom.resource.CustomString ResourceBundle endpoint-interaction interaction-spec className=oracle.tip.adapter.custom.outbound.CustomInteractionSpec displayResourceKey=CustomInteractionSpec property name=PropX value=x displayResourceKey=SAMP_PROP_X property name=PropY value=y displayResourceKey=Sample Property Y property name=Append value=false property name=NumberMessages value=1 interaction-spec endpoint-interaction endpoint-activation activation-spec className=oracle.tip.adapter.custom.inbound.CustomActivationSpec displayResourceKey=CustomActivationSpec property name=UseHeaders value=false property name=PhysicalDirectory value=x property name=Recursive value=true property name=DeleteFile value=true property name=IncludeFiles value=x property name=PollingFrequency value=60 property name=MinimumAge value=0 activation-spec endpoint-activation adapter-config

2.26.1.1 Custom Adapter Screen Flow

When you drag-and-drop the Custom JCA Adapter icon to the Exposed Service or External Reference swimlane within JDev, the IDE displays the Adapter Configuration Welcome Page. You can then select Next to begin the Custom Adapter Configuration Wizard workflow.