Upgrade Guide

Upgrading Utility Adapters

The Utility adapters, Email and File, in WebLogic Integration 2.1 SP2 and WebLogic Integration 7.0 SP2, have been replaced in WebLogic Integration 8.1 with system features. Consequently, these two adapters cannot be upgraded and you will need to replace their implementation with the new features.

Note: The Adapter for RDBMS had been replaced by a new RDBMS Adapter for 8.1 and has new capabilities.

The following table shows the WebLogic Integration 2.1 and WebLogic Integration 7.0 SP2 adapters and their replacement in WebLogic Integration 8.1.

Table 8-1 WebLogic Integration 2.1 and 7.0 SP2 Utility Adapter vs 8.1 Functionality

WebLogic Integration 2.1 and WebLogic Integration 7.0 SP2 Adapters	Replacement in WebLogic Integration 8.1
Adapter for Email	Email Control (send e-mail) Email Event Generator (receive e-mail)
Adapter for File	File Control (read, write, or append files) File Event Generator (receive file from polled directory)
Adapter for RDBMS	Adapter for RDBMS 8.1

Use Email Controls and Event Generators Instead of Adapter for Email

Email controls enable WebLogic Integration business processes to send e-mails to specific destinations. To learn more about Email controls, see Email Control in the WebLogic Workshop Help at the following URL:

http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/controls/controlsEmail.html

Business processes use Email event generators to read e-mail messages from a Post Office Protocol (POP3) or Internet Message Access Protocol (IMAP) account on a mail server and publish the contents to Message Broker channels. To learn more about Email event generators, see Using Event Generators to Publish to Message Broker Channels in the WebLogic Workshop Help at the following URL:

http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/controls/controlsBrokerEventGenerators.html

Use File Controls and Event Generators Instead of the Adapter for File

File controls read, write, or append to a file in a file system. The files can be one of the following types: XmlObject, Binary (raw data), or String. In addition, the File control supports file operations such as copy, rename, and delete. Typically, you use these operations to manipulate large files, without having to process them in any way. To learn more about File controls, see File Control in the WebLogic Workshop Help at the following URL:

http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/controls/controlsFile.html

File event generators poll for files in file systems and publish the files to Message Broker channels. Business processes use File event generators to receive events—for example, a business process receives an event when a file appears in a file system that is polled by a File event generator. To learn more about File event generators, see Using Event Generators to Publish to Message Broker Channels in the WebLogic Workshop Help at the following URL:

http://download.oracle.com/docs/cd/E13226_01/workshop/docs81/doc/en/integration/controls/controlsBrokerEventGenerators.html

New Adapter for RDBMS 8.1

The Adapter for RDBMS 8.1 provides a similar user experience to the previous WebLogic Integration RDBMS adapters. However, several important features have been added, including the following:

Support for stored procedure calls.
Multiple mechanisms for event handling, including triggering, shadow tables, and destructive gets (where the table that is polled for events is a staging table in which rows are removed after they are processed).
Metadata browsing is now available from the WebLogic Integration - Application Integration Design Console.
Support for all JDBC (Java Database Connectivity) native types, including BLOB (Binary Large Object) and CLOB (Character Large Object Block).

To learn about the Adapter for RDBMS, see BEA WebLogic Adapters 8.1 at the following URL:

http://download.oracle.com/docs/cd/E13207_01/wladapters/docs81/index.html