Spanish Wsa 20061222 Oraebiz

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 . . . . . . . . . . . . . . .
Cmo probar la aplicacin del adaptador ensamblado . . . . . . . . . .
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 . .
Cmo probar la aplicacin del adaptador ensamblado . . . . . . . . . .
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
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.
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
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
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
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
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
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
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.
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
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.
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
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.
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
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.
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.
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
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.
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
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.
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
Tabla 2. Propiedades de descubrimiento de servicios de empresa (continuacin)

Propiedad
Descripcin
JDBCDriverClass

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.
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
.
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.
24
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.
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/
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.
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
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.
ArIbm_R_Contacts_Customer
customers
(PARTY_SITES y
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_Parties
ArIbm_R_Profiles
ArIbm_R_Acct_Sites
ArIbm_R_Site_Uses
ArIbm_R_Party_Sites
ArIbm_R_Locations
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.
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
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.
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.
expanda el mdulo Oracle_Outbound.
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
Figura 12. Establecimiento de la clave primaria
3. Aada el primer objeto de negocio hijo

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.
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.
Nombre
Tipo
Parties
ArIbm_R_Parties
AccountSites
ArIbm_R_Acct_Sites

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 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
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
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.
32
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

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
Atributo de ForeignKey = owner_table_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.
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).
Para probar la operacin Create (crear), cree una entrada de cliente que tenga dos
direcciones y un nmero de telfono.
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
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
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

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
Tabla 10. Valores para el nuevo elemento para el atributo Addresses

Atributo
Valor
Notas
Orig_system_
customer_ref
CustomerReference#

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

exclusivo.

exclusivo.
Tiene la opcin de utilizar su

propia informacin de
direccin.



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#

exclusivo.
Site_use_code
SHIP_TO
Orig_system_
address_ref
AddressReference#2
Insert_update_flag
Customer_name
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

exclusivo.

exclusivo.

propia informacin de
direccin.



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

Contacts.
38
Tabla 12. Valores para un elemento para el atributo Contacts

Atributo
Valor
Notas
Orig_system_
contact_ref
<null>
Orig_system_
telephone_ref
TelephoneReference#

exclusivo.
Orig_system_
customer_ref
CustomerReference#

exclusivo.
Orig_system_
address_ref
AddressReference#1

exclusivo.
Insert_update_flag
Contact_first_name
<null>
Contact_last_name
<null>
Contact_title
<null>
Contact_job_title
<null>
Telephone
5551212

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


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).
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
pulse con el botn derecho en el mdulo Oracle_Outbound y seleccione Probar
> Probar mdulo.
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
Mdulo
Oracle_Outbound
Componente
Interfaz
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
Necesita desactivar el cliente en Oracle E-Business Suite y, a continuacin, ejecutar

mandatos SQL para suprimir el procedimiento almacenado.
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.
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).
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

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.
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.
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.
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
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.
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.

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.
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.
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.
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
3. Guarde la definicin del ejecutable del programa.

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.
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.

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.
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.
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
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
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
46

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
Password
DatabaseURL

JDBCDriverClass

Seleccin de objetos de negocio y servicios

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.
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).
procedimientos almacenados y sinnimos/apodos. Puede aadir o eliminar
nodos de esta lista.
Pulse Aceptar cuando haya finalizado.
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.
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.

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.
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.
48
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.

Necesita guardar el mdulo de integracin comercial para el proceso de entrada
que contiene los artefactos y los valores de propiedad que ha creado.
1. En la vista Integracin empresarial, pulse el mdulo Oracle_Inbound.
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
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.
customers
(PARTY_SITES y
customers
(PARTY_SITES y
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
ArIbm_R_Parties
ArIbm_R_Profiles
ArIbm_R_Acct_Sites
ArIbm_R_Site_Uses
ArIbm_R_Party_Sites
ArIbm_R_Locations
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.
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.
En WebSphere Integration Developer en la perspectiva Integracin empresarial,
expanda el mdulo Oracle_Inbound.
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 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

v En el campo Nombre, especifique Perfiles.
v En el campo Tipo, seleccione ArIbm_R_Cust_Profiles en la lista.
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.
Nombre
Tipo
Parties
ArIbm_R_Parties
AccountSites
ArIbm_R_Acct_Sites

52
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
nombre del objeto. Pulse el nombre de atributo que se proporciona en la
tabla para el objeto seleccionado.
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
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
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.
Captulo 6. Ejemplos
53
Tabla 22. Objetos que requieren valores de Clave fornea y objetos hijo
Objetos
Valores
ArIbm_R_Cust_Profiles

ArIbm_R_Parties
Atributo de ForeignKey = party_id

Objeto hijo:
Nombre = Contacts
Tipo = ArIbm_R_Contacts_Customer
ArIbm_R_Party_Sites
Atributo 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

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


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.
54
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.
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);
try
{
}
catch(Exception e)
{
}
}
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);
try
{
}
catch(Exception e)
{
}
}

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.
vista Servidores.

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

Server y seleccione Aadir y eliminar proyectos.
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.
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.
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.
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.

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.
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,
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
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:
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
Captulo 6. Ejemplos
59
Pulse Siguiente.
Tabla 23. Propiedades de conexin de descubrimiento de servicios de empresa
Propiedad
Descripcin
UserName
Password
DatabaseURL

JDBCDriverClass

Seleccin de objetos de negocio y servicios:

este ejemplo, ejecuta una consulta sobre el esquema de las aplicaciones (APPS) y
selecciona el procedimiento almacenado que el objeto de negocio representar.
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).
procedimientos almacenados y sinnimos - apodos. Elimine los nodos para
tablas, vistas y sinnimos - apodos y pulse Aceptar.
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
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.
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.

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.
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.
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.

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

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.
vista Servidores.

3. Pulse con el botn derecho en el nombre de WebSphere Process Server y
seleccione Aadir y eliminar proyectos.
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.
En Websphere Integration Developer, pulse con el botn derecho del ratn en el
mdulo Oracle_API y seleccione Probar > Probar mdulo.
En la ventana Oracle_API_Test, utilice las flechas para establecer los valores de
prueba, tal como se muestra en la tabla siguiente:
62
Tabla 24. Valores de prueba

Elemento
Valor de prueba
Configuracin
Mdulo
Oracle_API
Componente
Interfaz
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.
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

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.
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.
Importe los archivos de referencia en WebSphere Integration Developer para ver
los artefactos de ejemplo asociados con cada ejemplo.
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
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,
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
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
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
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.
69
70
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.
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
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

Spanish Wsa 20061222 Oraebiz

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Spanish Wsa 20061222 Oraebiz

Uploaded by

Copyright:

Available Formats

WebSphere Adapters

Adapter para Oracle E-Business Suite Gua del usuario

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

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

Captulo 1. Acerca de esta informacin

IBM Corporation 2006

Captulo 2. Notas del release

Copyright IBM Corp. 2006

Captulo 3. Introduccin a WebSphere Adapters

IBM Corporation 2006

Captulo 4. Introduccin a Adapter para Oracle E-Business

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

Requisitos de hardware y software

Plataformas soportadas para la ejecucin del instalador del

Requisitos de hardware y software para la configuracin,

Cumplimiento de los estndares

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

Asistente de descubrimiento de servicios de empresa

Navegacin mediante el teclado

Internet Protocol Versin 6.0

Visin general tcnica de Adapter para Oracle E-Business Suite

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

Arquitectura del adaptador

Figura 2. Proceso de sucesos de entrada

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

Figura 3. Proceso de solicitudes de salida

registro, estas API pueden estar envueltas dentro de los procedimientos

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

Aplicaciones de ejemplo de proceso de salida

Proceso de salida utilizando las tablas de la interfaz

Figura 5. Situacin de ejemplo de Create

Figura 6. Situacin de ejemplo de Retrieve

Proceso de salida utilizando la llamada a la API

Aplicacin de ejemplo de proceso de entrada

Figura 7. Proceso de sucesos de entrada

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

WebSphere Adapters en entornos en clster

Alta disponibilidad para las operaciones de entrada

Alta disponibilidad para las operaciones de salida

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

Captulo 5. Instalacin del adaptador

Requisitos previos de instalacin

Instalacin de WebSphere Adapter para JDBC

Plataformas soportadas para la ejecucin del instalador del

Requisitos de hardware y software para la configuracin,

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

Desinstalacin del adaptador

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

Acceso a los archivos de ejemplo

Copyright IBM Corp. 2006

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

Script de creacin de tablas de sucesos

Script de creacin de secuencias de ID de

Script de creacin de paquetes para los

Script de creacin de secuencias de claves de

Script de SQL para insertar un

Script de SQL para emitir el suceso entrante

Crea los nombres de sinnimo utilizados al

Ejemplo 1: Envo de datos de salida al EIS

Preparacin para el proceso de salida

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

Creacin del proyecto del adaptador

Adicin de dependencias externas de software

Configuracin del adaptador para el proceso de salida