Activity Input and Output | Sun Microsystems JDBC/ODBC Adapter

Chapter 5

Using JDBC/ODBC Operations

Database operations in the JDBC eWay are used to access the JDBC database. Database operations are either accessed through Activities in BPEL, or through methods called from a JCD Collaboration.

What’s in This Chapter

JDBC eWay Database Operations (BPEL) on page 57

JDBC eWay Database Operations (JCD) on page 59

5.1JDBC eWay Database Operations (BPEL)

Within a BPEL business process, the JDBC eWay uses BPEL Activities to perform basic outbound database operations, including:

Insert

Update

Delete

SelectOne

SelectMultiple

SelectAll

In addition to these outbound operations, the JDBC eWay also employs the inbound Activity ReceiveOne within a Prepared Statement OTD.

The ability to perform any of the above methods using a table OTD may not be possible with all third-party drivers. You have to use a Prepared Statement to perform such an operation. Check with the respective driver’s vendor for further information. This feature is known as Updatable ResultSet.

5.1.1Activity Input and Output

The Sun SeeBeyond Enterprise Designer – Business Rules Designer includes Input and Output columns to map and transform data between Activities displayed on the Business Process Canvas.

JDBC/ODBC eWay Adapter User’s Guide

57

Sun Microsytems, Inc.

Image 57

Sun Microsystems JDBC/ODBC Adapter manual Jdbc eWay Database Operations Bpel, Activity Input and Output

Contents

EWAY JDBC/ODBC Adapter USER’S Guide Part Number Version Contents Activity Input and Output Transaction Support Levels Between Different Versions Stored Procedure Creating the Collaboration Definitions JavaCreate the Collaboration Business Rules Building and Deploying the Project Running the Sample Building and Deploying the prjJDBCBPEL Sample Project About Java Database Connectivity Jdbc Jdbc DriversWhat’s In This Chapter Type One Driver Type I JDBC-ODBC Bridge Type Two Driver Type II Partial Java driverPros Cons Type Three Driver Pure Java driver for database middleware Type Four Driver Direct-to-database pure Java driver Typical Type 3 Middleware Driver Configuration Typical Type 4 Driver Configuration About the JDBC/ODBC eWay What’s New in This ReleaseNew for Version About This Document ScopeJdbc eWay Javadoc Sun Microsystems, Inc. Web Site Related DocumentsIntended Audience Text Conventions Documentation Feedback Installing the Jdbc eWay Installing the JDBC/ODBC eWay Installing the Jdbc eWay on an eGate supported system Ican 5.0 Project Migration Procedures After InstallationExtracting the Sample Projects and Javadocs Install Java Caps Import the ProjectDeploy the Project To add plug-ins from the Enterprise Manager Installing Enterprise Manager eWay Plug-Ins To View the eWay Alert Codes Viewing Alert CodesAlert Codes for the JDBC/ODBC eWay Alert Code\Description Description Details User Actions Duncommitted Chapter Section Configuring the eWay Connectivity Map Properties Creating and Configuring a Jdbc eWay Connectivity Map with Components To configure the eWay properties Example Transaction Support Levels Between Different Versions Transaction Support Levels To Configure the Environment Properties Configuring the eWay Environment Properties EWay Connectivity Map Properties Outbound eWay Configuration Sections Include EWay Environment Properties Outbound XA eWay Configuration Settings IncludeConnectivity Map Outbound eWay Properties Connectivity Map Outbound non-Transactional eWay Properties Inbound Jdbc eWay Properties Inbound Jdbc eWay-Parameter SettingsOutbound Jdbc eWay Properties Name Description Required Value Outbound Jdbc eWay-JDBC Connector Settings Jdbc Connector SettingsIs Jdbc Connection Pool Datasource ConnectionPoolDataSource Connection Retry Settings Outbound Jdbc eWay-Connection Retry SettingsXADataSource or ConnectionPoolDataSource Outbound non-Transactional Jdbc eWay Properties Outbound non-Transactional eWay -JDBC Connector Settings Outbound non-Transactional eWay -JDBC Connector Settings Outbound XA Jdbc eWay Properties Outbound non-Transactional eWay-Connection Retry Settings Outbound XA Jdbc eWay-JDBC Connector Settings Is Jdbc XA DatasourceConnectionPoolDataSource or Outbound XA Jdbc eWay-Connection Retry Settings Outbound XA Jdbc eWay-Connection Retry Settings Creating a New Jdbc OTD About the Database OTD Wizard Connect To Database Select Wizard Type Select Database Objects Required Database Connection Fields includeSteps Required to Select Database Objects Include Steps Required to Select Table/Views/Aliases Include Select Tables/Views/Aliases Select Tables/Views/Aliases Database Wizard All Schemes Selected Tables/Views/Aliases window with a table selected Table/View Columns Select Procedures Steps Required to Select Stored Procedures Include Add Procedures Edit Resultset Steps Required to Add Prepared Statements Include Add Prepared Statement Prepared Statement Edit the Prepared Statement Parameters Review Selections Specify the OTD NameSteps Required to Specify the OTD Name Steps Required to Review Your OTD Selections Steps to Edit the OTD from the Enterprise Designer Include Steps to Edit an Existing Jdbc OTD Activity Input and Output Jdbc eWay Database Operations Bpel EInsight Operations Activity Input Activity Output JDBC.ODBC Operations Jdbc eWay Database Operations JCD To perform a query operation on a table Query Select Operation To perform an insert operation on a table Insert Operation To perform an update operation on a table Update Operation Stored Procedure Delete OperationTo perform a delete operation on a table Steps for executing the Stored Procedure include Executing Stored Procedures FileClient1.write Collaboration usability for a stored procedure ResultSet Batch Operations Prepared Statement Chapter Section Using JDBC/ODBC Operations About the Jdbc eWay Sample Projects Implementing the JDBC/ODBC eWay Sample Projects Sample input files Sample output JCD filesSample output Bpel files Operations Used in the Jdbc Sample Projects Sample Project DataAssigning Operations in JCD Assigning Operations in Bpel Running the Sample Projects About the eInsight Engine and eGate ComponentsSample Projects Drivers Importing a Sample Project Running the SQL Script Steps required to create the sample project Building and Deploying the prjJDBCJCD Sample Project Creating a Project Creating the OTDsSteps required to create a Jdbc Database OTD Click Next the Add Prepared Statements Wizard appears Creating a Connectivity Map Populating the Connectivity Map Steps required to create a new Connectivity MapSteps required to select a Jdbc External System Creating the Collaboration Definitions Java JcdDelete CollaborationSteps required to create the jcdDelete Collaboration JcdPsSelect Collaboration JcdInsert CollaborationSteps required to create the jcdInsert Collaboration Steps required to create the jcdPsSelect Collaboration Steps required to create the jcdPsUpdate Collaboration JcdPsUpdate CollaborationJcdTableSelect Collaboration Steps required to create the jcdTableSelect Collaboration Create the Collaboration Business Rules Creating the jcdDelete Business RulesCreating the jcdInsert Business Rules JcdInsert Business Rules Creating the jcdPsSelect Business Rules Sample code from the jcdPsSelect Includes JcdPsSelect Business Rules Creating the jcdTableSelect Business Rules Sample code from the jcdTableSelect Includes JcdTableSelect Business Rules Binding the eWay Components Creating the jcdUpdate Business Rules Steps required to bind eWay components together Creating an Environment Steps required to create an Environment Configuring the eWays Steps required to configure the eWay properties Configuring the eWay PropertiesFileClientIN eWay Property Settings FileClientOUT eWay Property Settings Configuring the Environment Explorer Properties Jdbc eWay Environment PropertiesSection Property Name Required Value Configuring the Integration Server Creating the Deployment ProfileFile eWay Environment Properties Steps required to create the Deployment Profile Creating and Starting the Domain Running the Sample Building and Deploying the ProjectSteps required to create and start the domain Build the Project Building and Deploying the prjJDBCBPEL Sample Project Steps required to create a Jdbc Database OTD include Creating the Business Process Flow Creating the Business ProcessSteps required to create inbound and outbound DTD OTDs Steps to create a business process flow include Configuring the bpelPsInsert Modeling Elements Business Process ActivitiesBusiness Process Activity BpelPsInsert Business Process Configuring the bpelUpdate Modeling Elements Steps required to configure the bpelUpdate business process BpelUpdate Business Process Configuring the bpelDelete Modeling Elements BpelDelete Business Process Steps required to configure the bpelDelete business process BpelTableSelect Business Process Configuring the bpelTableSelect Modeling Elements BpelTableSelect Business Rule # BpelSelectTable Business Rule # Creating the Connectivity Map Steps required to create the Connectivity MapTo Select a Jdbc External System To Select a Jdbc Business Process Binding the eWay Components 109 FileClientOUT eWay FileClientIN eWay EaJDBCOUT eWay 111 112 113 114 Running the Sample Project 116 JDBC/ODBC Drivers AS/400 Toolbox Driver Configuration PropertiesOTD Wizard Database Connection Information AS/400 Database Connection Information Attunity Driver Environment PropertiesAS/400 Database Environment Properties Attunity Driver Database Environment Properties Attunity Driver Database Connection Information MySQL Connector/J Driver Database Connection Information MySQL Connector/J DriverMySQL Connector/J Driver Environment Properties Parameter Value MaxIdleTime Default is PostgreSQL Driver Connection Information PostgreSQL Driver PostgreSQL Driver Environment Properties SyBase JConnect Driver Sybase JConnect Driver Database Connection InformationSybase JConnect Driver Environment Properties Sequelink DataDirect Informix Odbc Driver Sequelink DataDirect MS Access Odbc Driver MS Access Odbc Driver Environment Properties MS Access Odbc Driver Database Connection Information Teradata Driver Teradata Driver Database Connection InformationTeradata Driver Environment Properties Installing JDBC/ODBC Drivers Troubleshooting Index Jdbc Update count