You are on page 1of 80

WebSphere Adapters

Versin 6.0.2

Adapter para Oracle E-Business Suite Gua del usuario

Nota
Antes de utilizar esta informacin, asegrese de leer la informacin general en Avisos en la pgina 71.

22 de diciembre de 2006
Esta edicin se aplica a la versin 6, release 0, modificacin 2 de WebSphere Adapter para Oracle E-Business Suite
(nmero de producto 5724-N40) y a todos los releases y modificaciones subsiguientes hasta que se indique lo
contrario en nuevas ediciones.
Para enviarnos sus comentarios acerca de este documento, envenos un mensaje de correo electrnico a la direccin
hojacom@es.ibm.com. Estamos a la espera de sus comentarios.
Cuando enva informacin a IBM, otorga a IBM un derecho no exclusivo para utilizar o distribuir la informacin de
la forma que crea adecuada sin incurrir en ninguna obligacin con el remitente.
Copyright International Business Machines Corporation 2006. Reservados todos los derechos.

Contenido
Captulo 1. Acerca de esta informacin . . . . . . . . . . . . . . . . . . . . . . 1
Captulo 2. Notas del release . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Captulo 3. Introduccin a WebSphere Adapters . . . . . . . . . . . . . . . . . . 5
Captulo 4. Introduccin a Adapter para Oracle E-Business Suite . . . . . . . . . . . 7
Requisitos de hardware y software . . . . . . . .
Cumplimiento de los estndares . . . . . . . . .
Accesibilidad . . . . . . . . . . . . . .
Internet Protocol Versin 6.0 . . . . . . . . .
Visin general tcnica de Adapter para Oracle E-Business
Arquitectura del adaptador . . . . . . . . .
Aplicaciones de ejemplo de proceso de salida . . .
Aplicacin de ejemplo de proceso de entrada . . .
WebSphere Adapters en entornos en clster . . .

. .
. .
. .
. .
Suite
. .
. .
. .
. .

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

. 8
. 8
. 8
. 9
. 9
. 10
. 12
. 13
. 14

Captulo 5. Instalacin del adaptador . . . . . . . . . . . . . . . . . . . . . . . 17


Requisitos previos de instalacin .
Realizacin de la instalacin . . .
Desinstalacin del adaptador . .

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

. 17
. 17
. 18

Captulo 6. Ejemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Requisitos de la cuenta de usuario de la base de datos y aplicaciones . . . . . .
Acceso a los archivos de ejemplo . . . . . . . . . . . . . . . . . .
Ejemplo 1: Envo de datos de salida al EIS . . . . . . . . . . . . . . .
Preparacin para el proceso de salida . . . . . . . . . . . . . . . .
Creacin del proyecto del adaptador . . . . . . . . . . . . . . . .
Adicin de dependencias externas de software . . . . . . . . . . . .
Configuracin del adaptador para el proceso de salida . . . . . . . . . .
Creacin de objetos de negocio . . . . . . . . . . . . . . . . . .
Despliegue del proyecto del adaptador en el entorno de prueba . . . . . . .
Cmo probar la operacin Create (crear). . . . . . . . . . . . . . .
Cmo probar la operacin Retrieve (recuperar) . . . . . . . . . . . .
Cmo borrar el contenido del ejemplo . . . . . . . . . . . . . . .
Ejemplo 2: Recepcin de datos de entrada desde el EIS . . . . . . . . . . .
Preparacin para el proceso de entrada . . . . . . . . . . . . . . .
Configuracin en Oracle E-Business Suite . . . . . . . . . . . . . .
Creacin del proyecto del adaptador en WebSphere Integration Developer . . .
Adicin de dependencias externas de software . . . . . . . . . . . .
Configuracin del adaptador para el proceso de entrada . . . . . . . . .
Objetos de negocio de la operacin Retrieve (recuperar) . . . . . . . . .
Creacin de objetos para la operacin Retrieve (recuperar). . . . . . . . .
Creacin de un componente de entrada . . . . . . . . . . . . . . .
Despliegue del proyecto del adaptador en el entorno de prueba . . . . . . .
Cmo probar la aplicacin del adaptador ensamblado . . . . . . . . . .
Cmo borrar el contenido del ejemplo . . . . . . . . . . . . . . .
Ejemplo 3: Cmo llamar a la API de Oracle E-Business Suite para el proceso de salida
Configuracin del adaptador para el proceso de salida para llamadas a la API . .
Despliegue del proyecto del adaptador en el entorno de prueba . . . . . . .
Cmo probar la aplicacin del adaptador ensamblado . . . . . . . . . .
Cmo borrar el contenido del ejemplo . . . . . . . . . . . . . . .
Visualizacin de los artefactos del adaptador de ejemplo . . . . . . . . . .
Informacin de resolucin de problemas para las aplicaciones de ejemplo . . . .
Copyright IBM Corp. 2006

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

19
19
20
20
21
21
22
26
33
34
40
40
41
41
42
46
46
46
49
51
54
56
57
58
59
59
62
62
64
64
65

iii

Captulo 7. Informacin de consulta . . . . . . . . . . . . . . . . . . . . . . . 67


Mensajes . . . . . . . . . . .
Informacin relacionada con el producto

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

. 67
. 67

Captulo 8. Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Informacin de la interfaz de programacin
Marcas registradas y marcas de servicio . .

iv

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

. 73
. 73

Captulo 1. Acerca de esta informacin


Esta documentacin se dirige a desarrolladores de integracin que implementen,
configuren y desplieguen WebSphere Adapter para Oracle E-Business Suite. Para
utilizarla, debe comprender los conceptos de integracin comercial y poseer ciertos
conocimientos tcnicos.
Los desarrolladores de integracin disean, ensamblan, prueban y despliegan
soluciones de integracin. Esta informacin est destinada a aquellas personas que
van a desplegar WebSphere Adapter para Oracle E-Business Suite en una solucin
que requiera el intercambio de datos entre los sistemas de informacin de empresa
(EIS) y aplicaciones Java 2 Platform, Enterprise Edition (J2EE).
Debido a que WebSphere Adapter para Oracle E-Business Suite se basa en
WebSphere Adapter para JDBC versin 6.0.2, debe comprender completamente este
adaptador as como acceder a la documentacin del mismo.
Tambin debe comprender y tener experiencia con los conceptos, estndares y
herramientas siguientes:
v La solucin y el entorno de negocio.
v Bases de datos, temas de acceso a datos, modelos transaccionales y conexiones
entre bases de datos relacionales heterogeneas.
v Mecanismos de integracin comercial, que incluyen el modelo de programacin
de Service Component Architecture (SCA) y el modelo de datos de Service Data
Objects (SDO).
v El estndar J2EE y las aplicaciones J2EE.
v Las capacidades y los requisitos de WebSphere Process Server o WebSphere
Enterprise Service Bus, en funcin del sistema principal utilizado en el entorno.
Debe saber cmo configurar y administrar el servidor de sistema principal y
cmo utilizar la consola administrativa.
v Las herramientas y capacidades proporcionadas por WebSphere Integration
Developer. Debe saber cmo utilizar estas herramientas para conectar
componentes y completar otras tareas de integracin.
Para completar el despliegue, debe saber cmo realizar las tareas siguientes:
v Crear los scripts, herramientas y plantillas que sean necesarios para las pruebas
y el despliegue
v Resolver interdependencias entre entidades como por ejemplo enterprise beans,
flujos de trabajo y pginas web
v Escribir procedimientos para utilizar la lgica de acceso a bases de datos
eficazmente
v Crear modelos de datos para herramientas externas de acceso a datos
v Implementar medidas de seguridad

IBM Corporation 2006

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 2. Notas del release


Las notas del release para WebSphere Adapter para Oracle E-Business Suite,
versin 6.0.2 resumen las nuevas caractersticas y funciones en este release y
documentan las soluciones temporales conocidas.
Las notas del release para este adaptador se pueden encontrar en el siguiente sitio
web: Adapter for Oracle E-Business Suite release notes.

Copyright IBM Corp. 2006

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 3. Introduccin a WebSphere Adapters


IBM WebSphere Adapters permite que componentes de Java 2 Platform, Enterprise
Edition (J2EE), tales como nuevas aplicaciones de e-business, se comuniquen con
recursos en un sistema de informacin de empresa (EIS). Un EIS es una
infraestructura de informacin para una empresa (por ejemplo, un sistema de
planificacin de recursos empresariales [ERP]).
Un WebSphere Adapter acta como un intermediario entre un componente de J2EE
y el EIS, de forma que el componente de J2EE no necesita comprender la API o las
estructuras de datos de bajo nivel del EIS.
Los WebSphere Adapters pueden ser de dos tipos: de aplicacin o de tecnologa.
v Los adaptadores de aplicacin conectan aplicaciones empaquetadas existentes
(tales como software SAP Siebel, PeopleSoft Enterprise y JD Edwards
EnterpriseOne) de forma que pueda utilizar datos y servicios especficos de estas
aplicaciones.
v Los adaptadores de tecnologa proporcionan conectividad a los datos mediante
tecnologas y protocolos como bases de datos relacionales, archivos planos,
mensajes de correo electrnico y FTP.
Como parte de la familia de productos WebSphere, WebSphere Adapters funciona
con WebSphere Integration Developer y WebSphere Process Server o WebSphere
Enterprise Service Bus.
v WebSphere Integration Developer es el entorno de herramientas para WebSphere
Adapters.
Necesita utilizar WebSphere Integration Developer para ensamblar un mdulo
desplegado en WebSphere Process Server o WebSphere Enterprise Service Bus.
Desde WebSphere Integration Developer, importa el adaptador (que est
empaquetado como un archivo de adaptador de recursos [RAR]) y se conecta al
EIS. El asistente Descubrimiento de servicios de empresa de WebSphere
Integration Developer busca datos y servicios en el EIS y crea la informacin de
la interfaz necesaria para acceder a los datos y servicios. Finalmente, WebSphere
Integration Developer genera un mdulo que incluye el adaptador y la
informacin de la interfaz.
v WebSphere Process Server o WebSphere Enterprise Service Bus es el entorno de
ejecucin para WebSphere Adapters.
Necesita desplegar el mdulo generado por WebSphere Integration Developer en
uno de los servidores.
La generacin y despliegue del mdulo se muestra en la figura siguiente.
Figura 1. Cmo se genera y despliega un mdulo

IBM Corporation 2006

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Archivo RAR
del adaptador

WebSphere
Integration
Developer

Asistente
Descubrimiento
de servicios
de empresa

Archivo
RAR del
adaptador

Informacin
de la interfaz

Datos o
servicio

Sistema de
informacin
de empresa

Informacin
de la interfaz

Mdulo

Servidor

Captulo 4. Introduccin a Adapter para Oracle E-Business


Suite
WebSphere Adapter para Oracle E-Business Suite es una solucin que utiliza
componentes existentes WebSphere para permitir la comunicacin bidireccional
entre Oracle E-Business Suite y el sistema WebSphere Business Integration. Oracle
E-Business Suite puede utilizar mltiples mtodos de proceso de datos a y de
fuentes externas. Esta solucin se basa en interacciones que funcionan directamente
con los componentes de la base de datos en Oracle E-Business Suite utilizando
WebSphere Adapter para JDBC.
La solucin WebSphere Adapter para Oracle E-Business Suite no es un adaptador
de recursos tradicional. La solucin utiliza WebSphere Adapter para JDBC para
comunicarse con la base de datos de Oracle E-Business Suite y muestra cmo
configurar la interaccin entre ellos mediante la utilizacin de aplicaciones de
ejemplo. Las instrucciones explican cmo permitir que la informacin fluya entre
Oracle E-Business Suite y WebSphere Process Server, para el proceso tanto de
sucesos de entrada como de solicitudes de salida.
El contenido y los artefactos de ejemplo de los que se compone esta solucin le
ayudan a acelerar el proceso de habilitacin de la integracin con Oracle
Copyright IBM Corp. 2006

E-Business Suite. Las aplicaciones de ejemplo proporcionan directrices para la


integracin de bases de datos utilizando el mdulo Receivables con un cliente de
Oracle y una API de Oracle. Puede aplicar lo que puede aprender de los ejemplos
a distintos mdulos de Oracle E-Business Suite que seleccione utilizar, por ejemplo,
General Ledger o Payables.

Requisitos de hardware y software


Antes de instalar Adapter para EL NOMBRE DEL ADAPTADOR, debe verificar si
el entorno cumple los requisitos necesarios. Estos requisitos se dividen en dos
categoras: plataformas soportadas para ejecutar el instalador del adaptador, y
requisitos de hardware y software para configurar, desplegar y ejecutar el
adaptador.

Plataformas soportadas para la ejecucin del instalador del


adaptador
Las plataformas soportadas para la ejecucin del instalador del adaptador estn
ubicadas en la seccin Instalacin de Instalacin de IBM WebSphere Adapters.

Requisitos de hardware y software para la configuracin,


despliegue y ejecucin del adaptador
Los requisitos de hardware y software para la configuracin, despliegue y
ejecucin del adaptador estn ubicados en el siguiente sitio web: IBM WebSphere
Adapters e IBM WebSphere Business Integration Adapters: requisitos de software.
En la lista de IBM WebSphere Adapters, seleccione el enlace de Adapter para EL
NOMBRE DEL ADAPTADOR, Versin 6.0.2.

Cumplimiento de los estndares


Este producto cumple con varios estndares gubernamentales e industiales, que
incluyen estndares de accesibilidad y estndares de protocolo de Internet.

Accesibilidad
IBM se esfuerza en proporcionar productos con un acceso utilizable por cualquier
persona, independientemente de su edad o capacidades. El software de WebSphere
Adapters es completamente accesible y cumple con la seccin 508. Las
caractersticas de accesibilidad permiten a los usuarios con discapacidades fsicas,
como movilidad restringida o una visin limitada, trabajar satisfactoriamente con
los productos. Estas caractersticas estn incorporadas en las caractersticas de
instalacin y administracin de WebSphere Adapters.

Instalacin
Puede instalar WebSphere Adapters mediante una interfaz grfica de usuario o en
modalidad desatendida mediante un script. El mtodo de instalacin desatendida
est recomendado para aquellos usuarios con necesidades de accesibilidad.

Administracin
La consola administrativa de WebSphere Process Server o WebSphere Enterprise
Service Bus es la interfaz principal de despliegue y administracin de las
aplicaciones de empresa. Estas consolas se visualizan en un navegador web

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

estndar. Utilizando un navegador web accesible, como por ejemplo Microsoft


Internet Explorer o Netscape Browser, puede hacer lo siguiente:
v Utilizar software lector de pantalla y un sintetizador de habla digital para or lo
que se visualiza en la pantalla
v Utilizar software de reconocimiento de voz, como por ejemplo IBM ViaVoice,
para especificar datos y para navegar por la interfaz del usuario
v Trabajar con caractersticas utilizando el teclado en lugar del ratn
Puede configurar y utilizar las caractersticas del producto utilizando editores de
texto estndar e interfaces mediante scripts o de la lnea de mandatos en lugar de
las interfaces grficas que se proporcionan.
Cuando es adecuado, la documentacin para caractersticas especficas del
producto contiene informacin adicional sobre la accesibilidad de las
caractersticas.

Asistente de descubrimiento de servicios de empresa


El asistente Descubrimiento de servicios de empresa es el componente principal
utilizado para crear aplicaciones de empresa con los adaptadores. Este asistente se
implementa como un plugin de Eclipse que est disponible mediante WebSphere
Integration Developer y es completamente accesible.

Navegacin mediante el teclado


Este producto utiliza teclas estndares de navegacin de Microsoft Windows.

IBM y accesibilidad
Consulte IBM Accessibility Center para obtener ms informacin sobre el
compromiso de IBM con la accesibilidad.

Internet Protocol Versin 6.0


IBM WebSphere Process Server se basa en WebSphere Application Server para la
compatibilidad con Internet Protocol Versin 6.0.
IBM WebSphere Application Server Versin 6.0 y su componente JavaMail dan
soporte a Internet Protocol Versin 6.0 (IPv6) de pila dual.
Para obtener ms informacin sobre esta compatibilidad en WebSphere Application
Server, consulte el soporte de IPv6 en el centro de informacin de WebSphere
Application Server.
Para obtener ms informacin sobre IPv6, consulte www.ipv6.org.

Visin general tcnica de Adapter para Oracle E-Business Suite


WebSphere Adapter para Oracle E-Business Suite permite la conectividad entre el
sistema WebSphere y Oracle E-Business Suite tanto para el proceso de solicitudes
de salida como para sucesos de entrada. Utiliza WebSphere Adapter para JDBC y
mecanismos de bases de datos de Oracle E-Business Suite conjuntamente para
procesar datos. Tres aplicaciones de ejemplo componen el adaptador, dos para el
proceso de solicitudes de salida y una para un suceso de entrada.

Captulo 4. Introduccin a Adapter para Oracle E-Business Suite

Arquitectura del adaptador


El mecanismo de proceso de sucesos para Oracle E-Business Suite se utiliza con
WebSphere Adapter para JDBC para procesar sucesos de entrada desde la base de
datos Oracle. Adapter para JDBC procesa solicitudes de salida para crear,
actualizar o recuperar datos en la base de datos Oracle.

Visin general
Oracle E-Business Suite se crea alrededor de la base de datos Oracle y funciona con
ella. Oracle E-Business Suite tiene su propio mecanismo de proceso de sucesos,
Business Event System (BES). Este sistema permite emitir sucesos en la base de
datos Oracle y a continuacin utilizar las suscripciones que consumen los sucesos y
realizar una accin, que se basa en la configuracin preestablecida. Las acciones
pueden incluir rellenar una tabla o cola de Oracle AQ con la informacin del
suceso, o ejecutar algn cdigo SQL o Java.
Cuando se emite un suceso, Business Event System busca suscripciones que
utilizan ese tipo de suceso y procesa las acciones definidas en estas suscripciones.
El usuario de Oracle tiene flexibilidad para definir qu acciones puede realizar. Por
ejemplo, se puede designar que se desencadene un suceso en base a las
actualizaciones de un objeto de Cliente en la base de datos Oracle. A continuacin,
se notificara de una suscripcin que tiene como destino un suceso de cambio de
cliente y se realizara una accin. La accin podra ser rellenar con los valores clave
para el objeto cambiado una tabla de sucesos para que fueran consumidos por otro
componente.
WebSphere Adapter para JDBC se utiliza para manejar la interrelacin con los
artefactos de la base de datos. Permite llamadas de tabla SQL directas y la
interaccin con los procedimientos almacenados y las API de la base de datos. Esta
solucin utiliza el soporte de proceso de sucesos incorporado inherente en Oracle
E-Business Suite para procesar sucesos que pueden ser consumidos por Adapter
para JDBC. Esta solucin utiliza tambin Adapter para JDBC para rellenar con
informacin la base de datos Oracle y para llamar a procedimientos a fin de
procesar datos en un sistema Oracle.

Arquitectura de entrada
En la aplicacin de ejemplo para el proceso de sucesos de entrada, Adapter para
JDBC se utiliza para sondear una tabla de sucesos creada en la base de datos de la
aplicacin Oracle. El adaptador utiliza la informacin de sucesos de la tabla de
sucesos, como por ejemplo la clave y el tipo del objeto, a fin de recuperar
informacin de objetos de negocio de las tablas base Oracle. Para obtener
informacin sobre la arquitectura de Adapter para JDBC, consulte el manual
WebSphere Adapters: Adapter for JDBC User Guide.

10

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Oracle E-Business
Suite
Base de datos
Tablas base

Adaptador JDBC

Punto final

Tabla de sucesos

Figura 2. Proceso de sucesos de entrada

El Business Event System interno de Oracle le permite reconocer cundo se ha


cambiado un objeto de negocio y rellenar la tabla de sucesos con esa informacin.
Consulte la aplicacin de ejemplo para obtener detalles especficos sobre la
utilizacin de Business Event System. Para obtener ms informacin sobre Business
Event System, consulte la documentacin para aplicaciones Oracle, especficamente
el manual Workflow Administrators Guide.

Arquitectura de salida
Para el proceso de solicitudes de salida, Adapter para JDBC se utiliza para rellenar
con la informacin del objeto las tablas de la interfaz de la aplicacin Oracle. Las
tablas de la interfaz son tablas estndar utilizadas para permitir que se procese la
informacin de entrada en las tablas base Oracle. Oracle da soporte a este proceso
para ayudarle a evitar cambios no deseables en el contenido que se podran
producir debido a actualizaciones directas de las tablas base.

Oracle E-Business
Suite
Base de datos
Punto final

Adaptador JDBC

Tablas de la interfaz
Tablas base

Figura 3. Proceso de solicitudes de salida

Adapter para JDBC rellena las tablas de la interfaz y, a continuacin, se utiliza para
llamar a un procedimiento almacenado que invoca una llamada de funcin
estndar incluida en la aplicacin Oracle. La base de datos Oracle procesa los datos
en las tablas de la interfaz y rellena las tablas base con estos.
Para recuperar datos de la aplicacin Oracle, se puede realizar una operacin
Retrieve (recuperar) contra las tablas base utilizando Adapter para JDBC, porque
no se estn modificando datos en las tablas.
Adems, se puede utilizar Adapter para JDBC para llamar directamente a las
interfaces de programacin de la aplicacin (API) de bases de datos incorporadas
Oracle. Sin embargo, el controlador JDBC limita los parmetros a tipos de datos
simples, o no de registro, cuando se llama a una API directamente desde Adapter
para JDBC. Debido a que la mayora de las API de Oracle utilizan parmetros de
Captulo 4. Introduccin a Adapter para Oracle E-Business Suite

11

registro, estas API pueden estar envueltas dentro de los procedimientos


almacenados, que a continuacin pueden ser llamados por Adapter para JDBC.

Oracle E-Business
Suite
Base de datos
Punto final

API de Oracle

Adaptador JDBC

Figura 4. Proceso de salida para una llamada a la API

Aplicaciones de ejemplo de proceso de salida


Con esta solucin se proporcionan dos aplicaciones de ejemplo de proceso de
salida. Una utiliza las tablas de la interfaz de base de datos Oracle, que es el caso
de ejemplo de salida estndar para Oracle E-Business Suite; y la otra utiliza
llamadas a la API. El primer ejemplo de salida tiene dos partes: utiliza la operacin
Create (crear) y a continuacin la operacin Retrieve (recuperar) para Adapter para
JDBC.

Proceso de salida utilizando las tablas de la interfaz


El primer ejemplo de proceso de solicitud de salida tiene dos partes:
v Creacin de un objeto de negocio utilizando una operacin Create (crear)
v Recuperacin de un objeto utilizando una operacin Retrieve (recuperar)
La base de datos Oracle permite la recuperacin de datos de las tablas base de las
aplicaciones. Los objetos de negocio utilizados para la operacin Retrieve
(recuperar) reflejan la representacin de tablas base de los datos. La base de datos
Oracle no permite la modificacin manual de los datos en las tablas base. Por lo
tanto, este ejemplo utiliza las tablas de la interfaz cuando Adapter para JDBC enva
objetos de negocio que cambian el contenido de la base de datos Oracle. Es el caso
de ejemplo de proceso de solicitud de salida estndar. Despus de que se
actualicen las tablas de la interfaz con los datos de los objetos de negocio, se llama
a una funcin, mediante un procedimiento almacenado, que mueve los datos de la
interfaz a las tablas base.

Adaptador
JDBC

Tablas de
la interfaz

Tablas
base

Llamada de la
funcin a la
API de Oracle

Figura 5. Situacin de ejemplo de Create

12

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Adapter para JDBC se utiliza para rellenar las tablas de la interfaz con datos de los
objetos de negocio. Debido a que Oracle permite el proceso tanto de
actualizaciones nuevas como de actualizaciones existentes de las entidades de
datos mediante las tablas de la interfaz, Create (crear) es la nica operacin
necesaria para procesar datos nuevos y modificados. Los datos de los objetos de
negocio se pueden mover a las tablas base Oracle invocando una funcin interna y
estndar de Oracle. Se llama a la funcin mediante un procedimiento almacenado
para mover los datos a las tablas base utilizando la informacin especfica de la
aplicacin de AfterCreateSP en el objeto de negocio.
Las operaciones Create (crear) y Retrieve (recuperar) utilizan distintos conjuntos de
objetos de negocio porque representan distintas tablas de la base de datos Oracle.
Esta aplicacin de ejemplo incluye el procedimiento almacenado de envoltorio para
que la llamada a la funcin mueva los datos a las tablas base, adems del
contenido de ejemplo que se utilizar para el procedimiento.

Adaptador
JDBC

Tablas
base

Figura 6. Situacin de ejemplo de Retrieve

Proceso de salida utilizando la llamada a la API


Este ejemplo muestra cmo Adapter para JDBC puede llamar directamente a una
API de Oracle E-Business Suite. El controlador JDBC limita los parmetros a tipos
de datos simples, no de registro, cuando Adapter para JDBC llama directamente a
una API. La mayora de las API de Oracle incluyen parmetros de registro. Se
pueden realizar llamadas a la API que utilicen parmetros de tipo de registro
mediante Adapter para JDBC slo si la llamada al procedimiento almacenado de
envoltorio no utiliza el tipo de parmetro de registro. La llamada a la API para este
ejemplo utiliza parmetros de tipo de datos simples.
Este ejemplo utiliza Adapter para JDBC para llamar directamente a una API de
Oracle, que crea un ejecutable de programa simultneo en la base de datos Oracle.
El contenido de este ejemplo incluye ejemplos de la llamada a la API.

Aplicacin de ejemplo de proceso de entrada


Este ejemplo utiliza Oracle Business Event System para enviar datos de entrada de
cliente desde Oracle E-Business Suite a una tabla de sucesos donde Adapter para
JDBC puede leerlos. Adapter para JDBC recupera y procesa los objetos de negocio
de una base de datos Oracle. El contenido incluido para este ejemplo se describe
en esta seccin.
Este ejemplo muestra el proceso de datos de entrada de cliente desde Oracle
E-Business Suite. Business Event System incorporado de Oracle emite el suceso y
rellena los valores necesarios en la tabla de sucesos de Adapter para JDBC.
Un programa simultneo personalizado busca actualizaciones a la tabla Cliente y
emite sucesos si se encuentran clientes nuevos o modificados. Puede configurar el
programa simultneo para que se ejecute a intervalo establecidos, invocarlo
manualmente o bien invocarlo mediante un procedimiento almacenado. Para este
ejemplo, el programa simultneo est configurado para intervalos establecidos.
Captulo 4. Introduccin a Adapter para Oracle E-Business Suite

13

Para ahorrar tiempo cuando se realicen los pasos del ejemplo, el programa
simultneo se invoca manualmente. Una vez que los datos llegan a la tabla de
sucesos, Adapter para JDBC sondea la tabla para buscar object_key, object_name y
object_function. A continuacin, procesa el objeto de negocio de la aplicacin de
base de datos Oracle.

Tablas
base
Oracle

Programa
simultneo

Emitir el
suceso

Tabla de
sucesos
personaliz.

Adaptador
JDBC

Suscripciones
de sucesos

Figura 7. Proceso de sucesos de entrada

Para Business Event System, se define un suceso para actualizaciones en la tabla


Cliente. Cuando se guardan cambios, se emite el suceso y el Gestor de sucesos de
Oracle busca suscripciones para este tipo de suceso. El ejemplo utiliza una
suscripcin personalizada que reconoce el cambio en los datos del cliente. El
suceso se pasa a la suscripcin, que procesa los datos en base a la accin definida
en la suscripcin. La informacin del suceso rellena la tabla de sucesos de Adapter
para JDBC. El adaptador consulta esta tabla y utiliza la informacin del suceso
para realizar una operacin Retrieve (recuperar) desde las tablas base del objeto de
negocio.
El contenido de este ejemplo incluye los procedimientos almacenados necesarios
para configurar la accin y las tablas de sucesos.
Nota: Aunque es posible utilizar un desencadenante en la tabla de cliente para
manejar cmo se rellena la tabla de sucesos, Oracle no lo recomienda.

WebSphere Adapters en entornos en clster


Puede mejorar el rendimiento y la disponibilidad del adaptador desplegando el
mdulo de archivado de empresa (EAR) de WebSphere Adapter en un entorno de
servidor en clster. La instancia del adaptador en el mdulo EAR se replica en los
servidores federados.
WebSphere Process Server y WebSphere Application Server Network Deployment
dan soporte a los entornos en clster. Los clsteres son grupos de servidores que
se gestionan conjuntamente para equilibrar cargas de trabajo y proporcionar alta
disponibilidad y escalabilidad. Cuando configura un clster de servidores, crea un
perfil del Gestor de despliegue. HAManager, un subcomponente del Gestor de
despliegue, indica al contenedor JCA que active la instancia del adaptador. El
contenedor JCA proporciona un entorno de ejecucin para las instancias del
adaptador. Para obtener ms informacin sobre los entornos en clster, consulte

14

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/
com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.html.
En los entornos en clster, las instancias del adaptador pueden manejar tanto
operaciones de entrada como operaciones de salida.

Alta disponibilidad para las operaciones de entrada


Las operaciones de entrada se basan en sucesos desencadenados como resultado de
actualizaciones de los datos de la aplicacin del sistema de informacin de
empresa (EIS). El adaptador est configurado para detectar actualizaciones
mediante escuchas de sucesos o sondeando una tabla de sucesos. A continuacin,
el adaptador publica el suceso en su punto final.
En un entorno en clster, es posible que dos o ms instancias del adaptador
detecten el mismo suceso. Este caso de ejemplo presenta la posibilidad del proceso
de sucesos duplicados o de la falta de fidelidad de los datos. Por ejemplo, si dos
instancias del adaptador sondean de forma simultnea la misma tabla de sucesos
con el mismo filtro de tipo de suceso, es posible que una modifique los datos sobre
los que depende la otra instancia del adaptador, o que resulte en error. Existe un
riesgo paralelo para las arquitecturas del adaptador de escucha de sucesos en un
entorno en clster.
Para evitar esta condicin, HAManager para las instancias del adaptador de
entrada implementa un comportamiento nico. Aunque estn iniciadas todas las
instancias del adaptador, slo una de las instancias detecta y publica un suceso en
el punto final para cada tipo de aplicacin del EIS.
Cuando despliega un mdulo del adaptador en un clster, el contenedor JCA
comprueba la propiedad enableHASupport del bean ResourceAdapter. Si el valor
de la propiedad enableHASupport es true (verdadero), el contenedor JCA registra
todas las instancias del adaptador con HAManager con una poltica 1 de N. Esta
poltica significa que slo uno de los servidores en clster inicia el sondeo (o la
escucha) de sucesos para esta instancia del adaptador. Aunque estn iniciadas otras
instancias del adaptador en el clster, permanecern inactivas respecto al suceso
activo hasta que la instancia activa del adaptador acabe de procesar el suceso. Si el
servidor en el que se ha iniciado la hebra de sondeo concluye por algn motivo, se
activar una instancia del adaptador que se est ejecutando en uno de los
servidores de respaldo.

Alta disponibilidad para las operaciones de salida


En los entornos en clster, hay disponibles varias instancias del adaptador para
realizar solicitudes de salida. En consecuencia, si el entorno tiene varias
aplicaciones que interactan con el mismo WebSphere Adapter para solicitudes de
salida, puede mejorar el rendimiento desplegando el mdulo del adaptador en un
entorno en clster.
WebSphere Application Server Network Deployment tiene una capacidad de
gestin de carga de trabajo que distribuye el proceso de salida entre las instancias
del adaptador. Como resultado, las operaciones de salida en un entorno en clster
son similares a las operaciones en un entorno de un nico servidor: una sola
instancia del adaptador procesa slo una solicitud de salida cada vez. Para obtener
ms informacin sobre la gestin de la carga de trabajo, consulte
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/
com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.html.
Captulo 4. Introduccin a Adapter para Oracle E-Business Suite

15

Nota: Las instancias del adaptador se replican en un entorno de servidores en


clster. Cuando la propiedad enableHASupport est establecida en true
(verdadera), que es el valor predeterminado, slo una instancia replicada del
adaptador sondea de forma activa sucesos mientras que las dems instancias
se encuentran en modalidad de espera. Si la propiedad enableHASupport
est establecida en false (falsa), todas las instancias replicadas del adaptador
en los miembros del clster sondean de forma activa los sucesos. Esto puede
dar como resultado una duplicacin de sucesos. No cambie el valor de
enableHASupport a false (falso) para entornos de un nico servidor. Para
obtener informacin sobre cmo cambiar el valor de esta propiedad,
consulte la seccin de las propiedades del adaptador de recursos en este
documento. Para determinar si la duplicacin del adaptador est soportada
en un entorno en clster, consulte la seccin de los requisitos de software y
hardware de este documento.

16

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 5. Instalacin del adaptador


Para instalar el adaptador, debe comprobar los requisitos previos del sistema y, a
continuacin, realizar los pasos de instalacin comunes a todos los adaptadores.

Requisitos previos de instalacin


Antes de instalar Adapter para Oracle E-Business Suite, debe instalar y configurar
WebSphere Adapter para JDBC, versin 6.0.2. Tambin debe verificar si el entorno
satisface todos los requisitos necesarios de hardware y software. Estos requisitos se
dividen en dos categoras: plataformas soportadas para ejecutar el instalador del
adaptador, y requisitos de hardware y software para configurar, desplegar y
ejecutar el adaptador.

Instalacin de WebSphere Adapter para JDBC


La informacin sobre la instalacin de WebSphere Adapter para JDBC se
proporciona en la seccin Installing the Adapter del manual Adapter for JDBC
User Guide. Incluye informacin de instalacin especfica de Adapter para JDBC.

Plataformas soportadas para la ejecucin del instalador del


adaptador
Las plataformas soportadas para la ejecucin del instalador del adaptador estn
ubicadas en la seccin Instalacin de Instalacin de IBM WebSphere Adapters.

Requisitos de hardware y software para la configuracin,


despliegue y ejecucin del adaptador
Los requisitos de hardware y software para la configuracin, despliegue y
ejecucin del adaptador estn ubicados en el siguiente sitio web: IBM WebSphere
Adapters e IBM WebSphere Business Integration Adapters: requisitos de software.
En la lista de IBM WebSphere Adapters, seleccione el enlace para Adapter for
Oracle E-Business Suite, versin 6.0.2.

Realizacin de la instalacin
Los pasos para instalar el adaptador son los mismos para todos los WebSphere
Adapters. Puede instalar el adaptador utilizando una interfaz grfica de usuario o
realizando una instalacin desatendida.
Antes de empezar
Revise los requisitos previos de instalacin.
Cmo realizar esta tarea
1. Instale el adaptador utilizando las instrucciones bsicas de instalacin, que son
comunes a todos los adaptadores. Estos pasos estn ubicados en la seccin
Instalacin del manual Instalacin de IBM WebSphere Adapters.
Nota: Algunos WebSphere Adapters requieren que realice pasos adicionales
especficos al adaptador a fin de completar la instalacin. WebSphere
Adapter para Oracle E-Business Suite no tiene este requisito.
Copyright IBM Corp. 2006

17

2. Despus de realizar los pasos de instalacin bsicos, puede configurar el


adaptador.
Resultado
Se copia una carpeta de ejemplos en la estacin de trabajo en la que se ha
instalado el adaptador. Si ha aceptado la ubicacin de instalacin predeterminada,
la carpeta se coloca en uno de los siguientes directorios, en base al sistema
operativo:
v C:\Archivos de programa\IBM\ResourceAdapters\OracleEBS (sistemas
Windows)
v /opt/IBM/ResourceAdapters/OracleEBS (sistemas UNIX)

Desinstalacin del adaptador


Los pasos para desinstalar el adaptador son los mismos para todos los WebSphere
Adapters. Puede desinstalar el adaptador utilizando una interfaz grfica de usuario
o realizando una desinstalacin desatendida.
Acerca de esta tarea
La desinstalacin del adaptador puede ser una tarea necesaria para la resolucin
de un problema de instalacin. Los pasos para la desinstalacin del adaptador
estn ubicados en la seccin Desinstalacin del manual Instalacin de WebSphere
Adapters.
Nota: Si necesita desinstalar un adaptador que ya est desplegado, consulte la
seccin Informacin adicional que puede necesitar de Informacin
relacionada con el producto en la pgina 67.

18

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 6. Ejemplos
El contenido y los artefactos de ejemplo que componen WebSphere Adapter para
Oracle E-Business Suite muestran mtodos para estructurar la integracin de salida
y de entrada entre la base de datos de Oracle E-Business Suite y el sistema
WebSphere Business Integration.

Requisitos de la cuenta de usuario de la base de datos y aplicaciones


Para utilizar los ejemplos, debe utilizar una cuenta de la base de datos que le
proporcione derecho sobre los artefactos necesarios para ejecutar el contenido de
ejemplo y debe utilizar una cuenta de Oracle E-Business Suite que le permita
realizar responsabilidades de administrador de flujo de trabajo para aplicaciones
web, administrador del sistema y administrador de Receivables.
Para los fines de estos ejemplos, se presupone que la cuenta de usuario que ejecuta
todos los scripts es el usuario de APPS para la base de datos Oracle. Este usuario
tiene los derechos siguientes:
v Para cambiar y crear contenido en el esquema APPS
v Para aadir y eliminar datos de las tablas
v Para ejecutar los ejecutables necesarios en el esquema APPS
Consulte con el administrador de la base de datos Oracle para determinar la
cuenta que se utilizar para ejecutar el contenido de ejemplo. Si desea seleccionar
una cuenta de usuario distinta, trabaje con el administrador de la base de datos
para asegurarse de que el usuario tenga derechos sobre todos los artefactos de base
de datos necesarios para ejecutar el contenido de ejemplo.
Oracle E-Business Suite requiere que tenga una cuenta con derechos sobre las
siguientes responsabilidades:
v Aplicaciones Web del administrador de flujos de trabajo
v Administrador del sistema
v Receivables Manager
Nota: Si la cuenta de Oracle E-Business Suite que est utilizando no tiene acceso a
estas responsabilidades, stas se pueden aadir. Para cambiar las
responsabilidades asignadas a la cuenta que utilizar, inicie la sesin con
una cuenta que tenga derechos de responsabilidad de Administrador del
sistema y vaya la opcin de men Security ->User->Define (Seguridad
->Usuario ->Definir). Para obtener informacin especfica sobre la
modificacin de las responsabilidades de usuario, consulte la documentacin
para aplicaciones Oracle.

Acceso a los archivos de ejemplo


Cuando instala WebSphere Adapter para Oracle E-Business Suite, se crea un
directorio de ejemplos. El directorio de ejemplos tiene el contenido que utilizar
para ejecutar las aplicaciones de ejemplo.
1. Busque la carpeta Sample en el directorio de instalacin de IBM WebSphere
Adapter para Oracle E-Business Suite.

Copyright IBM Corp. 2006

19

2. Descomprima el archivo oracleEBSSamples.zip. Los archivos de ejemplo se


describen en la tabla siguiente.
Tabla 1. Archivos de ejemplo
Nombre de archivo

Descripcin

Ibm_websphere_event_table_create.sql

Script de creacin de tablas de sucesos

Ibm_websphere_events_s.sql

Script de creacin de secuencias de ID de


suceso

Ibm_customer_event_pkg.pls

Script de creacin de paquetes para los


procedimientos utilizados en los ejemplos de
creacin de objetos de cliente

Ibm_customer_event_key_s.sql

Script de creacin de secuencias de claves de


sucesos

Ibm_submit_request.sql

Script de SQL para insertar un


procedimiento especial al que llamar
despus de que se hayan creado entradas de
suceso en las tablas de la interfaz para
mover los datos a las tablas base

Raise_inbound_event.sql

Script de SQL para emitir el suceso entrante


de cliente

Ibm_create_synonyms.sql

Crea los nombres de sinnimo utilizados al


crear objetos de negocio para los ejemplos

Ejemplo 1: Envo de datos de salida al EIS


Con WebSphere Adapter para Oracle E-Business Suite, puede importar datos en
una aplicacin Oracle y recuperar los datos de la aplicacin. En este caso de
ejemplo, utiliza WebSphere Adapter para JDBC como el mtodo de integracin
para crear un cliente en la base de datos Financials de Oracle E-Business Suite y
para recuperar de nuevo la informacin de cliente de la base de datos Financials.
La realizacin de este situacin de ejemplo le mostrar cmo configurar los flujos
de informacin entre Oracle E-Business Suite y WebSphere Process Server para
sucesos de salida, independientemente del mdulo de Oracle E-Business Suite que
utilice; por ejemplo, podra utilizar Payables o General Ledger.

Preparacin para el proceso de salida


Debe ejecutar archivos script de SQL para prepararse para el proceso de salida.
Necesita crear sinnimos para ahorrar tiempo posteriormente cuando genere
objetos de negocio desde la base de datos de Oracle E-Business Suite. Tambin
necesita insertar artefactos en Oracle E-Business Suite antes de poder procesar
objetos utilizando las tablas de base de datos.
Cmo realizar esta tarea
1. Cree sinnimos
Abra la herramienta SQL*Plus (o un programa similar para procesar sentencias
SQL). Inicie la sesin en SQL*Plus utilizando una cuenta de la base de datos
que tenga otorgados derechos de administrador de base de datos (DBA).
Ejecute el archivo ibm_create_synonyms.sql.
Por ejemplo: SQL> @C:\samplecontent\ibm_create_synonyms.sql.
El tamao de la base de datos y el nmero de artefactos de la base de datos en
la base de datos de Oracle E-Business Suite pueden alargar el proceso de
bsqueda en listas grandes al ejecutar el asistente Descubrimiento de servicios

20

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

de empresa para generar objetos. La creacin de los sinnimos le ayudar a


acelerar la bsqueda. Adems, los sinnimos ayudan a resolver un problema
relacionado con el controlador de la base de datos Oracle. Este problema se
documenta en la nota tcnica de IBM 1218775.
2. Inserte artefactos en Oracle E-Business Suite
Antes de procesar objetos de negocio, ejecute el script de SQL
ibm_submit_request.sql.
Esto coloca un procedimiento almacenado denominado
IBM_WEBSPHERE_CUSTOMER_IMP en el esquema APPS de Oracle. Este
procedimiento se utiliza para mover los datos de cliente de las tablas de la
interfaz Oracle a las tablas base. Utilizar las tablas de la interfaz al construir el
objeto de negocio Create (crear).

Creacin del proyecto del adaptador


Para empezar el proceso de creacin de un mdulo para la comunicacin con una
aplicacin Oracle E-Business Suite, cree un proyecto de adaptador JDBC. El
proyecto del adaptador (denominado un proyecto de conector en WebSphere
Integration Developer) contiene el propio Adapter para JDBC adems de otros
artefactos relacionados. Necesita crear el proyecto importando el archivo RAR, que
se ha copiado en el sistema de archivos local durante la instalacin de Adapter
para JDBC, en WebSphere Integration Developer.
Antes de empezar
Asegrese de tener acceso a la documentacin para Adapter para JDBC. Para ver
esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Cmo realizar esta tarea
1. Revise la informacin de la seccin Configuring the adapter for deployment
del manual WebSphere Adapters: Adapter for JDBC User Guide.
2. Realice la tarea Creating the adapter project del manual WebSphere Adapters:
Adapter for JDBC User Guide. Siga los pasos de esta seccin para configurar el
proyecto del adaptador en el espacio de trabajo de WebSphere Integration
Developer.

Adicin de dependencias externas de software


Despus de crear el proyecto en WebSphere Integration Developer, necesita aadir
una referencia al controlador JDBC en el proyecto antes de poder configurar el
adaptador para el proceso de salida.
Antes de empezar
Asegrese de tener acceso a la documentacin para Adapter para JDBC. Para ver
esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Cmo realizar esta tarea
Aadir dependencias externas
Realice la tarea Adding external software dependencies descrita en el manual
WebSphere Adapters: Adapter for JDBC User Guide para aadir una referencia al
controlador JDBC en el proyecto.
Captulo 6. Ejemplos

21

Configuracin del adaptador para el proceso de salida


Necesita crear los objetos de negocio necesarios para procesar datos en Oracle
E-Business Suite. Para realizar esta tarea, utilice el asistente Descubrimiento de
servicios de empresa para WebSphere Adapter para JDBC. En primer lugar,
inicialice el asistente Descubrimiento de servicios de empresa configurando valores
de las propiedades que permiten al adaptador configurar un canal de
comunicaciones a una base de datos especfica. A continuacin, ejecute una
consulta de objetos de negocio. Finalmente, debe especificar los valores de las
propiedades de seleccin para el archivo de importacin.

Generacin de objetos de negocio utilizando Descubrimiento de


servicios de empresa
Para el proceso de salida, cree dos conjuntos de objetos de negocio. El primer
conjunto se utiliza para pasar datos para nuevos clientes y actualizaciones a datos
para clientes existentes a la base de datos. El segundo conjunto de objetos se utiliza
para recuperar datos de cliente directamente de las tablas base Oracle. Antes de
generar los objetos de negocio, necesita establecer propiedades de conexin para
que el asistente Descubrimiento de servicios de empresa se conecte al EIS (sistema
de informacin de empresa).
Cmo establecer las propiedades de conexin para Descubrimiento de servicios
de empresa:
Necesita establecer los valores de las propiedades de conexin del descubrimiento
de servicios de empresa para la instancia de la base de datos. Estas propiedades
permiten al asistente Descubrimiento de servicios de empresa en Adapter para
JDBC conectarse a la base de datos Oracle para el descubrimiento y para la
creacin de la descripcin del servicio.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, en la perspectiva Integracin empresarial,
seleccione Archivo > Nuevo > Descubrimiento de servicios de empresa.
2. En la ventana Seleccionar un adaptador de recursos de servicios de empresa,
seleccione Adaptador EMD JDBC y pulse Siguiente.
3. En la ventana Configurar valores para el agente de descubrimiento, especifique
la informacin para la base de datos en los campos de las propiedades de la
configuracin de la conexin. Son necesarios cuatro valores de propiedad de
conexin de descubrimiento de servicios de empresa para el ejemplo. La tabla
siguiente lista estas propiedades y sus descripciones. Para obtener detalles
acerca de estas propiedades, consulte Enterprise service discovery connection
properties de la seccin Reference del manual WebSphere Adapters: Adapter
for JDBC User Guide. Para ver esa documentacin, consulte
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/
com.ibm.wsadapters602.jca_jdb.
Pulse Siguiente.
Tabla 2. Propiedades de descubrimiento de servicios de empresa

22

Propiedad

Descripcin

Nombre de usuario

Cuenta de la base de datos que est utilizando.

Contrasea

Contrasea para la cuenta que est utilizando.

DatabaseURL

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Tabla 2. Propiedades de descubrimiento de servicios de empresa (continuacin)


Propiedad

Descripcin

JDBCDriverClass

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

Seleccin de objetos de negocio y servicios:


Despus de configurar las propiedades de conexin, ejecute una consulta para los
objetos de la base de datos. Puede examinar la estructura del rbol de metadatos
para comprender la estructura de los objetos del EIS (sistema de informacin de la
empresa) y seleccionar los objetos necesarios para la descripcin del servicio. Para
este ejemplo, ejecuta una consulta sobre el esquema de Accounts Receivable (AR) y
selecciona sinnimos que representan las tablas de la interfaz de Oracle E-Business
Suite.
Cmo realizar esta tarea
1. Especifique las propiedades de filtro
En la ventana Buscar y descubrir servicios de empresa, pulse Editar consulta.
En la ventana Propiedades de filtro de la consulta, especifique AR en el campo
de la propiedad Filtro de nombre de esquema para visualizar el esquema de
Accounts Receivable (AR).
El campo de la propiedad Tipos lista las entradas siguientes: tablas, vistas,
procedimientos almacenados y sinnimos/apodos. Puede aadir o eliminar
nodos de esta lista.
Seleccione el recuadro de seleccin Aadir ASI de objeto de negocio y pulse
Aceptar. A continuacin, siempre que aada un objeto cuando ejecute la
consulta de metadatos en el paso 2, aparecer una ventana denominada
Parmetros de configuracin para (nombre de objeto) para especificar la
informacin especfica de la aplicacin.
2. Ejecute la consulta de metadatos
a. Visualice los objetos comprendidos en la consulta
Pulse Ejecutar consulta. El esquema AR y los elementos de datos del
esquema se visualizarn en el panel superior.
b. Seleccione el objeto a importar
Expanda el esquema AR. Expanda Sinnimos - Apodos
Resalte el sinnimo IBM_C_CUST_PROFILE y pulse Aadir a lista de
importacin para seleccionar este objeto a importar.
c. Aada informacin especfica de la aplicacin del objeto de negocio
Pulse Aadir en Parmetros de configuracin para la ventana
IBM_C_CUST_PROFILE.
Seleccione AfterCreateSP y pulse Aceptar en la ventana Aadir.
En el rea AfterCreateSP de los Parmetros de configuracin para la
ventana IBM_C_CUST_PROFILE, establezca los valores siguientes:
v Especifique APPS en el campo Filtro de nombre de esquema.
v Seleccione APPS en la lista Esquema.
Nota: Despus de seleccionar el esquema APPS, puede que transcurra
bastante rato hasta que el campo Filtro de nombre SP se active.

Captulo 6. Ejemplos

23

v Especifique IBM_WEBSPHERE_CUSTOMER_IMP en el campo Filtro de


nombre SP.
v Seleccione IBM_WEBSPHERE_CUSTOMER_IMP en la lista Procedimiento
almacenado.
Pulse Aceptar.
Despus de un momento, el objeto seleccionado se visualizar en el panel
inferior.
En este ejemplo, procesa los datos utilizando las tablas base y de la interfaz
incorporada de Oracle. Slo es necesaria la operacin Create (crear) para
enviar tanto los datos de cliente como las actualizaciones a datos de cliente
existentes. Como parte de la llamada a la operacin Create (crear) del
objeto, el procedimiento almacenado IBM_WEBSPHERE_CUSTOMER_IMP
se ejecuta utilizando el valor AfterCreateASI para el objeto a procesar. Este
procedimiento almacenado mueve los datos de la interfaz a las tablas base.
d. Seleccione los sinnimos restantes
Seleccione cada uno de los restantes sinnimos (vea la lista siguiente) y
pulse Aadir. Cuando aparezca la ventana Parmetros de configuracin
para (nombre de objeto), pulse simplemente Aceptar. No aada el valor
AfterCreateSP.
Cuando haya finalizado, pulse Siguiente.
Los
1)
2)
3)
4)
5)
6)

sinnimos restantes son los siguientes:


AR.IBM_C_CUST_INTERFACE
AR.IBM_C_CUST_BANKS
AR.IBM_C_CONTACTS
AR.IBM_C_PAY_METHODS
AR.IBM_R_CUST_PROFILES
AR.IBM_R_CUST_ACCOUNTS

7)
8)
9)
10)

AR.IBM_R_PARTIES
AR.IBM_R_ACCT_SITES
AR.IBM_R_SITE_USES
AR.IBM_R_PARTY_SITES

11) AR.IBM_R_LOCATIONS
12) AR.IBM_R_CONTACTS_CUSTOMER
13) AR.IBM_R_CONTACTS_SITES
Para obtener informacin sobre la informacin especfica de la aplicacin de
los atributos, verbos, y nivel de objeto, consulte la seccin
Application-specific information del manual IBM WebSphere Adapters:
Adapter for JDBC User Guide. Para ver esa documentacin, consulte
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/
com.ibm.wsadapters602.jca_jdb.
.
Generacin de definiciones de objeto de negocio y artefactos relacionados:
Despus de que haya seleccionado objetos de base de datos, deber especificar
valores para las propiedades de seleccin para los archivos de importacin y
exportacin.
Cmo realizar esta tarea

24

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

1. Especifique el valor de NameSpace


En la vista Configurar objetos de Descubrimiento de servicios de empresa, deje
el valor por omisin para NameSpace.
2. Seleccione un tipo de servicio
Seleccione Outbound para el campo Tipo de servicio.
3. Seleccione Operaciones
El panel Operaciones lista las operaciones a las que el adaptador da soporte
para el tipo de servicio que ha seleccionado. Elimine las siguientes operaciones:
Delete, Update, ApplyChanges, y RetrieveAll resaltndolas y pulsando
Eliminar.
Las siguientes operaciones permanecen:
v Create
v Retrieve
Deje los valores por omisin para los campos MaxRecords y BOLocation. Pulse
Siguiente.

Configuracin de las propiedades del adaptador


Para configurar un canal de comunicaciones a una base de datos especfica para el
proceso de salida, configure las propiedades de la fbrica de conexin gestionada
(J2C) y del adaptador de recursos que el adaptador utiliza. Tambin necesita crear
un mdulo de integracin comercial donde se guarden todos los artefactos y los
valores de propiedad.
Cmo realizar esta tarea
1. Especifique un nuevo nombre de mdulo
En la ventana Generar artefactos, pulse Nuevo junto al campo Mdulo. En la
ventana Nuevo proyecto de integracin, confirme que Crear un proyecto de
mdulo est seleccionado. En la ventana Nuevo mdulo, especifique
Oracle_Outbound, y pulse Finalizar. Este mdulo albergar todos los artefactos
generados.
2. Establezca los valores de propiedad de configuracin
En la parte inferior de la ventana, pulse el botn Utilizar propiedades de
conexin descubiertas.
Para el proceso de salida, aparecern los campos de propiedades para las
propiedades de la fbrica de conexin J2C y del adaptador de recursos. Para las
Propiedades de la fbrica de conexin J2C (gestionado), en Credenciales de
usuario en el campo Nombre de usuario, especifique el nombre de usuario de
la base de datos. En el campo Contrasea, especifique la contrasea de la base
de datos.
Para Propiedades del adaptador de recursos, en Varios establezca el valor para
Proveedor de base de datos en Oracle. Pulse Finalizar.
Para obtener informacin sobre estas propiedades, consulte la seccin
Reference del manual WebSphere Adapters: Adapter for JDBC User Guide. Para
ver esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

Cmo guardar el proyecto del adaptador


Necesita guardar el mdulo de integracin comercial para el proceso de salida que
contiene los artefactos y los valores de propiedad que ha creado.
Cmo realizar esta tarea
1. En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.
Captulo 6. Ejemplos

25

2. Seleccione Archivo > Guardar.


Nota: Si la opcin para Guardar aparece inactiva (en gris), el mdulo ya est
guardado.

Creacin de objetos de negocio


Este ejemplo utiliza un conjunto de objetos de negocio principales e hijo para
rellenar con los datos de cliente las tablas de la interfaz de Oracle E-Business Suite.
La operacin Create (crear) se utiliza para enviar los nuevos datos de cliente, as
como actualizaciones a los datos existentes de cliente. Este ejemplo tambin utiliza
un segundo conjunto de objetos para recuperar los datos de cliente directamente
de las tablas base Oracle, utilizando la operacin Retrieve (recuperar). Debe crear
los objetos de negocio tanto para la operacin Create (crear) como para la
operacin Retrieve (recuperar).

Objetos de negocio de la operacin Create (crear)


Para este ejemplo, se configuran cinco objetos de negocio para la operacin Create
(crear). El objeto Perfil de cliente es el objeto principal y el resto de los objetos se
estructuran como objetos de negocio hijo.

Objetos de negocio de las tablas de base de datos


La siguiente tabla lista las tablas de base de datos para el esquema AR con los
nombres de tabla, objeto de negocio y una breve descripcin de la informacin que
contiene cada objeto.
Nota: Para obtener ms informacin sobre los datos de la tabla, consulte la
documentacin para aplicaciones Oracle, especialmente la seccin de la gua
del usuario de Receivables que describe la interfaz del cliente.
Tabla 3. Tablas de base de datos para el esquema de AR
Nombre de la tabla

Objeto de negocio

Descripcin

AR.RA_CUSTOMER_
PROFILES_INT_ALL

ArIbm_C_Cust_Profile

Tabla de la interfaz del


Perfil de cliente, que
contiene informacin de
alto nivel sobre el cliente

AR.RA_CUSTOMERS_
INTERFACE_ALL

ArIbm_C_Cust_Interface

Tabla principal para


clientes, as como para
direcciones de cliente

AR.RA_CONTACT_
PHONES_INT_ALL

ArIbm_C_Contacts

Informacin de contacto y
de telfono

AR.RA_CUST_PAY_
METHOD_INT_ALL

ArIbm_C_Pay_Methods

Mtodos de pago asociados


con el cliente

AR.RA_CUSTOMER_
BANKS_INT_ALL

ArIbm_C_Cust_Banks

Bancos asociados con el


cliente

Objetos de negocio de la operacin Retrieve (recuperar)


Los objetos de negocio para la operacin Retrieve (recuperar) se almacenan en las
tablas base Oracle E-Business Suite. Debido a que la operacin Retrieve (recuperar)
no modifica los valores de las tablas base, puede recuperar los datos de estas tablas
directamente. No necesita utilizar tablas de la interfaz de usuario.

26

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Objetos de negocio de una tabla base


La siguiente tabla muestra la estructura de los objetos de negocio para la operacin
Retrieve (recuperar) de las tablas base, incluyendo el nombre de tabla, el nombre
de objeto de negocio y la descripcin. La siguiente seccin muestra la relacin de
los objetos de negocio que configura para la operacin Retrieve (recuperar).
Tabla 4. Objetos de negocio para la operacin Retrieve en las tablas base
Nombre de la tabla

Objeto de negocio

Descripcin

AR.HZ_CUST_ACCOUNTS

ArIbm_R_Cust_Accounts

Nmero de cliente, tipo


y otra informacin de
cliente.

AR.HZ_CUSTOMER_
PROFILES

ArIbm_R_Profiles

Informacin de perfil de
alto nivel para el cliente.

AR.HZ_PARTIES

ArIbm_R_Parties

Nombre del cliente y, si


se trata de una persona
y no de un negocio, los
detalles de la persona.

AR.HZ_PARTY_SITES

ArIbm_R_Party_Sites

Enlaces entre los ID de


direccin de cliente y los
ID de ubicacin de la
direccin.

AR.HZ_CUST_
ACCT_SITES_ALL

ArIbm_R_Acct_Sites

ID de direccin.

AR.HZ_CUST_
SITE_USES_ALL

ArIbm_R_Site_Uses

Propsitos de direccin
comercial del cliente
(BILL_TO, SHIP_TO,
etc.).

AR.HZ_LOCATIONS

ArIbm_R_Locations

Detalles de direccin.

AR.HZ_CONTACT_POINTS

ArIbm_R_Contacts_Sites

Detalles de contacto y
nmero de telfono. La
tabla se lista dos veces,
porque tanto sites como
customers
(PARTY_SITES y
PARTIES) utilizan la
misma tabla para los
detalles de contactos.

AR.HZ_CONTACT_POINTS

ArIbm_R_Contacts_Customer

Detalles de contacto y
nmero de telfono. La
tabla se lista dos veces,
porque tanto sites como
customers
(PARTY_SITES y
PARTIES) utilizan la
misma tabla para los
detalles de contactos.

Relacin de los objetos de negocio


Para que la operacin Retrieve (recuperar) sea satisfactoria, los enlaces que
conectan el objeto de cliente a sus objetos hijo deben coincidir con los objetos de la
base de datos Oracle. El diagrama siguiente muestra las relaciones de los objetos
que debe configurar para la operacin Retrieve (recuperar).
Captulo 6. Ejemplos

27

ArIbm_R_Cust_Accounts

ArIbm_R_Parties

ArIbm_R_Profiles

ArIbm_R_Contacts_Customer

ArIbm_R_Acct_Sites

ArIbm_R_Site_Uses

ArIbm_R_Party_Sites

ArIbm_R_Locations

ArIbm_R_Contacts_Sites

Figura 8. Relaciones de objetos para la operacin Retrieve (recuperar)

Para crear los objetos, cree los objetos hijo y establezca la relacin de clave fornea
de informacin especfica de la aplicacin entre los objetos padre e hijo. Para
obtener ms informacin sobre la naturaleza de los objetos de negocio, consulte la
seccin Business objects del manual WebSphere Adapters: Adapter for JDBC User
Guide. Para ver esa documentacin, consulte http://publib.boulder.ibm.com/
infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

Creacin de objetos para la operacin Create (crear)


Necesita crear los objetos de negocio hijo y padre para la operacin Create (crear).
Adapter para JDBC procesa los objetos de negocio creando filas en las tablas de
base de datos correspondientes de Oracle E-Business Suite.
Cmo realizar esta tarea
1. Seleccione un objeto de nivel superior
En la perspectiva Integracin empresarial de WebSphere Integration Developer,
expanda el mdulo Oracle_Outbound.
Expanda Tipos de datos. Efecte una doble pulsacin en el objeto
ArIbm_C_Cust_Profile.
2. Aada un hijo al objeto de nivel superior
a. En la parte superior de la ventana Objeto de negocio, pulse el botn para
aadir un atributo a un objeto de negocio.

28

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Figura 9. Adicin de un atributo

b. En la vista Propiedades, pulse la pestaa Descripcin y especifique los


valores para los atributos que se muestran en la figura siguiente.
v En el campo Nombre, especifique Direcciones.
v En el campo Tipo, pulse la flecha para visualizar la lista y seleccione
ArIbm_C_Cust_Interface.
v Seleccione el recuadro de seleccin Matriz.

Figura 10. Entradas de atributo

3. Aada los objetos hijo restantes


Utilice los dos pasos anteriores para aadir los objetos de negocio hijo
restantes. La tabla siguiente muestra los atributos de nombre y tipo que se
deben especificar para cada objeto de negocio hijo.
Tabla 5. Atributos de nombre y tipo
Nombre

Tipo

Contactos

ArIbm_C_Contacts

Bancos

ArIbm_C_Cust_Banks

MtodosPago

ArIbm_C_Pay_Methods

La siguiente figura muestra el aspecto que tiene el conjunto de objetos despus


del procedimiento de creacin.

Captulo 6. Ejemplos

29

Figura 11. Conjunto de objetos de negocio creados para la operacin Create (crear)

4. Guarde el mdulo
En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.
En la barra de mens, seleccione Archivo > Guardar.

Creacin de objetos para la operacin Retrieve (recuperar)


Para crear los objetos de negocios para la operacin Retrieve (recuperar), debe
establecer una relacin entre los objetos de negocio padre e hijo. Adapter para
JDBC procesa los objetos de negocio recuperando filas de las tablas base
correspondientes de Oracle E-Business Suite.
Acerca de esta tarea
Utilice los pasos descritos en este procedimiento para crear un objeto de negocio
de nivel superior y aadir sus objetos hijo, y para crear los objetos restantes para la
operacin Retrieve (recuperar). Despus de haber creado el objeto de nivel
superior, utilice la informacin en la tabla proporcionada para aadir objetos hijo y
establecer los valores de clave fornea.
Cmo realizar esta tarea
1. Seleccione un objeto de nivel superior
En la perspectiva Integracin empresarial de WebSphere Integration Developer,
expanda el mdulo Oracle_Outbound.
Expanda Tipos de datos. Efecte una doble pulsacin en el objeto
ArIbm_R_Cust_Accounts.
2. Establezca el valor de Clave primaria para el objeto
En la ventana Objeto de negocio, pulse el atributo cust_account_id.
En la vista Propiedades, pulse la pestaa Informacin de aplicacin.
En la ventana Atributo cust_account_id, en el recuadro Propiedades de
elemento ASI, en la columna situada a la derecha de jdbcasi:PrimaryKey,
cambie el valor a true.

30

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Figura 12. Establecimiento de la clave primaria

3. Aada el primer objeto de negocio hijo


a. En la parte superior de la ventana Objeto de negocio, pulse el botn para
aadir un atributo a un objeto de negocio.
b. En la vista Propiedades, pulse la pestaa Descripcin y especifique los
valores para el atributo.
v En el campo Nombre, especifique Perfiles.
v En el campo Tipo, utilice las flechas para seleccionar
ArIbm_R_Cust_Profiles.
v Seleccione el recuadro de seleccin Matriz.
4. Aada los restantes objetos de negocio hijo al objeto de nivel superior
Repita el paso anterior para aadir dos o ms objetos de negocio hijo al objeto
ArIbm_R_Cust_Accounts. La tabla siguiente muestra los atributos de nombre y
tipo que se deben especificar para cada objeto de negocio hijo.
Tabla 6. Atributos de nombre y tipo
Nombre

Tipo

Parties

ArIbm_R_Parties

AccountSites

ArIbm_R_Acct_Sites

La siguiente figura muestra el aspecto que tiene el conjunto de objetos despus


del procedimiento de creacin.

Captulo 6. Ejemplos

31

Figura 13. Conjunto de objetos creados para la operacin Retrieve (recuperar)

5. Cree los objetos de negocio restantes para la operacin Retrieve (recuperar)


Este paso describe cmo establecer el valor de Clave fornea y cmo aadir un
objeto hijo a los objetos de negocio restantes que necesita crear para la
operacin Retrieve (recuperar). La informacin especfica de la aplicacin (ASI)
de la Clave fornea permite que el adaptador recupere objetos hijo en base a un
valor de atributo en el objeto padre.
Establezca el valor de Clave fornea para los ocho objetos de la tabla
denominada Objetos que requieren valores de Clave fornea y objetos hijo.
Utilice el nombre y valor de atributo proporcionado en la tabla para cada
objeto.
Para los objetos de negocio de la tabla que tienen objetos hijos, necesita aadir
valores de objeto de negocio hijo. Especifique el Nombre y el Tipo de objeto
hijo proporcionado en la tabla para cada objeto hijo.
a. Establezca el valor de Clave fornea para el objeto
En la vista Integracin empresarial, efecte una doble pulsacin en el
nombre del objeto. Pulse el nombre de atributo que se proporciona en la
tabla para el objeto seleccionado.
En la vista Propiedades, pulse la pestaa Informacin de aplicacin.
En la ventana Atributo nombre de atributo, pulse con el botn derecho en el
recuadro Propiedades de elemento ASI. Seleccione Aadir despus de >
jdbcasi:ForeignKey.
En la columna situada a la derecha de jdbcasi:ForeignKey, establezca el
valor listado en la tabla para el objeto seleccionado.
b. Aada los objetos de negocio hijo
En la vista Integracin empresarial, efecte una doble pulsacin en el
nombre del objeto. En la parte superior de la ventana Objeto de negocio,
pulse el botn para aadir un atributo a un objeto de negocio.
En la vista Propiedades, pulse la pestaa Descripcin y especifique los
valores para el atributo.
v En el campo Nombre, especifique el nombre de objeto hijo de la tabla
para el objeto seleccionado.
v En el campo Tipo, utilice las flechas para seleccionar el tipo de objeto hijo
en la tabla para el mismo objeto.
v Seleccione el recuadro de seleccin Matriz.

32

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Tabla 7. Objetos que requieren valores de Clave fornea y objetos hijo


Objeto

Valores

ArIbm_R_Cust_Profiles

Atributo de ForeignKey = cust_account_id


Valor de ForeignKey = cust_account_id

ArIbm_R_Parties

Atributo de ForeignKey = party_id


Valor de ForeignKey = party_id
Objeto hijo:
Nombre = Contacts
Tipo = ArIbm_R_Contacts_Customer

ArIbm_R_Party_Sites

Atributo de ForeignKey = party_site_id


Valor de ForeignKey = party_site_id
Objeto hijo:
Nombre = Locations
Tipo = ArIbm_R_Locations
Objeto hijo:
Nombre = Contacts
Tipos = ArIbm_R_Contacts_Sites

ArIbm_R_Acct_Sites

Atributo de ForeignKey = cust_account_id


Valor de ForeignKey = cust_account_id
Objeto hijo:
Nombre = PartySites
Tipo = ArIbm_R_Party_Sites
Objeto hijo:
Nombre = SiteUses
Tipo = ArIbm_R_Site_Uses

ArIbm_R_Site_Uses

Atributo de ForeignKey = cust_acct_site_id


Valor de ForeignKey = cust_acct_site_id

ArIbm_R_Locations

Atributo de ForeignKey = location_id


Valor de ForeignKey = location_id

ArIbm_R_Contacts_Sites

Atributo de ForeignKey = owner_table_id


Valor de ForeignKey = party_site_id

ArIbm_R_Contacts_Customer

Atributo de ForeignKey = owner_table_id


Valor de ForeignKey = party_id

6. Guarde el mdulo
En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.
En la barra de mens, seleccione Archivo > Guardar.

Despliegue del proyecto del adaptador en el entorno de


prueba
Para probar la aplicacin del adaptador, en primer lugar necesita instalar el
mdulo SCA (Service Component Architecture) para el proceso de salida en el
cliente de prueba de integracin de WebSphere Integration Developer. El mdulo
SCA que contiene un archivo de importacin del EIS (sistema de informacin de la
empresa) se produce ejecutando el asistente Descubrimiento de empresa.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, pulse la pestaa Servidores para abrir la
vista Servidores.

Captulo 6. Ejemplos

33

Figura 14. Vista Servidor

2. Si WebSphere Process Server no se est ejecutando, pulse con el botn derecho


en el nombre del mismo y seleccione Iniciar. Una vez que se inicie, la entrada
Estado del mismo se actualizar a Iniciado.
3. Pulse con el botn derecho en el nombre de su WebSphere Process Server y
seleccione Aadir y eliminar proyectos.
4. En la lista Proyectos disponibles de la izquierda, seleccione el mdulo del
adaptador Oracle_OutboundApp y pulse Aadir. Pulse Finalizar.

Cmo probar la operacin Create (crear)


Despus de haber desplegado el modulo de proceso de salida en WebSphere
Process Server, pruebe la aplicacin del adaptador ensamblado utilizando el cliente
de prueba de integracin de WebSphere Integration Developer. Puede probar la
operacin Create (crear) y, a continuacin, la operacin Retrieve (recuperar).
Acerca de esta tarea
Para probar la operacin Create (crear), cree una entrada de cliente que tenga dos
direcciones y un nmero de telfono.
Cmo realizar esta tarea
1. Seleccione el mdulo a probar
En Websphere Integration Developer, pulse con el botn derecho del ratn en el
mdulo Oracle_Outbound y seleccione Probar > Probar mdulo.
2. Establezca los valores de prueba
En la ventana Oracle_Outbound_Test, utilice las flechas para establecer los
valores de prueba que se muestran en la tabla siguiente.
Tabla 8. Valores de prueba para la operacin Create (crear)
Elemento

Valor de prueba

Configuracin

Prueba de mdulo por omisin

Mdulo

Oracle_Outbound

Componente

JDBCOutboundInterface

Interfaz

JDBCOutboundInterface

Operacin

createArIbm_C_Cust_Profile

3. Establezca los valores de atributo para el objeto de negocio de entrada


Necesita establecer los valores de atributo para el objeto Perfil de cliente, que es
el objeto de nivel superior ArIbm_C_Cust_Profile. Debido a que este ejemplo
utiliza dos direcciones y un contacto, tambin necesita establecer valores para
los dos objetos hijo del tipo Contactos. Las tablas siguientes proporcionan los
valores para cada objeto e indican cualquier restriccin, como por ejemplo si el
valor tiene que ser exclusivo.
Oracle requiere valores de ID para la importacin. Estos valores representan los
valores de ID correspondientes para los objetos en el sistema desde el que se

34

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

originan los objetos. Los valores de ID se utilizan en mltiples objetos, de


forma que necesitar registra los valores que utilizar para poder especificarlos
de forma coherente para los distintos objetos. Para cada uno de los siguientes
cinco valores, cree valores de serie exclusivos de serie.
v CustomerReference#
v AddressReference#1
v AddressReference#2
v TelephoneReference#
v CustomerNameReference
Nota: Para obtener ms informacin sobre los valores necesarios y otros valores
permitidos para datos en las tablas de la interfaz Oracle, consulte la
documentacin para aplicaciones Oracle Applications, especficamente el
manual Oracle Receivables User Guide.
a. Establezca el verbo en Create (crear).
b. En la ventana Eventos del Diagrama de ensamblaje, en Parmetros de
solicitud inicial, pulse la columna Valor que aparece en la fila del nombre
de cada atributo cuyo valor necesita establecer y especifique el valor de las
tablas siguientes.

Figura 15. Valores de los atributos

Nota:
v Para establecer un valor para un atributo en <null>, pulse el
campo del valor para el atributo. Pulse la flecha y seleccione
<null> de la lista.

Captulo 6. Ejemplos

35

v Para aadir un objeto hijo, pulse con el botn derecho del ratn en
el atributo del tipo adecuado y seleccione Aadir elemento.
Especifique el nmero de elementos que est aadiendo para cada
atributo. En este ejemplo, especifique 2 cuando aada elementos
para el atributo ArIbm_R_Cust_Interface_All porque no hay dos
objetos hijo de ese tipo (dos direcciones) y especifique 1 cuando
aada elementos para el atributo ArIBM_C_Contacts porque exista
un objeto hijo de ese tipo (un contacto).

Figura 16. Utilizacin de Aadir elemento para aadir un objeto hijo


Tabla 9. Valores para el objeto de nivel superior
Atributo

Valor

Notas

Insert_update_flag

Orig_system_
customer_ref

CustomerReference #

Customer_profile_
class_name

DEFAULT

Credit_hold

Last_updated_by

-1

Last_update_date

2006-06-25 12:00:00

Fecha y hora de hoy. No


tiene que ser exacta.

Creation_date

2006-06-25 12:00:00

Fecha y hora de hoy. No


tiene que ser exacta.

Created_by

-1

Org_id

204

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

La tabla siguiente lista los valores para el nuevo elemento para el atributo
Addresses.

36

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Tabla 10. Valores para el nuevo elemento para el atributo Addresses


Atributo

Valor

Notas

Orig_system_
customer_ref

CustomerReference#

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Site_use_code

BILL_TO

Orig_system_
address_ref

AddressReference#

Insert_update_flag

Customer_name

CustomerNameReference

Customer_number

<null>

Customer_status

Primary_site_
use_flag

Location

<null>

Address1

Test Address 1

Address2

<null>

Address3

<null>

Address4

<null>

City

San Mateo

State

CA

Province

<null>

County

San Mateo

Postal_code

94010

country

US

Cust_category_code

CUSTOMER

Last_updated_by

-1

Last_update_date

2006-06-25 12:00:00

Created_by

-1

Creation_date

2006-06-25 12:00:00

Org_id

204

Customer_name_
phonetic

CustomerNameReference

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Tiene la opcin de utilizar su


propia informacin de
direccin.

Fecha y hora de hoy. No


tiene que ser exacta.

Fecha y hora de hoy. No


tiene que ser exacta.

Utilice el valor que ha


registrado.

La tabla siguiente lista los valores para el segundo elemento para el atributo
Addresses.

Captulo 6. Ejemplos

37

Tabla 11. Valores para el segundo elemento para el atributo Addresses


Atributo

Valor

Notas

Orig_system_
customer_ref

CustomerReference#

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Site_use_code

SHIP_TO

Orig_system_
address_ref

AddressReference#2

Insert_update_flag

Customer_name

CustomerNameReference

Customer_number

<null>

Customer_status

Primary_site_
use_flag

Location

<null>

Address1

Test Address 2

Address2

<null>

Address3

<null>

Address4

<null>

City

San Mateo

State

CA

Province

<null>

County

San Mateo

Postal_code

94010

country

US

Cust_category_code

CUSTOMER

Last_updated_by

-1

Last_update_date

2006-06-25 12:00:00

Created_by

-1

Creation_date

2006-06-25 12:00:00

Org_id

204

Customer_name_
phonetic

CustomerNameReference

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Tiene la opcin de utilizar su


propia informacin de
direccin.

Fecha y hora de hoy. No


tiene que ser exacta.

Fecha y hora de hoy. No


tiene que ser exacta.

Utilice el valor que ha


registrado.

La tabla siguiente lista los valores para un elemento para el atributo


Contacts.

38

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Tabla 12. Valores para un elemento para el atributo Contacts


Atributo

Valor

Notas

Orig_system_
contact_ref

<null>

Orig_system_
telephone_ref

TelephoneReference#

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Orig_system_
customer_ref

CustomerReference#

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Orig_system_
address_ref

AddressReference#1

Utilice el valor que ha


registrado. El valor debe ser
exclusivo.

Insert_update_flag

Contact_first_name

<null>

Contact_last_name

<null>

Contact_title

<null>

Contact_job_title

<null>

Telephone

5551212

Tiene la opcin de utilizar su


propio nmero de telfono.

Telephone_extension

1234

Utilice <null> si no tiene


uno.

Telephone_type

FAX

Telephone_area_code

650

Last_update_date

2006-06-25 12:00:00

Last_updated_by

-1

Creation_date

2006-06-25 12:00:00

Created_by

-1

Email_address

<null>

Org_id

204

Fecha y hora de hoy. No


tiene que ser exacta.

Fecha y hora de hoy. No


tiene que ser exacta.

4. Pulse Continuar. En la ventana Ubicacin de despliegue, seleccione el nombre


del servidor donde se desplegar el mdulo y pulse Finalizar. Aparecer
brevemente la ventana Iniciando el cliente de prueba de integracin.
5. Verifique si el cliente se ha importado satisfactoriamente
Inicie sesin en Oracle E-Business Suite y conmute a la responsabilidad de
Receivables Manager. Navegue hasta el men Customers > Standard (Clientes
> Estndar) para abrir la ventana Find/Enter Customers (Buscar/Especificar
clientes). Busque el cliente importado.
Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.
6. Escriba el nmero de cliente que se visualiza en la pantalla de cliente de
Oracle.
Ver este nmero al probar la operacin Retrieve (recuperar).

Captulo 6. Ejemplos

39

Cmo probar la operacin Retrieve (recuperar)


Despus de haber probado la operacin Create (crear) y de haber verificado que el
cliente importado se encuentra en las tablas de la interfaz de Oracle E-Business
Suite, pruebe la operacin Retrieve (recuperar).
Cmo realizar esta tarea
1. Obtenga un valor de ID de cuenta de cliente
Inicie la herramienta SQL*Plus o un programa similar para procesar mandatos
SQL.
Ejecute esta consulta: SQL> select cust_account_id from ar.hz_cust_accounts
where account_number = customer number;
donde customer number es el nmero que escribi al verificar el cliente
importado en Oracle E-Business Suite en el paso 5 de la seccin Cmo probar
la operacin Create (create).
Escriba el valor de cust_account_id de esta consulta para utilizar en el paso 4,
Establecer valor de atributo para el objeto de negocio de entrada
2. Seleccione el mdulo a probar
En la perspectiva Integracin empresarial de WebSphere Integration Developer,
pulse con el botn derecho en el mdulo Oracle_Outbound y seleccione Probar
> Probar mdulo.
3. Establezca los valores de prueba
En la ventana Oracle_Outbound_Test, utilice las flechas para establecer los
valores de prueba, tal como se muestra en la tabla siguiente:
Tabla 13. Valores de prueba para la operacin Retrieve (recuperar)
Elemento

Valor de prueba

Configuracin

Prueba de mdulo por omisin

Mdulo

Oracle_Outbound

Componente

JDBCOutboundInterface

Interfaz

JDBCOutboundInterface

Operacin

retrieveArIbm_R_Cust_Accounts

4. Establezca el valor de atributo para el objeto de negocio de entrada


En la ventana Eventos del Diagrama de ensamblaje, en Parmetros de solicitud
inicial, pulse la columna Valor que aparece en la fila del nombre del atributo
custaccountid. Establezca el valor para que coincida con el valor cust_account_id
de la consulta SQL que ha ejecutado en el paso 1, Obtener valor d ID de
cuenta de cliente.
No cambie los valores por omisin para los valores restantes.
Pulse Continuar. En la ventana Ubicacin de despliegue, seleccione el nombre
del servidor donde se desplegar el objeto y pulse Finalizar. Cuando el objeto
se est procesando, aparecer la ventana Iniciando el cliente de prueba de
integracin.
5. Verifique que el objeto devuelto coincide con la informacin de cliente que se
ha importado en las tablas de la interfaz de Oracle.

Cmo borrar el contenido del ejemplo


Despus de haber probado las operaciones Create (crear) y Retrieve (recuperar),
puede borrar el contenido del ejemplo para devolver los datos a su estado original.

40

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Necesita desactivar el cliente en Oracle E-Business Suite y, a continuacin, ejecutar


mandatos SQL para suprimir el procedimiento almacenado.
Cmo realizar esta tarea
1. Utilice Oracle E-Business Suite Client para iniciar sesin en la responsabilidad
de Receivables Manager. Navegue hasta el men Customers > Standard
(Clientes > Estndar) y busque el cliente. Cambie el valor de estado para el
cliente a Inactive (Inactivo). A continuacin guarde el cliente.
Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.
2. Utilice la herramienta SQL*Plus o un programa similar para procesar los
mandatos SQL, para conectarse a la base de datos y ejecutar mandatos para
borrar artefactos de la base de datos. Consulte al administrador de la base de
datos si necesita ayuda realizando esta tarea.

Ejemplo 2: Recepcin de datos de entrada desde el EIS


En este ejemplo, utiliza el sistema de sucesos en Oracle E-Business Suite para
rellenar una tabla de sucesos con sucesos de cliente, y tambin utiliza WebSphere
Adapter para JDBC para sondear sucesos y recuperar datos de cliente. Realizando
esta situacin de ejemplo, puede ver cmo configurar los flujos de informacin
entre Oracle E-Business Suite y WebSphere Process Server para sucesos de entrada.

Preparacin para el proceso de entrada


Realice los pasos de configuracin necesarios para preparar el entorno para el
proceso de entrada. stos incluyen un paso opcional que permite que los dos
sistemas mantengan datos paralelos sobre los clientes inactivos, un paso necesario
que inserta procedimientos almacenados en Oracle E-Business Suite y un paso
necesario que aumenta la eficacia de las bsquedas de base de datos realizadas por
el asistente Descubrimiento de servicios de empresa.

Modificacin de la operacin Delete (suprimir)


Esta tarea es opcional. En esta aplicacin de ejemplo, WebSphere Adapter para
JDBC se establece para pasar una operacin Delete (suprimir) al servidor para
objetos de cliente identificados como inactivos por los datos de sucesos enviados
desde Oracle. Si no desea que el adaptador pase una operacin Delete (suprimir)
para un cliente inactivo, modifique un script de SQL para cambiar la operacin de
Delete (suprimir) a Update (actualizar).
Acerca de esta tarea
Esta tarea slo es necesaria si desea cambiar la operacin que Adapter para JDBC
realiza en clientes que han pasado a estar inactivos en la base de datos Oracle.
Con Oracle E-Business Suite, puede pasar un cliente a inactivo pero no puede
suprimir los datos del cliente de las tablas base. Cuando el procedimiento
almacenado utilizado para el proceso de entrada recibe datos de sucesos de Oracle
que indican que un cliente ha pasado a estar inactivo, establece la operacin en
Delete (suprimir) para el objeto del cliente y, a continuacin, enva esa informacin
a la tabla de sucesos utilizada por el Adapter para JDBC. El adaptador utiliza esa
informacin para procesar el objeto y la pasa a WebSphere Process Server. Sin
embargo, si desea mantener el objeto de negocio en WebSphere Process Server en
lugar de suprimirlo, edite el paquete de SQL de ejemplo para cambiar la operacin
que el adaptador lee de la tabla de sucesos.
Captulo 6. Ejemplos

41

Cmo realizar esta tarea


1. Acceda a los archivos de ejemplo y abra el archivo
ibm_customer_event_pkg.pls en un editor de texto.
2. Elimine la sentencia siguiente del script:
IF v_status <> A THEN
v_object_function := Delete;
END IF;

3. Guarde el script.
4. Ejecute el script utilizando la herramienta SQL* Plus o una herramienta similar
para procesar sentencias SQL.

Insercin de artefactos en Oracle E-Business Suite


Debe ejecutar cuatro scripts de SQL para insertar procedimientos almacenados en
Oracle E-Business Suite. Estos procedimientos almacenados son necesarios al crear
el suceso y el programa simultneo en Oracle E-Business Suite.
Cmo realizar esta tarea
Ejecute los siguientes cuatro scripts de SQL en el orden de la lista.
v Ibm_websphere_event_table_create.sql
v Ibm_websphere_events_s.sql
v Ibm_customer_event_key_s.sql
v Ibm_customer_event_pkg.pls
Resultado
Estos scripts colocan los procedimientos almacenados en el esquema de Accounts
Receivable (AR) de Oracle.

Creacin de sinnimos
Puede crear sinnimos para aumentar la eficacia de las bsquedas de base de
datos realizadas durante el descubrimiento de servicios de empresa. Puede crear
sinnimos ejecutando un script de SQL.
Acerca de esta tarea
El tamao de la base de datos y el nmero de artefactos de la base de datos en la
base de datos de Oracle E-Business Suite pueden alargar el proceso de bsqueda
en listas grandes al ejecutar el asistente Descubrimiento de servicios de empresa
para generar objetos. La creacin de los sinnimos le ayudar a acelerar la
bsqueda. Adems, los sinnimos ayudan a resolver un problema relacionado con
el controlador de la base de datos Oracle. Este problema se documenta en la nota
tcnica de IBM 1218775.
Cmo realizar esta tarea
1. Abra la herramienta SQL*Plus (o un programa similar para procesar sentencias
SQL).
2. Ejecute el archivo ibm_create_synonyms.sql.
Por ejemplo, especifique: SQL> @C:\samplecontent\ibm_create_synonyms.sql

Configuracin en Oracle E-Business Suite


Esta aplicacin de ejemplo utiliza Business Event System de Oracle E-Business
Suite, un mecanismo para procesar datos en base a sucesos, suscripciones y

42

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

acciones que se definen. Antes de poder utilizarlo, debe completar las tareas de
configuracin en Oracle. Estas incluyen la creacin de un suceso personalizado, la
creacin de una suscripcin para el suceso y la creacin de un programa
simultneo para el mismo.

Creacin de un suceso personalizado


El Business Event System (BES) incorporado de Oracle E-Business Suite requiere
que los sucesos, suscripciones y un programa simultneo procesen datos. Cuando
crea un suceso personalizado, debe satisfacer uno de los requisitos del mecanismo
de BES.
Cmo realizar esta tarea
1. Acceda a la instancia de la aplicacin Oracle E-Business Suite como el usuario
SYSADMIN.
2. Utilice la responsabilidad de administrador de flujo de trabajo de aplicaciones
web.
3. Seleccione la opcin de men Business Events (Sucesos de negocio) y navegue
a la pgina donde puede crear un nuevo suceso de negocio.
4. Cree un nuevo suceso de negocio y especifique toda la siguiente informacin:
Tabla 14. Valores de sucesos de negocio
Campo

Valor

Nombre

ibm.apps.ar.customer.create

Nombre de visualizacin

IBM Create Customer Event

Estado

Habilitado

Nombre de propietario

IBM

Etiqueta de propietario

IBM

5. Guarde la definicin del suceso.


Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.

Creacin de una suscripcin para el suceso personalizado


Despus de crear un suceso personalizado, debe crear una suscripcin para el
Business Event System a utilizar con el suceso.
Cmo realizar esta tarea
1. Acceda al men Subscriptions (Suscripciones).
2. Navegue hasta la pgina donde puede crear una nueva suscripcin.
3. Cree la suscripcin, especificando la informacin en la tabla siguiente:
Tabla 15. Valores de suscripcin
Campo

Valor

Sistema

Nombre de la instancia de Oracle

Tipo de fuente

Local

Filtro de sucesos

ibm.apps.ar.customer.create

Fase

10

Estado

Habilitado

Datos de la regla

Mensaje

Captulo 6. Ejemplos

43

Tabla 15. Valores de suscripcin (continuacin)


Campo

Valor

Tipo de accin

Personalizado

En error

Detener y retrotraer

4. Navegue hasta la siguiente seccin, donde puede especificar informacin


adicional sobre la suscripcin, y especifique la informacin que se presenta en
la tabla.
Tabla 16. Valores adicionales de suscripcin
Campo

Valor

Funcin de la regla PL/SQL

ibm_websphere_pkg.rule_function

Prioridad

Normal

Nombre de propietario

IBM

Etiqueta de propietario

IBM

5. Guarde la suscripcin.
Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.

Creacin del programa simultneo


Business Event Systema de Oracle E-Business Suite requiere un programa
simultneo a fin de procesar datos basados en sucesos, suscripciones y acciones
que se definen. Despus de crear un suceso personalizado y una suscripcin, debe
crear un programa simultneo. Para hacer esto, cree un programa ejecutable, defina
las propiedades para el mismo y otrguele los permisos.
Creacin del ejecutable de programa simultneo:
El programa simultneo es necesario para definir acciones para Business Event
System. La primera tarea que debe realizar es crear el programa simultneo a fin
de crear un ejecutable de programa para el mismo. A continuacin, defina las
propiedades para ste y otrguele los permisos.
Antes de empezar
Asegrese de estar utilizando la responsabilidad de Administrador del sistema.
Cmo realizar esta tarea
1. Seleccione la opcin de men Concurrent: Program > Executable.
2. Especifique la siguiente informacin en el formulario:
Tabla 17. Valores de la definicin de programa simultneo

44

Campo

Valor

Ejecutable

IBMCUSTOMEREVENT

Nombre abreviado

IBMCUSTOMEREVENT

Aplicacin

Receivables

Mtodo de ejecucin

Procedimiento almacenado PL/SQL

Nombre del archivo de ejecucin

IBM_WEBSPHERE_PKG.RAISE_
CUSTOMER_EVENT

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

3. Guarde la definicin del ejecutable del programa.


Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.
Definicin de propiedades del programa simultneo:
Despus de haber creado el ejecutable del programa para el programa simultneo,
debe definir las propiedades para el programa simultneo. sta es la segunda de
tres tareas que debe completar para preparar el programa simultneo para que
pueda ser utilizado por Business Event System.
Cmo realizar esta tarea
1. Seleccione la opcin de men Concurrent: Program > Define.
2. Especifique la siguiente informacin:
Tabla 18. Valores de la definicin de programa simultneo
Campo

Valor

Programa

IBM Raise Customer Event

Nombre abreviado

IBMCUSTOMEREVENT

Aplicaciones

Receivables

Descripcin

IBM Raise Customer Event

Ejecutable

IBMCUSTOMEREVENT

3. Guarde la definicin de las propiedades del programa simultneo.


Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.
Habilitacin del programa simultneo:
Despus de haber creado un ejecutable de programa y definido las propiedades
para el programa simultneo, debe otorgar permisos al mismo que le permitan
direccionar las acciones del Business Event System. ste es el procedimiento final
que debe completar para preparar el programa simultneo para que pueda ser
utilizado por Business Event System.
Cmo realizar esta tarea
1. Seleccione la opcin de men Seguridad->Responsibilidad->Solicitud.
2. Cambie el formulario a la modalidad Especificar consulta.
3. En el campo del grupo, especifique: Receivables All
4. Ejecute la consulte.
5. Navegue hasta la seccin Solicitudes (detalles) y aada una nueva solicitud en
los detalles.
6. En el campo del nombre, especifique: IBM Raise Customer Event
7. Guarde los cambios.
Nota: Para obtener informacin especfica sobre la utilizacin de la interfaz de
Oracle, consulte la documentacin para aplicaciones Oracle.

Captulo 6. Ejemplos

45

Creacin del proyecto del adaptador en WebSphere


Integration Developer
Para desplegar el adaptador, en primer lugar debe configurar el proyecto del
adaptador JDBC en WebSphere Integration Developer. Debe crear un proyecto de
conector J2EE para el adaptador. A continuacin, debe importar el archivo
Resource Adapter Archive (RAR) de Adapter para JDBC en Websphere Integration
Developer.
Antes de empezar
Asegrese de tener acceso a la documentacin para Adapter para JDBC. Para ver
esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Cmo realizar esta tarea
1. Revise la informacin de la seccin Configuring the adapter for deployment
del manual WebSphere Adapters: Adapter for JDBC User Guide.
2. Realice la tarea Creating the adapter project del manual WebSphere Adapters:
Adapter for JDBC User Guide. Siga los pasos de esta seccin para configurar el
proyecto del adaptador en el espacio de trabajo de WebSphere Integration
Developer.

Adicin de dependencias externas de software


Despus de crear el proyecto en WebSphere Integration Developer, debe aadir
una referencia al controlador JDBC en el proyecto antes de poder configurar el
adaptador para el proceso de entrada.
Antes de empezar
Asegrese de tener acceso a la documentacin para Adapter para JDBC. Para ver
esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Cmo realizar esta tarea
Aadir dependencias externas de software
Realice la tarea Adding external software dependencies descrita en el manual
WebSphere Adapters: Adapter for JDBC User Guide para aadir una referencia al
controlador JDBC en el proyecto.

Configuracin del adaptador para el proceso de entrada


Para procesar datos enviados desde Oracle E-Business Suite a WebSphere Process
Server, debe crear objetos de negocio. Para realizar esta tarea, utilice el asistente
Descubrimiento de servicios de empresa en WebSphere Adapter para JDBC. En
primer lugar, necesita inicializar el asistente Descubrimiento de servicios de
empresa configurando los valores de las propiedades que permiten el adaptador
configurar un canal de comunicacin a una base de datos especfica.

Cmo establecer las propiedades de conexin para


Descubrimiento de servicios de empresa
Necesita establecer los valores de las propiedades de conexin del descubrimiento
de servicios de empresa para la instancia de la base de datos. Estas propiedades

46

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

permiten al asistente Descubrimiento de servicios de empresa en Adapter para


JDBC conectarse a la base de datos Oracle para el descubrimiento y para la
creacin de la descripcin del servicio.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, en la perspectiva Integracin empresarial,
seleccione Archivo > Nuevo > Descubrimiento de servicios de empresa.
2. En la ventana Seleccionar un adaptador de recursos de servicios de empresa,
seleccione Adaptador EMD JDBC y pulse Siguiente.
3. En la ventana Configurar valores para el agente de descubrimiento, especifique
la informacin para la base de datos en los campos de las propiedades de la
configuracin de la conexin. Son necesarios cuatro valores de propiedad de
conexin de descubrimiento de empresa para el ejemplo. La tabla siguiente lista
estas propiedades y sus descripciones. Para obtener detalles acerca de estas
propiedades, consulte Enterprise service discovery connection properties de
la seccin Reference del manual WebSphere Adapters: Adapter for JDBC User
Guide. Para ver esa documentacin, consulte http://publib.boulder.ibm.com/
infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Pulse Siguiente.
Tabla 19. Propiedades de conexin de descubrimiento de servicios de empresa
Propiedad

Descripcin

UserName

Cuenta de la base de datos que est utilizando.

Password

Contrasea para la cuenta que est utilizando.

DatabaseURL

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

JDBCDriverClass

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

Seleccin de objetos de negocio y servicios


Despus de configurar las propiedades de conexin, ejecute una consulta para los
objetos de la base de datos. Puede examinar la estructura del rbol de metadatos
para comprender la estructura de los objetos del EIS (sistema de informacin de la
empresa) y seleccionar los objetos necesarios para la descripcin del servicio. Para
este ejemplo, ejecuta una consulta sobre el esquema de Accounts Receivable (AR) y
selecciona sinnimos que representan las tablas de la interfaz de Oracle E-Business
Suite.
Cmo realizar esta tarea
1. Especifique las propiedades de filtro
En la ventana Buscar y descubrir servicios de empresa, pulse Editar consulta.
En la ventana Propiedades de filtro de la consulta, especifique AR en el campo
de la propiedad Filtro de nombre de esquema para visualizar el esquema de
Accounts Receivable (AR).
El campo de la propiedad Tipos lista las entradas siguientes: tablas, vistas,
procedimientos almacenados y sinnimos/apodos. Puede aadir o eliminar
nodos de esta lista.
Pulse Aceptar cuando haya finalizado.
2. Ejecute la consulta de metadatos
a. Visualice los objetos comprendidos en la consulta.
Captulo 6. Ejemplos

47

Pulse Ejecutar consulta. El esquema de AR y los elementos del esquema se


visualizan en el panel superior.
b. Expanda el esquema AR.
Expanda Sinnimos - Apodos
c. Seleccione los sinnimos
Seleccione cada uno de los sinnimos y pulse Aadir a lista de
importacin. Cuando haya finalizado, pulse Siguiente.
Los sinnimos son los siguientes:
1) AR.IBM_R_CUST_PROFILES
2) AR.IBM_R_CUST_ACCOUNTS
3)
4)
5)
6)
7)
8)
9)

AR.IBM_R_PARTIES
AR.IBM_R_ACCT_SITES
AR.IBM_R_SITE_USES
AR.IBM_R_PARTY_SITES
AR.IBM_R_LOCATIONS
AR.IBM_R_CONTACTS_CUSTOMER
AR.IBM_R_CONTACTS_SITES

Generacin de definiciones de objeto de negocio y artefactos


relacionados
Despus de que haya seleccionado los objetos de base de datos, deber especificar
los valores para las propiedades de seleccin para el archivo de importacin.
Cmo realizar esta tarea
1. Especifique el valor de NameSpace
En la ventana Configurar objetos del asistente Descubrimiento de servicios de
empresa, deje el valor por omisin para NameSpace.
2. Seleccione el Tipo de servicio
Seleccione Inbound para el campo Tipo de servicio.
3. Deje los valores por omisin para los otros campos.
Pulse Siguiente.

Configuracin de las propiedades del adaptador


Para configurar un canal de comunicaciones a una base de datos especfica para el
proceso de salida, configure las propiedades de especificacin de activacin y del
adaptador de recurso que el adaptador utiliza. Tambin necesita crear un mdulo
de integracin comercial que contenga todos los artefactos y los valores de
propiedad.
Cmo realizar esta tarea
1. Especifique el nombre de un nuevo mdulo para que albergue todos los
artefactos generados
En la ventana Generar artefactos, pulse Nuevo, junto al campo Mdulo. En la
ventana Nuevo proyecto de integracin, confirme que Crear un proyecto de
mdulo est seleccionado. En la ventana Nuevo mdulo, especifique
Oracle_Inbound y pulse Finalizar. Este mdulo albergar todos los artefactos
generados.
2. Establezca los valores de propiedad de configuracin
En la parte inferior de la ventana, pulse el botn Utilizar propiedades de
conexin descubiertas.

48

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Para el proceso de entrada, aparecern los campos de propiedades para las


propiedades de la fbrica de conexin y del adaptador de recursos. Para
Propiedades de especificacin de activacin, en Credenciales de usuario en el
campo Nombre de usuario, especifique el nombre de usuario de la base de
datos. En el campo Contrasea, especifique la contrasea de la base de datos
para ese nombre de usuario. En Varios, establezca el valor de Orden de
sucesos por en event_priority, event_time y el valor de Nombre de tabla de
sucesos en apps.ibm_websphere_events.
Para Propiedades del adaptador de recursos, en Varios, establezca el valor de
Proveedor de base de datos en Oracle. Pulse Finalizar.
Para obtener informacin sobre estas propiedades, consulte la seccin
Reference del manual WebSphere Adapters: Adapter for JDBC User Guide. Para
ver esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

Cmo guardar el proyecto del adaptador


Necesita guardar el mdulo de integracin comercial para el proceso de entrada
que contiene los artefactos y los valores de propiedad que ha creado.
Cmo realizar esta tarea
1. En la vista Integracin empresarial, pulse el mdulo Oracle_Inbound.
2. Seleccione Archivo > Guardar.
Nota: Si la opcin para Guardar aparece inactiva (en gris), el mdulo ya est
guardado.

Objetos de negocio de la operacin Retrieve (recuperar)


Los objetos de negocio para la operacin Retrieve (recuperar) se almacenan en las
tablas base Oracle E-Business Suite. Debido a que la operacin Retrieve (recuperar)
no modifica los valores de las tablas base, puede recuperar los datos de estas tablas
directamente. No necesita utilizar tablas de la interfaz de usuario.

Objetos de negocio de una tabla base


La siguiente tabla muestra la estructura de los objetos de negocio para la operacin
Retrieve (recuperar) de las tablas base, incluyendo el nombre de tabla, el nombre
de objeto de negocio y la descripcin. La siguiente seccin muestra la relacin de
los objetos de negocio que configura para la operacin Retrieve (recuperar).
Tabla 20. Objetos de negocio para la operacin Retrieve en las tablas base
Nombre de la tabla

Objeto de negocio

Descripcin

AR.HZ_CUST_ACCOUNTS

ArIbm_R_Cust_Accounts

Nmero de cliente, tipo


y otra informacin de
cliente.

AR.HZ_CUSTOMER_
PROFILES

ArIbm_R_Profiles

Informacin de perfil de
alto nivel para el cliente.

AR.HZ_PARTIES

ArIbm_R_Parties

Nombre del cliente y, si


se trata de una persona
y no de un negocio, los
detalles de la persona.

AR.HZ_PARTY_SITES

ArIbm_R_Party_Sites

Enlaces entre los ID de


direccin de cliente y los
ID de ubicacin de la
direccin.
Captulo 6. Ejemplos

49

Tabla 20. Objetos de negocio para la operacin Retrieve en las tablas base (continuacin)
Nombre de la tabla

Objeto de negocio

Descripcin

AR.HZ_CUST_
ACCT_SITES_ALL

ArIbm_R_Acct_Sites

ID de direccin.

AR.HZ_CUST_
SITE_USES_ALL

ArIbm_R_Site_Uses

Propsitos de direccin
comercial del cliente
(BILL_TO, SHIP_TO,
etc.)

AR.HZ_LOCATIONS

ArIbm_R_Locations

Detalles de direccin.

AR.HZ_CONTACT_POINTS

ArIbm_R_Contacts_Sites

Detalles de contacto y
nmero de telfono. La
tabla se lista dos veces,
porque tanto sites como
customers
(PARTY_SITES y
PARTIES) utilizan la
misma tabla para los
detalles de contactos.

AR.HZ_CONTACT_POINTS

ArIbm_R_Contacts_Customer

Detalles de contacto y
nmero de telfono. La
tabla se lista dos veces,
porque tanto sites como
customers
(PARTY_SITES y
PARTIES) utilizan la
misma tabla para los
detalles de contactos.

Relacin de los objetos de negocio


Para que la operacin Retrieve (recuperar) sea satisfactoria, los enlaces que
conectan el objeto de cliente a sus objetos hijo deben coincidir con los objetos de la
base de datos Oracle. El diagrama siguiente muestra las relaciones de los objetos
que debe configurar para la operacin Retrieve (recuperar).

50

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

ArIbm_R_Cust_Accounts

ArIbm_R_Parties

ArIbm_R_Profiles

ArIbm_R_Contacts_Customer

ArIbm_R_Acct_Sites

ArIbm_R_Site_Uses

ArIbm_R_Party_Sites

ArIbm_R_Locations

ArIbm_R_Contacts_Sites

Figura 17. Relaciones de objetos para la operacin Retrieve (recuperar)

Para crear los objetos, cree los objetos hijo y establezca la relacin de clave fornea
de informacin especfica de la aplicacin entre los objetos padre e hijo. Para
obtener ms informacin sobre los objetos de negocio, consulte la seccin Business
objects en WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa
documentacin, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/
v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

Creacin de objetos para la operacin Retrieve (recuperar)


Para crear los objetos de negocios para la operacin Retrieve (recuperar), debe
establecer una relacin entre los objetos de negocio padre e hijo. Adapter para
JDBC procesa los objetos de negocio recuperando filas de las tablas base
correspondientes de Oracle E-Business Suite.
Acerca de esta tarea
Utilice los pasos descritos en este procedimiento para crear un objeto de negocio
de nivel superior y aadir sus objetos hijo, y para crear los objetos restantes para la
operacin Retrieve (recuperar). Despus de haber creado el objeto de nivel
superior, utilice la informacin en la tabla proporcionada para aadir objetos hijo y
establecer los valores de clave fornea.
Cmo realizar esta tarea
1. Seleccione un objeto de nivel superior
En WebSphere Integration Developer en la perspectiva Integracin empresarial,
expanda el mdulo Oracle_Inbound.
Expanda Tipos de datos. Efecte una doble pulsacin en el objeto
ArIbm_R_Cust_Accounts.
Captulo 6. Ejemplos

51

2. Establezca el valor de Clave primaria para el objeto


En la ventana Objeto de negocio, pulse el atributo cust_account_id.
En la vista Propiedades, pulse la pestaa Informacin de aplicacin.
En la ventana Atributo cust_account_id, en el recuadro Propiedades de
elemento ASI, en la columna situada a la derecha de jdbcasi:PrimaryKey,
cambie el valor a true.

Figura 18. Establecimiento de la clave primaria

3. Aada el primer objeto de negocio hijo


a. En la parte superior de la ventana Objeto de negocio, pulse el botn para
aadir un atributo a un objeto de negocio.
b. En la vista Propiedades, pulse la pestaa Descripcin y especifique los
valores para el atributo.
v En el campo Nombre, especifique Perfiles.
v En el campo Tipo, seleccione ArIbm_R_Cust_Profiles en la lista.
v Seleccione el recuadro de seleccin Matriz.
4. Aada los restantes objetos de negocio hijo al objeto de nivel superior
Repita el paso anterior para aadir dos objetos de negocio ms al objeto
ArIbm_R_Cust_Accounts. La tabla siguiente muestra el nombre y tipo que se
debe especificar para cada objeto de negocio.
Tabla 21. Atributos de nombre y tipo
Nombre

Tipo

Parties

ArIbm_R_Parties

AccountSites

ArIbm_R_Acct_Sites

La siguiente figura muestra el aspecto que tiene el conjunto de objetos despus


del procedimiento de creacin.

52

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Figura 19. Conjunto de objetos creados para la operacin Retrieve (recuperar)

5. Cree los objetos de negocio restantes para la operacin Retrieve (recuperar)


Este paso describe cmo establecer el valor de Clave fornea y cmo aadir un
objeto hijo a los objetos de negocio restantes que necesita crear para la
operacin Retrieve (recuperar). La informacin especfica de la aplicacin (ASI)
de la Clave fornea permite que el adaptador recupere objetos hijo en base a un
valor de atributo en el objeto padre.
Necesita establecer el valor de Clave fornea para los ocho objetos de la tabla
denominada Objetos que requieren valores de Clave fornea y objetos hijo.
Utilice el nombre y valor de atributo proporcionado en la tabla para cada
objeto.
Para los objetos de negocio de la tabla que tienen objetos hijos, necesita aadir
valores de objeto de negocio hijo. Especifique el nombre y tipo de objeto hijo
proporcionado en la tabla para cada objeto hijo.
a. Establezca el valor de Clave fornea para el objeto
En la vista Integracin empresarial, efecte una doble pulsacin en el
nombre del objeto. Pulse el nombre de atributo que se proporciona en la
tabla para el objeto seleccionado.
En la vista Propiedades, pulse la pestaa Informacin de aplicacin.
En la ventana Atributo nombre de atributo, pulse con el botn derecho en el
recuadro Propiedades de elemento ASI. Seleccione Aadir despus de >
jdbcasi:ForeignKey.
En la columna situada a la derecha de jdbcasi:ForeignKey, establezca el
valor listado en la tabla para el objeto seleccionado.
b. Aada los objetos de negocio hijo
En la vista Integracin empresarial, efecte una doble pulsacin en el
nombre del objeto. En la parte superior de la ventana Objeto de negocio,
pulse el botn para aadir un atributo a un objeto de negocio.
En la vista Propiedades, pulse la pestaa Descripcin y especifique los
valores para el atributo.
v En el campo Nombre, especifique el nombre de objeto hijo de la tabla
para el objeto seleccionado.
v En el campo Tipo, seleccione el tipo de objeto hijo en la lista.
v Seleccione el recuadro de seleccin Matriz.
Captulo 6. Ejemplos

53

Tabla 22. Objetos que requieren valores de Clave fornea y objetos hijo
Objetos

Valores

ArIbm_R_Cust_Profiles

Atributo de ForeignKey = cust_account_id


Valor de ForeignKey = cust_account_id

ArIbm_R_Parties

Atributo de ForeignKey = party_id


Valor de ForeignKey = party_id
Objeto hijo:
Nombre = Contacts
Tipo = ArIbm_R_Contacts_Customer

ArIbm_R_Party_Sites

Atributo de ForeignKey = party_site_id


Valor de ForeignKey = party_site_id
Objeto hijo:
Nombre = Locations
Tipo = ArIbm_R_Locations
Objeto hijo:
Nombre = Contacts
Tipos = ArIbm_R_Contacts_Sites

ArIbm_R_Acct_Sites

Atributo de ForeignKey = cust_account_id


Valor de ForeignKey = cust_account_id
Objeto hijo:
Nombre = PartySites
Tipo = ArIbm_R_Party_Sites
Objeto hijo:
Nombre = SiteUses
Tipo = ArIbm_R_Site_Uses

ArIbm_R_Site_Uses

Atributo de ForeignKey = cust_acct_site_id


Valor de ForeignKey = cust_acct_site_id

ArIbm_R_Locations

Atributo de ForeignKey = location_id


Valor de ForeignKey = location_id

ArIbm_R_Contacts_Sites

Atributo de ForeignKey = owner_table_id


Valor de ForeignKey = party_site_id

ArIbm_R_Contacts_Customer

Atributo de ForeignKey = owner_table_id


Valor de ForeignKey = party_id

6. Guarde el mdulo
En la vista Integracin empresarial, pulse el mdulo Oracle_Inbound.
Seleccione Archivo > Guardar.

Creacin de un componente de entrada


Debido a que este ejemplo es una aplicacin autnoma, no se conecta a un punto
final de proceso como lo hara una aplicacin de produccin. Por lo tanto, antes de
poder desplegar el proyecto del adaptador, debe crear un componente que
recoger los sucesos de entrada, recuperar los datos y visualizar los datos
recuperados en la consola administrativa donde podr visualizarlos.

Creacin del componente


Utilice el Editor de ensamblaje de WebSphere Integration Developer para crear un
nuevo componente. Necesita hacer esto a fin de que la aplicacin de ejemplo de
entrada tenga un punto final que pueda percibir sucesos y recuperar y procesar
datos. Este procedimiento es necesario porque la aplicacin de ejemplo se
desplegar en un entorno de prueba.
Cmo realizar esta tarea

54

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

1. Abra el Diagrama de ensamblaje para el componente JDBCInboundInterface.


En la vista Integracin empresarial de WebSphere Integration Developer,
expanda el Mdulo Oracle_Inbound. Pulse con el botn derecho en
Oracle_Inbound, la primera entrada que aparecer debajo del mdulo
expandido y seleccione Abrir con > Editor de ensamblaje. Esto abre el
Diagrama de ensamblaje: JDBCInboundInterface.
2. Pulse el botn (Componente) de la paleta de herramientas. Se abrir una
segunda paleta.
3. En la segunda paleta, pulse el botn (Componente sin ningn tipo de
implementacin) que aparece en la parte superior de los iconos.
4. Pulse en el marco Diagrama de ensamblaje. Se crear el nuevo componente y
aparecer en el diagrama ensamblador como Componente1
5. Pulse Aceptar en el dilogo Aadir conexin.

Definicin de la implementacin
Para permitir que el componente recupere objetos enviados al almacn de sucesos
en Adapter para JDBC y los imprima en la consola administrativa, aada cdigo
que defina el comportamiento del nuevo componente de entrada.
Cmo realizar esta tarea
1. Pulse con el botn derecho en Componente1 en Diagrama de ensamblaje:
JDBCInboundInterface.
2. Pulse Generar implementacin Java.
3. En la ventana Generar implementacin, confirme que ha seleccionado paquete
por omisin y pulse Aceptar. Se visualiza la ventana Component1Impl.java.
4. Sustituya las secciones por omisin de la implementacin por el cdigo
(consulte la siguiente seccin) que indica al componente que recupere objetos
enviados al almacn de sucesos y los imprima en la consola administrativa.

Cdigo Java para la implementacin del componente de entrada


El cdigo Java personalizado sustituye al cdigo por omisin en el componente de
entrada. Se proporcionan tres bloques de cdigo para permitir la impresin en la
consola administrativa: uno para un objeto creado, otro para un objeto actualizado
y otro para un objeto suprimido.

Cdigo para imprimir un objeto creado


public void createArIbm_R_Cust_Accounts(
DataObject createArIbm_R_Cust_AccountsInput) {
System.out.println("End point for createArIbm_R_Cust_Accounts ");
int i = createArIbm_R_Cust_AccountsInput.getType().getProperties().size()-1;
DataObject dataObj = createArIbm_R_Cust_AccountsInput.getDataObject(i);
System.out.println("Data object to be traced: " + dataObj.getType().getName());
try
{
String xmlString = AdapterBOUtil.serializeDataObject(dataObj);
System.out.println(xmlString);
}
catch(Exception e)
{
System.out.println("Error in tracing the data object");
}
}

Captulo 6. Ejemplos

55

Cdigo para imprimir un objeto actualizado


public void updateArIbm_R_Cust_Accounts(
DataObject updateArIbm_R_Cust_AccountsInput) {
System.out.println("End point for updateArIbm_R_Cust_Accounts ");
int i = updateArIbm_R_Cust_AccountsInput.getType().getProperties().size()-1;
DataObject dataObj = updateArIbm_R_Cust_AccountsInput.getDataObject(i);
System.out.println("Data object to be traced: " + dataObj.getType().getName());
try
{
String xmlString = AdapterBOUtil.serializeDataObject(dataObj);
System.out.println(xmlString);
}
catch(Exception e)
{
System.out.println("Error in tracing the data object");
}
}

Cdigo para imprimir un objeto suprimido


public void deleteArIbm_R_Cust_Accounts(
DataObject deleteArIbm_R_Cust_AccountsInput) {
System.out.println("End point for deleteArIbm_R_Cust_Accounts ");
int i = deleteArIbm_R_Cust_AccountsInput.getType().getProperties().size()-1;
DataObject dataObj = deleteArIbm_R_Cust_AccountsInput.getDataObject(i);
System.out.println("Data object to be traced: " + dataObj.getType().getName());
try
{
String xmlString = AdapterBOUtil.serializeDataObject(dataObj);
System.out.println(xmlString);
}
catch(Exception e)
{
System.out.println("Error in tracing the data object");
}
}

Despliegue del proyecto del adaptador en el entorno de


prueba
Para probar la aplicacin del adaptador, en primer lugar necesita instalar el
mdulo SCA (Service Component Architecture) para el proceso de salida en el
cliente de prueba de integracin de WebSphere Integration Developer. El mdulo
SCA que contiene un archivo de exportacin del EIS (sistema de informacin de la
empresa) se produce ejecutando el asistente Descubrimiento de empresa.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, pulse la pestaa Servidores para abrir la
vista Servidores.

Figura 20. Vista Servidor

2. Si WebSphere Process Server no se est ejecutando, pulse con el botn derecho


en el nombre del mismo y seleccione Iniciar. Una vez que se inicie, la entrada
Estado del mismo se actualizar a Iniciado.

56

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

3. Pulse con el botn derecho del ratn en el nombre de su WebSphere Process


Server y seleccione Aadir y eliminar proyectos.
4. En la lista Proyectos disponibles de la izquierda, seleccione el mdulo del
adaptador Oracle_Inbound y pulse Aadir.
5. Pulse Finalizar.

Cmo probar la aplicacin del adaptador ensamblado


Pruebe el servicio generado para verificar que produce los resultados que se
esperan. Debe completar tres tareas para probar este ejemplo. En Oracle
Receivables, debe crear un cliente. A continuacin, debe ejecutar el programa
simultneo para emitir el suceso para crear el objeto de cliente. Finalmente, en
WebSphere Integration Developer, utilice el cliente de prueba para verificar si se ha
procesado el suceso.

Creacin de un cliente para probar la aplicacin del adaptador


ensamblado
Configure un adaptador en Oracle Receivables para probar el caso de ejemplo de
proceso de entrada.
Cmo realizar esta tarea
1. Inicie la sesin en la instancia de aplicaciones Oracle como un usuario de
Oracle E-Business Suite.
2. Seleccione la responsabilidad de gestor de Receivables.
Si esta responsabilidad no est disponible en la lista de responsabilidades, debe
aadirla con seguridad definida por el usuario.
3. Seleccione la opcin de men Customers -> Standard (Clientes->Estndar).
4. En la ventana Find/Enter Customer (Buscar/Especificar cliente), especifique el
nuevo nombre de cliente en el campo Name (Nombre) y pulse el botn Find
(Buscar).
5. En la ventana Cutomers - Standard (Clientes Estndar), pulse el botn New
(Nuevo) para crear un nuevo cliente.
6. Especifique toda la informacin necesaria, incluyendo la informacin de
direccin de facturacin, para crear un nuevo cliente.
7. Guarde la informacin.
Nota:
Para obtener informacin especfica sobre la utilizacin de la interfaz de Oracle,
consulte la documentacin para aplicaciones Oracle.

Ejecucin del programa simultneo para probar el ejemplo


Ejecute el programa simultneo en Oracle para procesar el suceso de cliente y
asegrese de que funciona de la forma esperada.
Cmo realizar esta tarea
1. Pulse View -> Requests (Ver->Solicitudes).
2. En la ventana Find Requests (Buscar solicitudes), pulse Submit a New Request
(Enviar nueva solicitud). Aparecer un recuadro de dilogo.
3. Confirme que el botn para Single Request (Solicitud nica) est seleccionado
en el recuadro de dilogo y, a continuacin, pulse OK (Aceptar).
4. Seleccione IBM Raise Customer Event en la lista Name (Nombre) y enve la
solicitud.
5. Si aparece una opcin para enviar otra solicitud, pulse No.
Captulo 6. Ejemplos

57

6. Despus de que la solicitud simultnea finalice con un estado normal, navegue


hasta el lugar donde pueda visualizar el registro de proceso.
La pantalla del registro muestra los detalles del suceso, incluyendo el ID de
cliente y la clave del suceso, para el cliente que lo ha creado.
7. Confirme que el registro se encuentra en la tabla de sucesos iniciando sesin en
el esquema APPS de la base de datos de Aplicaciones utilizando la herramienta
SQL*Plus.
Ejecute la sentencia:
select * from ibm_websphere_events where TRUNC(event_time) =
TRUNC(SYSDATE)

Cmo iniciar el cliente de prueba para que el mdulo del


adaptador recupere el suceso
En WebSphere Integration Developer, pruebe el mdulo para verificar que el
suceso de entrada se ha procesado y recibido.
Cmo realizar esta tarea
1. Seleccione el mdulo a probar
En Websphere Integration Developer, pulse con el botn derecho en
Oracle_Inbound y seleccione Probar > Conectar.
2. Pulse Continuar.
3. En la ventana Seleccionar ubicacin de despliegue, seleccione el servidor de
aplicaciones donde se ejecutar la aplicacin y, a continuacin, pulse Finalizar.
La ventana de prueba visualiza el suceso en la vista de Consola de WebSphere
Integration Developer.
4. Verifique que el objeto devuelto coincide con la informacin de cliente que se
esperaba del proceso de entrada.

Cmo borrar el contenido del ejemplo


Despus de haber probado la aplicacin, borre el contenido del ejemplo para
devolver los datos a su estado original. Debe desactivar el cliente en Oracle
E-Business Suite y ejecutar mandatos SQL para suprimir el procedimiento
almacenado.
Cmo realizar esta tarea
1. Desactive el cliente.
Utilice Oracle E-Business Suite Client para iniciar sesin en la responsabilidad
de Receivables Manager. Vaya al men Customers > Standard (Clientes >
Estndar) y busque el cliente. Quite la marca de seleccin del recuadro Active
(Activo) en la ventana Customer (Cliente) y guarde el cliente.
Para obtener informacin especfica sobre la utilizacin de la interfaz de Oracle,
consulte la documentacin para aplicaciones Oracle.
2. Utilice la herramienta SQL*Plus o un programa similar para procesar los
mandatos SQL, para conectarse a la base de datos y ejecutar mandatos para
borrar artefactos de la base de datos. Consulte al administrador de la base de
datos si necesita ayuda realizando esta tarea.
Elimine los artefactos siguientes:
v IBM_CUSTOMER_EVENT_KEY_S
v IBM_WEBSPHERE_PKG
v IBM_WEBSPHERE_EVENTS
Para eliminar tablas, ejecute el mandato drop.

58

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Ejemplo 3: Cmo llamar a la API de Oracle E-Business Suite para el


proceso de salida
El adaptador puede llamar directamente a cualquier API de Oracle E-Business
Suite que utilice parmetros de datos simples. Siga los pasos de este ejemplo para
llamar a una API que crea un ejecutable de programa simultneo para el proceso
de salida. Realizando este caso de ejemplo, puede ver cmo estructurar llamadas a
la API de datos simples entre el adaptador y una base de datos de Oracle
E-Business Suite.

Configuracin del adaptador para el proceso de salida para


llamadas a la API
Para configurar el adaptador para este ejemplo, debe crear un objeto de negocio
que represente la llamada a la API del procedimiento almacenado. Utilice el
asistente Descubrimiento de servicios de empresa en Adapter para JDBC para
realizar los pasos necesarios para completar esta tarea.

Generacin del objeto de negocio utilizando Descubrimiento de


servicios de empresa
Cree el objeto de negocio que representa la llamada a la API del procedimiento
almacenado. Haga esto utilizando el asistente Descubrimiento de servicios de
empresa de Adapter para JDBC. Configure los valores de las propiedades que
permiten al adaptador configurar un canal de comunicacin a una base de datos
especfica, ejecute una consulta de objetos de negocio y especifique los valores de
las propiedades de seleccin.
Cmo establecer las propiedades de conexin para Descubrimiento de servicios
de empresa:
Necesita establecer los valores de las propiedades de conexin del descubrimiento
de servicios de empresa para la instancia de la base de datos. Estas propiedades
permiten al asistente Descubrimiento de servicios de empresa en Adapter para
JDBC conectarse a la base de datos Oracle para el descubrimiento y para la
creacin de la descripcin del servicio.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, en la perspectiva Integracin empresarial,
seleccione Archivo > Nuevo > Descubrimiento de servicios de empresa.
2. En la ventana Seleccionar un adaptador de recursos de servicios de empresa,
seleccione Adaptador EMD JDBC y pulse Siguiente.
3. En la ventana Configurar valores para el agente de descubrimiento, especifique
la informacin para la base de datos en los campos de las propiedades de la
configuracin de la conexin. Son necesarios cuatro valores de propiedad de
conexin de descubrimiento de servicios de empresa para el ejemplo. La tabla
siguiente muestra estas propiedades y sus descripciones. Para obtener detalles
acerca de estas propiedades, consulte Enterprise service discovery connection
properties de la seccin Reference del manual WebSphere Adapters: Adapter
for JDBC User Guide. Para ver esa documentacin, consulte
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/
com.ibm.wsadapters602.jca_jdb.

Captulo 6. Ejemplos

59

Pulse Siguiente.
Tabla 23. Propiedades de conexin de descubrimiento de servicios de empresa
Propiedad

Descripcin

UserName

Cuenta de la base de datos que est utilizando.

Password

Contrasea para la cuenta que est utilizando.

DatabaseURL

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

JDBCDriverClass

Consulte Enterprise service discovery connection


properties en la seccin Reference del manual
WebSphere Adapters: Adapter for JDBC User Guide.

Seleccin de objetos de negocio y servicios:


Despus de configurar las propiedades de conexin, ejecute una consulta para los
objetos de la base de datos. Puede examinar la estructura del rbol de metadatos
para comprender la estructura de los objetos del EIS (sistema de informacin de la
empresa) y seleccionar los objetos necesarios para la descripcin del servicio. Para
este ejemplo, ejecuta una consulta sobre el esquema de las aplicaciones (APPS) y
selecciona el procedimiento almacenado que el objeto de negocio representar.
Cmo realizar esta tarea
1. Especifique las propiedades de filtro
En la ventana Buscar y descubrir servicios de empresa, pulse Editar consulta.
En la ventana Propiedades de filtro de la consulta, especifique APPS en el
campo de la propiedad Filtro de nombre de esquema para visualizar el
esquema de las aplicaciones (APPS).
El campo de la propiedad Tipos lista las entradas siguientes: tablas, vistas,
procedimientos almacenados y sinnimos - apodos. Elimine los nodos para
tablas, vistas y sinnimos - apodos y pulse Aceptar.
2. Ejecute la consulta de metadatos
a. Visualice los objetos comprendidos en la consulta
Pulse Ejecutar consulta. El esquema APPS y los elementos de datos del
esquema se visualizarn en el panel superior.
b. Seleccione el objeto a importar
Expanda el esquema APPS. Pulse Procedimientos almacenados pero no los
expanda. Utilice un filtro para ayudarle a ubicar y seleccionar el
procedimiento almacenado.
Pulse el botn del filtro. En la ventana Propiedades del filtro, especifique
EXECUTABLE en el campo Filtro de nombres de objeto y pulse Aceptar.
Expanda el nodo Procedimientos almacenados y seleccione
FND_PROGRAM.EXECUTABLE en la lista de procedimientos
almacenados. Pulse Aadir a lista de importacin.
Nota: Debido al gran nmero de procedimientos almacenados, es posible
que la lista no se rellene inmediatamente.
En la ventana Parmetros de configuracin para
FND_PROGRAM.EXECUTABLE, pulse Aceptar.
.

60

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Generacin de definiciones de objeto de negocio y artefactos relacionados:


Despus de que haya seleccionado objetos de base de datos, deber especificar
valores para las propiedades de seleccin para el archivo de importacin.
Cmo realizar esta tarea
1. Especifique el valor de NameSpace
En la ventana Configurar objetos del asistente Descubrimiento de servicios de
empresa, deje el valor por omisin para NameSpace.
2. Seleccione el tipo de servicio
Seleccione Outbound para el campo Tipo de servicio y confirme que Execute
es la nica operacin listada.
3. Deje los valores por omisin para todos los dems valores y pulse Siguiente.

Configuracin de las propiedades del adaptador


Para configurar un canal de comunicaciones a una base de datos especfica para el
proceso de salida, configure las propiedades de la fbrica de conexin gestionada
(J2C) y del adaptador de recursos que el adaptador utiliza. Tambin necesita crear
un mdulo de integracin comercial donde se guarden todos los artefactos y los
valores de propiedad.
Cmo realizar esta tarea
1. Especifique un nuevo nombre de mdulo
En la ventana Generar artefactos, pulse Nuevo junto al campo Mdulo. En
Nuevo proyecto de integracin, confirme que Crear un proyecto de mdulo
est seleccionado. En la ventana Nuevo mdulo, especifique Oracle_API y pulse
Finalizar. Este mdulo albergar todos los artefactos generados.
2. Establezca los valores de propiedad de configuracin
En la parte inferior de la ventana, pulse el botn Utilizar propiedades de
conexin descubiertas.
Aparecern los campos de propiedad para las propiedades de especificacin de
activacin y del adaptador de recursos. Para las Propiedades de
ActivationSpec, en Credenciales de usuario en el campo Nombre de usuario,
especifique el nombre de usuario de la base de datos. En el campo Contrasea,
especifique la contrasea de la base de datos.
Para Propiedades del adaptador de recursos, en Varios establezca el valor para
el campo Proveedor de base de datos en Oracle. Pulse Finalizar.
Para obtener informacin sobre estas propiedades, consulte la seccin
Reference del manual WebSphere Adapters: Adapter for JDBC User Guide. Para
ver esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/
dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

Cmo guardar el proyecto del adaptador


Necesita guardar el mdulo de integracin comercial para el proceso de salida que
contiene los artefactos y los valores de propiedad que ha creado.
Cmo realizar esta tarea
1. En la vista Integracin empresarial, pulse el mdulo Oracle_API.
2. Seleccione Archivo > Guardar.
Nota: Si la opcin Guardar aparece inactiva (en gris), el mdulo ya est
guardado.
Captulo 6. Ejemplos

61

Despliegue del proyecto del adaptador en el entorno de


prueba
La ejecucin del asistente de Enterprise Discovery da como resultado un mdulo
de Service Component Architecture (SCA) que contiene el archivo de importacin
del EIS (sistema de informacin de la empresa). Antes de poder probar la
aplicacin del adaptador, debe instalar el mdulo SCA para el proceso de salida en
el cliente de prueba de integracin de WebSphere Integration Developer.
Cmo realizar esta tarea
1. En WebSphere Integration Developer, pulse la pestaa Servidores para abrir la
vista Servidores.

Figura 21. Vista Servidor

2. Si WebSphere Process Server no se est ejecutando, pulse con el botn derecho


en el nombre del mismo y seleccione Iniciar. Una vez que se inicie, la entrada
Estado del mismo se actualizar a Iniciado.
3. Pulse con el botn derecho en el nombre de WebSphere Process Server y
seleccione Aadir y eliminar proyectos.
4. En la lista Proyectos disponibles de la izquierda, seleccione el mdulo del
adaptador Oracle_API y pulse Aadir.
5. Pulse Finalizar.

Cmo probar la aplicacin del adaptador ensamblado


Pruebe el servicio generado para verificar que produce los resultados que se
esperan. Utilice el cliente de prueba en WebSphere Integration Developer para
establecer valores de prueba y ejecutar el servicio. A continuacin, en Oracle
E-Business Suite, debe comprobar si el servicio se ha ejecutado correctamente.

Cmo probar el cliente de prueba de WebSphere Integration


Developer
Ahora que ha desplegado el mdulo de proceso de salida en WebSphere Process
Server, puede probar la aplicacin del adaptador ensamblado utilizando el cliente
de prueba de integracin de WebSphere Integration Developer. Despus de probar
en el cliente de prueba de WebSphere Integration Developer, verifique los
resultados en Oracle E-Business Suite.
Cmo realizar esta tarea
1. Seleccione el mdulo a probar
En Websphere Integration Developer, pulse con el botn derecho del ratn en el
mdulo Oracle_API y seleccione Probar > Probar mdulo.
2. Establezca los valores de prueba
En la ventana Oracle_API_Test, utilice las flechas para establecer los valores de
prueba, tal como se muestra en la tabla siguiente:

62

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Tabla 24. Valores de prueba


Elemento

Valor de prueba

Configuracin

Prueba de mdulo por omisin

Mdulo

Oracle_API

Componente

JDBCOutboundInterface

Interfaz

JDBCOutboundInterface

Operacin

executeAppsFnd_ProgramU46Executable

3. Establezca los siguientes valores de atributo para el objeto de negocio de


entrada:
Tabla 25. Valores de atributo para el objeto de negocio de entrada
Nombre de atributo

Valor

executable

IBMSAMPLENAME
Este valor debe ser exclusivo cada vez que se procesa
el suceso

application

AR

Short_name

IBMSAMPLENAME
Este valor debe ser exclusivo cada vez que se procesa
el suceso

Descripcin

Definicin de ejecutable de programa simultneo

Execution_method

Procedimiento almacenado PL/SQL

Execution_file_name

TEST_PACKAGE.TEST_PROCEDURE

Subroutine_name

<null>

Icon_name

<null>

Language_code

US

Execution_file_path

<null>

4. Pulse Continuar.
5. En la ventana Ubicacin de despliegue, seleccione el nombre de su WebSphere
Process Server y pulse Finalizar.

Verificacin de los resultados de la prueba en Oracle E-Business


Suite
Despus de ejecutar la prueba en el cliente de prueba de integracin de WebSphere
Integration Developer, verifique si el programa simultneo se ha creado en Oracle
E-Business Suite.
Cmo realizar esta tarea
1. Inicie la sesin en Oracle E-Business Suite y seleccione la responsabilidad de
Administrador del sistema.
2. Seleccione la opcin de men Concurrent Program > Executable (Programa
simultneo > Ejecutable).
3. En la ventana Concurrent Program Executable (Ejecutable de programa
simultneo), especifique IBMSAMPLENAME en el campo Executable (Ejecutable).
4. Ejecute la consulta.

Captulo 6. Ejemplos

63

Cmo borrar el contenido del ejemplo


Despus de probar y verificar los resultados de la prueba, borre el contenido del
ejemplo para devolver los datos a su estado original en Oracle E-Business Suite.
Cmo realizar esta tarea
1. Inicie la sesin en Oracle E-Business Suite y seleccione la responsabilidad de
Administrador del sistema.
2. Seleccione la opcin de men Concurrent Program > Executable (Programa
simultneo > Ejecutable).
3. En la ventana Concurrent Program Executable (Ejecutable de programa
simultneo), especifique IBMSAMPLENAME en el campo Executable (Ejecutable).
4. Ejecute la consulta.
5. Despus de que se haya ejecutado la consulta, pulse Edit (Editar) y a
continuacin pulse Delete (Suprimir).
6. Guarde los cambios.

Visualizacin de los artefactos del adaptador de ejemplo


Para ver los artefactos de ejemplo para cada ejemplo, importe en IBM WebSphere
Integration Developer los archivos de referencia incluidos con el adaptador. Tenga
en cuenta que estos artefactos slo son para su referencia. Probablemente no se
ejecutarn en su entorno del sistema de informacin de empresa. Si no ha
realizado los pasos de los ejemplos, puede de todas formas utilizar los archivos de
referencia para ver ejemplos de artefactos generados correctamente antes de crear
los suyos propios.
Antes de empezar
Localice los archivos de referencia en el subdirectorio referencefiles del directorio
samples. Existe un archivo zip de intercambio de proyecto para cada ejemplo. Por
ejemplo, Tutorial1.zip es para el ejemplo 1.
Importante: No modifique ni utilice los artefactos proporcionados en los archivos
de referencia. Se proporcionan exclusivamente para su visualizacin.
Los archivos de referencia no incluyen bibliotecas de terceros. Una vez importados
en IBM WebSphere Integration Developer, es posible que los archivos de referencia
generen mensajes de error de compilacin debido a la falta de bibliotecas
dependientes. Es posible que los artefactos en los archivos de referencia no sean
compatibles con el sistema de informacin de empresa (EIS) que est utilizando.
Varan en base a la versin y la configuracin del EIS.
Los artefactos se han generado con la versin 11.5.10.2 de Oracle E-Business Suite.
Acerca de esta tarea
Importe los archivos de referencia en WebSphere Integration Developer para ver
los artefactos de ejemplo asociados con cada ejemplo.
Cmo realizar esta tarea
1. En la perspectiva Integracin empresarial de WebSphere Integration Developer,
pulse Archivo Importar.
2. En la ventana Importar, seleccione Intercambio de proyecto y pulse Siguiente.

64

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

3. Seleccione el archivo de intercambio de proyecto que contiene los artefactos de


la gua de aprendizaje que desea visualizar.
4. Importe todos los proyectos en el archivo de intercambio de proyecto pulsando
Seleccionar todo.
5. Pulse Finalizar.
Resultado
Un mdulo de integracin comercial se crea con los artefactos siguientes:
v Definicin de importacin y exportacin de servicios
v Objetos de negocio (objetos de datos de servicios)
v Interfaces.

Informacin de resolucin de problemas para las aplicaciones de


ejemplo
Si encontrara problemas al ejecutar las tareas para estos ejemplos, podran estar
relacionados con la ejecucin de Adapter para JDBC o con la interaccin con la
base de datos Oracle. Se describen dos problemas conocidos.

Los objetos tardan mucho tiempo en generarse


El tiempo que se tarda en generar objetos vara segn la potencia del sistema de
hardware en el que est ejecutando Oracle E-Business Suite.

Durante la operacin Create (crear), los objetos no son movidos


a las tablas base
Durante la operacin Create (crear), despus de que el adaptador haya establecido
los valores en las tablas de la interfaz, se realiza una llamada a la funcin Oracle,
utilizando un procedimiento almacenado. La llamada a la funcin mueve los datos
de las tablas de la interfaz Oracle a las tablas base. Si se produce un problema al
realizar esta llamada a la funcin, Oracle graba cdigos de error en la columna en
las tablas de la interfaz denominadas INTERFACE_STATUS.
Si un objeto de cliente no aparece en la aplicacin despus de haber ejecutado la
operacin Create (crear), pero Adapter para JDBC no informa de errores, debe
consultar la columna INTERFACE_STATUS en cada tabla de la interfaz para ver si
se ha informado de errores. Estos errores podran ser debidos a que no se hayan
establecido los valores necesarios o a la utilizacin de un nmero de referencia o
un nmero de cliente que ya est en las tablas base de la aplicacin Oracle.
Nota: Para obtener ms informacin sobre los cdigos de error para esta columna,
consulte la documentacin para aplicaciones Oracle.
En un entorno de produccin, estos errores se pueden detectar de varias maneras.
Puede ejecutar una instancia separada de Adapter para JDBC para que busque
errores en estas columnas e informe de los mismos. O bien puede crear un flujo de
trabajo Oracle para que compruebe si hay errores e informe de ellos utilizando el
sistema de informes de Oracle E-Business Suite.
Para problemas encontrados al ejecutar Adapter para JDBC, consulte la seccin
Configuring troubleshooting tools del manual WebSphere Adapters: Adapter for
JDBC User Guide. Describe cmo habilitar el registro y el rastreo, cmo habilitar
Captulo 6. Ejemplos

65

Common Event Infrastructure y cmo instalar IBM Support Assistant. Para ver esa
documentacin, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/
v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

66

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 7. Informacin de consulta


Se proporciona informacin detallada sobre los mensajes e informacin relacionada
con el producto para su consulta.

Mensajes
Los mensajes emitidos por IBM WebSphere Adapters se documentan en el centro
de informacin de WebSphere Adapters, versin 6.0.2.
Puede ver los mensajes del adaptador en el enlace siguiente: WebSphere Adapters
messages..

Informacin relacionada con el producto


Los siguientes enlaces, centros de informacin, Redbooks y pginas web contienen
informacin relacionada de IBM WebSphere Adapter para EL NOMBRE DEL
ADAPTADOR.

Informacin adicional que puede necesitar


Tabla 26. Informacin de WebSphere Adapters que puede necesitar
Informacin

Cmo encontrarla

Cmo editar objetos de


negocio utilizando el
Editor de objetos de
negocio

En el centro de informacin de IBM WebSphere Business


Process Management, que incluye documentacin para
WebSphere Integration Developer, busque el tema Editing
Business Objects (Edicin de objetos de negocio).

Cmo desinstalar un
adaptador desplegado

En la pgina de la biblioteca de WebSphere Application Server,


abra el centro de informacin para su versin de WebSphere
Application Server y busque el tema Uninstalling applications
(Desinstalacin de aplicaciones).

Informacin para productos relacionados


v
v
v
v
v
v

WebSphere Adapters, versin 6.0


WebSphere Business Integration Adapters
WebSphere Integration Developer
WebSphere Process Server
WebSphere Enterprise Service Bus
WebSphere Application Server

Redbooks
v Redbook de WebSphere Adapter Development
v Dominio de Redbooks de WebSphere

Recursos de developerWorks
v WebSphere Adapter Toolkit
v Zona de integracin de negocio WebSphere

IBM Corporation 2006

67

Soporte y asistencia
v Soporte del producto WebSphere Adapters
v Notas tcnicas de WebSphere Adapters - en el campo Additional search terms
(Trminos adicionales de bsqueda) especifique el nombre del adaptador y pulse
Go (Ir).

68

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Captulo 8. Glosario
El glosario de los trminos de IBM WebSphere Adapters se incluye en el centro de
informacin de WebSphere Adapters, versin 6.0.2.
Puede verlo en el enlace siguiente: WebSphere Adapters glossary.

Copyright IBM Corp. 2006

69

70

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

Avisos
Esta informacin se ha desarrollado para productos y servicios ofrecidos en
Estados Unidos.
Es posible que IBM no comercialice los productos, servicios o caractersticas que se
describen en este documento en otros pases. Consulte con su representante local
de IBM para obtener informacin sobre los productos y servicios actualmente
disponibles en su rea. Cualquier referencia a un producto, programa o servicio de
IBM no pretende indicar o implicar que slo se pueda utilizar dicho producto,
programa o servicio de IBM. En su lugar, se puede utilizar cualquier producto,
programa o servicio funcionalmente equivalente que no infrinja los derechos de
propiedad intelectual de IBM. Sin embargo, es responsabilidad del usuario evaluar
y verificar el funcionamiento de cualquier producto, programa o servicio no IBM.
IBM puede tener patentes o solicitudes de patente pendientes que traten el tema
descrito en este documento. El suministro de este documento no le otorga ninguna
licencia sobre estas patentes. Puede enviar consultas sobre licencias, por escrito, a:
IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785
EE.UU.
Para preguntas sobre licencias relativas a la informacin de doble byte (DBCS),
pngase en contacto con el Departamento de propiedad intelectual de IBM de su
pas o enve sus preguntas, por escrito, a:
IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo
106-0032, Japn
El prrafo siguiente no es aplicable en el Reino Unido ni en ningn otro pas
donde estas disposiciones no sean coherentes con la legislacin local:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA
ESTA PUBLICACIN TAL CUAL, SIN GARANTAS DE NINGN TIPO,
EXPLCITAS O IMPLCITAS, INCLUYENDO, PERO SIN LIMITARSE A, LAS
GARANTAS IMPLCITAS DE NO INFRINGIMIENTO, MERCANTIBILIDAD O
ADECUACIN A UNA FINALIDAD DETERMINADA. Algunos estados no
permiten la renuncia a las garantas explcitas o implcitas en algunas transacciones
y, por lo tanto, puede que esta declaracin no sea aplicable en su caso.
Esta informacin puede incluir imprecisiones tcnicas o errores tipogrficos. Se
realizan periodicamente cambios en la informacin aqu contenida; estos cambios
se incorporarn en las nuevas ediciones de la publicacin. IBM puede realizar
mejoras y/o cambios en los productos y/o programas descritos en esta publicacin
en cualquier momento y sin aviso previo.
Cualquier referencia en esta informacin a sitios web que no sean de IBM se
proporciona slo para su comodidad y no ninguna manera sirve como una
aprobacin de estos sitios web. Los materiales en estos sitios web no forman parte
de los materiales para este producto de IBM y la utilizacin de estos sitios web la
realiza el usuario bajo su propia responsabilidad.
IBM puede utilizar o distribuir cualquier informacin proporcionada por el usuario
de la forma que crea adecuada sin incurrir en ninguna obligacin con el usuario.

Copyright IBM Corp. 2006

71

Los usuarios con licencia de este programa que deseen tener informacin sobre el
mismo con el fin de habilitar: (i) el intercambio de informacin entre programas
creados independientemente y otros programas (incluyendo ste) y (ii) la
utilizacin mutua de la informacin que se ha intercambiado, deben ponerse en
contacto con:
IBM Corporation 577 Airport Blvd., Suite 800 Burlingame, CA 94010 EE.UU.
Esta informacin puede estar disponible, sujeta a los trminos y condiciones,
incluyendo en algunos casos, el pago de una tarifa.
El programa bajo licencia descrito en este documento y todo el material bajo
licencia disponible para el mismo lo proporciona IBM bajo los trminos del
Acuerdo de cliente de IBM, el Acuerdo de licencia de programa internacional de
IBM o cualquier acuerdo equivalente entre ambas partes.
Los datos de rendimiento contenidos aqu se han determinado en un entorno
controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos
pueden variar de forma significativa. Algunas mediciones se han realizado en
sistemas a nivel de desarrollo y no existe ninguna garanta de que estas mediciones
sern las mismas en sistemas disponibles comercialmente. Adems, algunas
mediciones se han calculado mediante extrapolacin. Los resultados reales pueden
variar. Los usuarios de este documento deben verificar los datos disponibles para
su entorno especfico.
La informacin relativa a los productos que no son de IBM se ha obtenido de los
proveedores de estos productos, sus anuncios publicados y otras fuentes
disponibles pblicamente. IBM no ha probado estos productos y no puede
confirmar la precisin del rendimiento, compatibilidad u otras afirmaciones
relacionadas con productos no IBM. Las preguntas sobre las capacidades de los
productos no IBM se debe dirigir a los proveedores de estos productos.
Todas las declaraciones relativas a la direccin o las intenciones futuras de IBM
estn sujetas a cambiar o a ser retiradas sin aviso precio, y slo representan
propsitos y objetivos
Esta informacin contiene ejemplos de datos e informes utilizados en operaciones
comerciales diarias. Para ilustrarlos de la forma ms completa posible, los ejemplos
incluyen los nombres de personas, compaas, marcas y productos. Todos estos
nombres son ficticios y cualquier similitud con nombres y direcciones que utilice
una empresa comercial real son mera coincidencia.
LICENCIA DE COPYRIGHT:
Esta informacin contiene programas de aplicacin de ejemplo en lenguaje fuente,
que ilustran las tcnicas de programacin en varias plataformas operativas. Puede
copiar, modificar y distribuir estos programas de ejemplo de cualquier forma sin
pago a IBM, con fines de desarrollo, utilizacin, mrketing o distribucin de
programas de aplicacin que se adecuen a la interfaz de programacin de
aplicaciones para la plataforma operativa para la que estn escritos estos
programas de ejemplo. Estos ejemplos no se han probado completamente en todas
las condiciones. Por lo tanto, IBM no puede garantizar ni implicar la fiabilidad,
capacidad de servicio o funcin de estos programas.
Cada copia o cada parte de estos programas de ejemplo o cualquier trabajo
derivado debe incluir un aviso de copyright como el siguiente: (nombre de la

72

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario

empresa) (ao). Partes de este cdigo se derivan de IBM Corp. Programas de


ejemplo. Copyright IBM Corp. _especifique el ao o aos_. Reservados todos los
derechos.
Si est visualizando esta informacin en softcopy, es posible que las fotografas y
las ilustraciones en color no aparezcan.

Informacin de la interfaz de programacin


La informacin de la interfaz de programacin, si se proporciona, est destinada a
ayudarle a crear software de aplicacin utilizando este programa.
Las interfaces de programacin de uso general le permiten escribir software de
aplicacin que obtiene los servicios de las herramientas de este programa.
Sin embargo, esta informacin puede contener tambin informacin de
diagnsticos, modificaciones y ajustes. La informacin de diagnsticos,
modificaciones y ajustes se proporciona para ayudarle a depurar el software de
aplicacin.
Aviso: no utilice esta informacin de diagnsticos, modificaciones y ajustes como
una interfaz de programacin porque puede cambiar.

Marcas registradas y marcas de servicio


IBM y marcas registradas relacionadas: http://www.ibm.com/legal/
copytrade.shtml
Otros nombres de empresas, productos o servicios pueden ser marcas registradas o
de servicio de otros.
Este producto incluye software desarrollado por The Eclipse Project
(http://www.eclipse.org/).

Avisos

73

74

IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Gua del usuario