spanish wsa 20061222 oraebiz

80
 WebSphere  ®  Adapters Ad apter para Or acle E-Business Su ite Gu ía del usuario Versión6.0.2

Upload: pablo-ramirez

Post on 04-Feb-2018

217 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    1/80

    WebSphere Adapters

    Adapter para Oracle E-Business Suite Gua del usuario

    Versin 6.0.2

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    2/80

    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 locontrario en nuevas ediciones.

    Para enviarnos sus comentarios acerca de este documento, envenos un mensaje de correo electrnico a la [email protected]. 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 dela forma que crea adecuada sin incurrir en ninguna obligacin con el remitente.

    Copyright International Business Machines Corporation 2006. Reservados todos los derechos.

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    3/80

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    4/80

    Captulo 7. Informacin de consulta . . . . . . . . . . . . . . . . . . . . . . . 67Mensajes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Informacin relacionada con el producto . . . . . . . . . . . . . . . . . . . . . . . . . 67

    Captulo 8. Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

    Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    Informacin de la interfaz de programacin . . . . . . . . . . . . . . . . . . . . . . . . 73Marcas registradas y marcas de servicio . . . . . . . . . . . . . . . . . . . . . . . . . . 73

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    5/80

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

    Los desarrolladores de integracin disean, ensamblan, prueban y despliegansoluciones de integracin. Esta informacin est destinada a aquellas personas quevan a desplegar WebSphere Adapter para Oracle E-Business Suite en una solucinque requiera el intercambio de datos entre los sistemas de informacin de empresa(EIS) y aplicacionesJava 2 Platform, Enterprise Edition (J2EE).

    Debido a que WebSphere Adapter para Oracle E-Business Suite sebasa enWebSphere Adapter paraJDBC versin 6.0.2, debe comprender completamente esteadaptador as como acceder a la documentacin del mismo.

    Tambin debe comprender y tener experiencia con los conceptos, estndares yherramientas siguientes:

    v La solucin y el entorno de negocio.

    v Bases de datos, temas de acceso a datos, modelos transaccionales y conexionesentrebases de datos relacionales heterogeneas.

    v Mecanismos de integracin comercial, que incluyen el modelo de programacinde Service Component Architecture (SCA) y el modelo de datos de Service DataObjects (SDO).

    v El estndarJ2EE y las aplicacionesJ2EE.

    v Las capacidades y los requisitos de WebSphere Process Server o WebSphereEnterprise Service Bus, en funcin del sistema principal utilizado en el entorno.

    Debe saber cmo configurar y administrar el servidor de sistema principal ycmo utilizar la consola administrativa.

    v Las herramientas y capacidades proporcionadas por WebSphere IntegrationDeveloper. Debe saber cmo utilizar estas herramientas para conectarcomponentes 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 abases de datos

    eficazmentev Crear modelos de datos para herramientas externas de acceso a datos

    v Implementar medidas de seguridad

    IBM Corporation 2006 1

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    6/80

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    7/80

    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 sitioweb: Adapter for Oracle E-Business Suite release notes.

    Copyright IBM Corp. 2006 3

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.doc/doc/release_notes/relnote_wsa_oracleebiz60.html
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    8/80

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    9/80

    Captulo 3. Introduccin a WebSphere Adapters

    IBM WebSphere Adapters permite que componentes deJava 2 Platform, EnterpriseEdition (J2EE), tales como nuevas aplicaciones de e-business, se comuniquen con

    recursos en un sistema de informacin de empresa (EIS). Un EIS es unainfraestructura de informacin para una empresa (por ejemplo, un sistema deplanificacin de recursos empresariales [ERP]).

    Un WebSphere Adapter acta como un intermediario entre un componente deJ2EEy el EIS, de forma que el componente deJ2EE no necesita comprender la API o lasestructuras de datos debajo 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 yJD EdwardsEnterpriseOne) de forma que pueda utilizar datos y servicios especficos de estasaplicaciones.

    v Los adaptadores de tecnologa proporcionan conectividad a los datos mediantetecnologas y protocolos comobases de datos relacionales, archivos planos,mensajes de correo electrnico y FTP.

    Como parte de la familia de productos WebSphere, WebSphere Adapters funcionacon WebSphere Integration Developer y WebSphere Process Server o WebSphereEnterprise Service Bus.

    v WebSphere Integration Developer es el entorno de herramientas para WebSphereAdapters.

    Necesita utilizar WebSphere Integration Developer para ensamblar un mdulodesplegado en WebSphere Process Server o WebSphere Enterprise Service Bus.Desde WebSphere Integration Developer, importa el adaptador (que estempaquetado como un archivo de adaptador de recursos [RAR]) y se conecta alEIS. El asistente Descubrimiento de servicios de empresa de WebSphereIntegration Developerbusca datos y servicios en el EIS y crea la informacin dela interfaz necesaria para acceder a los datos y servicios. Finalmente, WebSphereIntegration Developer genera un mdulo que incluye el adaptador y lainformacin de la interfaz.

    v WebSphere Process Server o WebSphere Enterprise Service Bus es el entorno deejecucin para WebSphere Adapters.

    Necesita desplegar el mdulo generado por WebSphere Integration Developer enuno de los servidores.

    La generacin y despliegue del mdulo se muestra en la figura siguiente.

    Figura1. Cmosegenera y despliegaunmdulo

    IBM Corporation 2006 5

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    10/80

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    11/80

    Captulo 4. Introduccin a Adapter para Oracle E-BusinessSuite

    WebSphere Adapter para Oracle E-Business Suite es una solucin que utilizacomponentes existentes WebSphere para permitir la comunicacinbidireccionalentre Oracle E-Business Suite y el sistema WebSphere Business Integration. OracleE-Business Suite puede utilizar mltiples mtodos de proceso de datos a y defuentes externas. Esta solucin sebasa en interacciones que funcionan directamentecon los componentes de labase de datos en Oracle E-Business Suite utilizandoWebSphere Adapter paraJDBC.

    La solucin WebSphere Adapter para Oracle E-Business Suite no es un adaptadorde recursos tradicional. La solucin utiliza WebSphere Adapter paraJDBC paracomunicarse con labase de datos de Oracle E-Business Suite y muestra cmoconfigurar la interaccin entre ellos mediante la utilizacin de aplicaciones deejemplo. Las instrucciones explican cmo permitir que la informacin fluya entreOracle E-Business Suite y WebSphere Process Server, para el proceso tanto desucesos de entrada como de solicitudes de salida.

    El contenido y los artefactos de ejemplo de los que se compone esta solucin leayudan a acelerar el proceso de habilitacin de la integracin con Oracle

    Archivo RAR

    del adaptador

    WebSphere

    Integration

    Developer

    Sistema de

    informacin

    de empresa

    Datos o

    servicio

    Servidor

    Mdulo

    Asistente

    Descubrimiento

    de servicios

    de empresa

    Informacin

    de la interfaz

    Archivo

    RAR del

    adaptador

    Informacin

    de la interfaz

    Copyright IBM Corp. 2006 7

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    12/80

    E-Business Suite. Las aplicaciones de ejemplo proporcionan directrices para laintegracin debases de datos utilizando el mdulo Receivables con un cliente deOracle y una API de Oracle. Puede aplicar lo que puede aprender de los ejemplosa distintos mdulos de Oracle E-Business Suite que seleccione utilizar, por ejemplo,General Ledger o Payables.

    Requisitos de hardware y softwareAntes de instalar Adapter para EL NOMBRE DEL ADAPTADOR, debe verificar siel entorno cumple los requisitos necesarios. Estos requisitos se dividen en doscategoras: plataformas soportadas para ejecutar el instalador del adaptador, yrequisitos de hardware y software para configurar, desplegar y ejecutar eladaptador.

    Plataformas soportadas para la ejecucin del instalador deladaptador

    Las plataformas soportadas para la ejecucin del instalador del adaptador estnubicadas 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 yejecucin del adaptador estn ubicados en el siguiente sitio web: IBM WebSphereAdapters e IBM WebSphere Business Integration Adapters: requisitos de software.En la lista de IBM WebSphere Adapters, seleccione el enlace de Adapter para ELNOMBRE 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.

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

    Instalacin

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

    Administracin

    La consola administrativa de WebSphere Process Server o WebSphere EnterpriseService Bus es la interfaz principal de despliegue y administracin de lasaplicaciones de empresa. Estas consolas se visualizan en un navegador web

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.html
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    13/80

    estndar. Utilizando un navegador web accesible, como por ejemplo MicrosoftInternet Explorer o Netscape Browser, puede hacer lo siguiente:

    v Utilizar software lector de pantalla y un sintetizador de habla digital para or loque 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 detexto estndar e interfaces mediante scripts o de la lnea de mandatos en lugar delas interfaces grficas que se proporcionan.

    Cuando es adecuado, la documentacin para caractersticas especficas delproducto contiene informacin adicional sobre la accesibilidad de lascaractersticas.

    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 seimplementa como un plugin de Eclipse que est disponible mediante WebSphereIntegration Developer y es completamente accesible.

    Navegacin mediante el teclado

    Este producto utiliza teclas estndares de navegacin de Microsoft Windows.

    IBM y accesibilidad

    Consulte IBMAccessibility Center para obtener ms informacin sobre elcompromiso de IBM con la accesibilidad.

    Internet Protocol Versin 6.0IBM WebSphere Process Server sebasa en WebSphere Application Server para lacompatibilidad con Internet Protocol Versin 6.0.

    IBM WebSphere Application Server Versin 6.0 y su componenteJavaMail dansoporte a Internet Protocol Versin 6.0 (IPv6) de pila dual.

    Para obtener ms informacin sobre esta compatibilidad en WebSphere ApplicationServer, consulte el soporte de IPv6 en el centro de informacin de WebSphereApplication 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 elsistema WebSphere y Oracle E-Business Suite tanto para el proceso de solicitudesde salida como para sucesos de entrada. Utiliza WebSphere Adapter paraJDBC ymecanismos debases de datos de Oracle E-Business Suite conjuntamente paraprocesar datos. Tres aplicaciones de ejemplo componen el adaptador, dos para elproceso de solicitudes de salida y una para un suceso de entrada.

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

    http://www.ibm.com/ablehttp://www.ibm.com/ablehttp://www.ibm.com/ablehttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rovr_ipv6.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/welcome_nd.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/welcome_nd.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/welcome_nd.htmlhttp://www.ipv6.org/http://www.ipv6.org/http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/welcome_nd.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/welcome_nd.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rovr_ipv6.htmlhttp://www.ibm.com/able
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    14/80

    Arquitectura del adaptadorEl mecanismo de proceso de sucesos para Oracle E-Business Suite se utiliza conWebSphere Adapter paraJDBC para procesar sucesos de entrada desde labase dedatos Oracle. Adapter paraJDBC procesa solicitudes de salida para crear,actualizar o recuperar datos en labase de datos Oracle.

    Visin generalOracle E-Business Suite se crea alrededor de labase de datos Oracle y funciona conella. Oracle E-Business Suite tiene su propio mecanismo de proceso de sucesos,Business Event System (BES). Este sistema permite emitir sucesos en labase dedatos Oracle y a continuacin utilizar las suscripciones que consumen los sucesos yrealizar una accin, que sebasa en la configuracin preestablecida. Las accionespueden incluir rellenar una tabla o cola de Oracle AQ con la informacin delsuceso, o ejecutar algn cdigo SQL oJava.

    Cuando se emite un suceso, Business Event Systembusca suscripciones queutilizan 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 enbase a lasactualizaciones de un objeto de Cliente en labase de datos Oracle. A continuacin,se notificara de una suscripcin que tiene como destino un suceso de cambio decliente y se realizara una accin. La accin podra ser rellenar con los valores clavepara el objeto cambiado una tabla de sucesos para que fueran consumidos por otrocomponente.

    WebSphere Adapter paraJDBC se utiliza para manejar la interrelacin con losartefactos de labase de datos. Permite llamadas de tabla SQL directas y lainteraccin con los procedimientos almacenados y las API de labase de datos. Estasolucin utiliza el soporte de proceso de sucesos incorporado inherente en OracleE-Business Suite para procesar sucesos que pueden ser consumidos por AdapterparaJDBC. Esta solucin utiliza tambin Adapter paraJDBC para rellenar con

    informacin labase de datos Oracle y para llamar a procedimientos a fin deprocesar datos en un sistema Oracle.

    Arquitectura de entrada

    En la aplicacin de ejemplo para el proceso de sucesos de entrada, Adapter paraJDBC se utiliza para sondear una tabla de sucesos creada en labase de datos de laaplicacin Oracle. El adaptador utiliza la informacin de sucesos de la tabla desucesos, como por ejemplo la clave y el tipo del objeto, a fin de recuperarinformacin de objetos de negocio de las tablasbase Oracle. Para obtenerinformacin sobre la arquitectura de Adapter paraJDBC, consulte el manualWebSphere Adapters:Adapter for JDBC User Guide.

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    15/80

    El Business Event System interno de Oracle le permite reconocer cundo se hacambiado un objeto de negocio y rellenar la tabla de sucesos con esa informacin.Consulte la aplicacin de ejemplo para obtener detalles especficos sobre lautilizacin de Business Event System. Para obtener ms informacin sobre BusinessEvent System, consulte la documentacin para aplicaciones Oracle, especficamenteel manual Workflow Administrators Guide.

    Arquitectura de salida

    Para el proceso de solicitudes de salida, Adapter paraJDBC se utiliza para rellenarcon la informacin del objeto las tablas de la interfaz de la aplicacin Oracle. Lastablas de la interfaz son tablas estndar utilizadas para permitir que se procese lainformacin de entrada en las tablasbase Oracle. Oracle da soporte a este procesopara ayudarle a evitar cambios no deseables en el contenido que se podranproducir debido a actualizaciones directas de las tablasbase.

    Adapter paraJDBC rellena las tablas de la interfaz y, a continuacin, se utiliza parallamar a un procedimiento almacenado que invoca una llamada de funcinestndar incluida en la aplicacin Oracle. Labase de datos Oracle procesa los datos

    en las tablas de la interfaz y rellena las tablasbase con estos.

    Para recuperar datos de la aplicacin Oracle, se puede realizar una operacinRetrieve (recuperar) contra las tablasbase utilizando Adapter paraJDBC, porqueno se estn modificando datos en las tablas.

    Adems, se puede utilizar Adapter paraJDBC para llamar directamente a lasinterfaces de programacin de la aplicacin (API) debases de datos incorporadasOracle. Sin embargo, el controladorJDBC limita los parmetros a tipos de datossimples, o no de registro, cuando se llama a una API directamente desde AdapterparaJDBC. Debido a que la mayora de las API de Oracle utilizan parmetros de

    Tablas base

    Oracle E-Business

    Suite

    Base de datos

    Tabla de sucesos

    Adaptador JDBC Punto final

    Figura2. Procesodesucesos de entrada

    Tablas de la interfaz

    Oracle E-Business

    Suite

    Base de datos

    Tablas base

    Adaptador JDBCPunto final

    Figura3. Procesodesolicitudesde salida

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    16/80

    registro, estas API pueden estar envueltas dentro de los procedimientosalmacenados, que a continuacin pueden ser llamados por Adapter paraJDBC.

    Aplicaciones de ejemplo de proceso de salidaCon esta solucin se proporcionan dos aplicaciones de ejemplo de proceso desalida. Una utiliza las tablas de la interfaz debase de datos Oracle, que es el caso

    de ejemplo de salida estndar para Oracle E-Business Suite; y la otra utilizallamadas a la API. El primer ejemplo de salida tiene dos partes: utiliza la operacinCreate (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)

    Labase de datos Oracle permite la recuperacin de datos de las tablasbase de lasaplicaciones. Los objetos de negocio utilizados para la operacin Retrieve

    (recuperar) reflejan la representacin de tablasbase de los datos. Labase de datosOracle no permite la modificacin manual de los datos en las tablasbase. Por lotanto, este ejemplo utiliza las tablas de la interfaz cuando Adapter paraJDBC envaobjetos de negocio que cambian el contenido de labase de datos Oracle. Es el casode ejemplo de proceso de solicitud de salida estndar. Despus de que seactualicen las tablas de la interfaz con los datos de los objetos de negocio, se llamaa una funcin, mediante un procedimiento almacenado, que mueve los datos de lainterfaz a las tablasbase.

    API de Oracle

    Oracle E-Business

    Suite

    Base de datos

    Adaptador JDBCPunto final

    Figura4. Procesodesalidapara una llamadaa laAPI

    Adaptador

    JDBCTablas de

    la interfaz

    Tablas

    base

    Llamada de la

    funcin a la

    API de Oracle

    Figura5. Situacinde ejemplodeCreate

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    17/80

    Adapter paraJDBC se utiliza para rellenar las tablas de la interfaz con datos de losobjetos de negocio. Debido a que Oracle permite el proceso tanto deactualizaciones nuevas como de actualizaciones existentes de las entidades dedatos mediante las tablas de la interfaz, Create (crear) es la nica operacinnecesaria para procesar datos nuevos y modificados. Los datos de los objetos denegocio se pueden mover a las tablasbase Oracle invocando una funcin interna yestndar de Oracle. Se llama a la funcin mediante un procedimiento almacenado

    para mover los datos a las tablasbase utilizando la informacin especfica de laaplicacin de AfterCreateSP en el objeto de negocio.

    Las operaciones Create (crear) y Retrieve (recuperar) utilizan distintos conjuntos deobjetos de negocio porque representan distintas tablas de labase de datos Oracle.Esta aplicacin de ejemplo incluye el procedimiento almacenado de envoltorio paraque la llamada a la funcin mueva los datos a las tablasbase, adems delcontenido de ejemplo que se utilizar para el procedimiento.

    Proceso de salida utilizando la llamada a la API

    Este ejemplo muestra cmo Adapter paraJDBC puede llamar directamente a unaAPI de Oracle E-Business Suite. El controladorJDBC limita los parmetros a tiposde datos simples, no de registro, cuando Adapter paraJDBC llama directamente auna API. La mayora de las API de Oracle incluyen parmetros de registro. Sepueden realizar llamadas a la API que utilicen parmetros de tipo de registromediante Adapter paraJDBC slo si la llamada al procedimiento almacenado de

    envoltorio no utiliza el tipo de parmetro de registro. La llamada a la API para esteejemplo utiliza parmetros de tipo de datos simples.

    Este ejemplo utiliza Adapter paraJDBC para llamar directamente a una API deOracle, que crea un ejecutable de programa simultneo en labase de datos Oracle.El contenido de este ejemplo incluye ejemplos de la llamada a la API.

    Aplicacin de ejemplo de proceso de entradaEste ejemplo utiliza Oracle Business Event System para enviar datos de entrada decliente desde Oracle E-Business Suite a una tabla de sucesos donde Adapter para

    JDBC puede leerlos. Adapter paraJDBC recupera y procesa los objetos de negociode unabase de datos Oracle. El contenido incluido para este ejemplo se describeen esta seccin.

    Este ejemplo muestra el proceso de datos de entrada de cliente desde OracleE-Business Suite. Business Event System incorporado de Oracle emite el suceso yrellena los valores necesarios en la tabla de sucesos de Adapter paraJDBC.

    Un programa simultneo personalizadobusca actualizaciones a la tabla Cliente yemite sucesos si se encuentran clientes nuevos o modificados. Puede configurar elprograma simultneo para que se ejecute a intervalo establecidos, invocarlomanualmente obien invocarlo mediante un procedimiento almacenado. Para esteejemplo, el programa simultneo est configurado para intervalos establecidos.

    Adaptador

    JDBCTablas

    base

    Figura6. Situacinde ejemplodeRetrieve

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    18/80

    Para ahorrar tiempo cuando se realicen los pasos del ejemplo, el programasimultneo se invoca manualmente. Una vez que los datos llegan a la tabla desucesos, Adapter paraJDBC sondea la tabla parabuscar object_key, object_name yobject_function. A continuacin, procesa el objeto de negocio de la aplicacin de

    base de datos Oracle.

    Para Business Event System, se define un suceso para actualizaciones en la tablaCliente. Cuando se guardan cambios, se emite el suceso y el Gestor de sucesos deOraclebusca suscripciones para este tipo de suceso. El ejemplo utiliza unasuscripcin personalizada que reconoce el cambio en los datos del cliente. Elsuceso se pasa a la suscripcin, que procesa los datos enbase a la accin definidaen la suscripcin. La informacin del suceso rellena la tabla de sucesos de AdapterparaJDBC. El adaptador consulta esta tabla y utiliza la informacin del sucesopara realizar una operacin Retrieve (recuperar) desde las tablasbase del objeto de

    negocio.

    El contenido de este ejemplo incluye los procedimientos almacenados necesariospara configurar la accin y las tablas de sucesos.

    Nota: Aunque es posible utilizar un desencadenante en la tabla de cliente paramanejar cmo se rellena la tabla de sucesos, Oracle no lo recomienda.

    WebSphere Adapters en entornos en clsterPuede mejorar el rendimiento y la disponibilidad del adaptador desplegando elmdulo de archivado de empresa (EAR) de WebSphere Adapter en un entorno deservidor en clster. La instancia del adaptador en el mdulo EAR se replica en los

    servidores federados.WebSphere Process Server y WebSphere Application Server Network Deploymentdan soporte a los entornos en clster. Los clsteres son grupos de servidores quese gestionan conjuntamente para equilibrar cargas de trabajo y proporcionar altadisponibilidad y escalabilidad. Cuando configura un clster de servidores, crea unperfil del Gestor de despliegue. HAManager, un subcomponente del Gestor dedespliegue, indica al contenedorJCA que active la instancia del adaptador. ElcontenedorJCA proporciona un entorno de ejecucin para las instancias deladaptador. Para obtener ms informacin sobre los entornos en clster, consulte

    Adaptador

    JDBC

    Tabla de

    sucesos

    personaliz.

    Suscripciones

    de sucesos

    Programa

    simultneo

    Emitir el

    suceso

    Tablas

    base

    Oracle

    Figura7. Procesodesucesos de entrada

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    19/80

    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 tantooperaciones de entrada como operaciones de salida.

    Alta disponibilidad para las operaciones de entrada

    Las operaciones de entrada sebasan en sucesos desencadenados como resultado deactualizaciones de los datos de la aplicacin del sistema de informacin deempresa (EIS). El adaptador est configurado para detectar actualizacionesmediante 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 adaptadordetecten el mismo suceso. Este caso de ejemplo presenta la posibilidad del procesode sucesos duplicados o de la falta de fidelidad de los datos. Por ejemplo, si dosinstancias del adaptador sondean de forma simultnea la misma tabla de sucesoscon el mismo filtro de tipo de suceso, es posible que una modifique los datos sobrelos que depende la otra instancia del adaptador, o que resulte en error. Existe unriesgo paralelo para las arquitecturas del adaptador de escucha de sucesos en unentorno en clster.

    Para evitar esta condicin, HAManager para las instancias del adaptador deentrada implementa un comportamiento nico. Aunque estn iniciadas todas lasinstancias del adaptador, slo una de las instancias detecta y publica un suceso enel punto final para cada tipo de aplicacin del EIS.

    Cuando despliega un mdulo del adaptador en un clster, el contenedorJCAcomprueba la propiedad enableHASupport delbean ResourceAdapter. Si el valorde la propiedad enableHASupport es true (verdadero), el contenedorJCA registratodas 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 laescucha) de sucesos para esta instancia del adaptador. Aunque estn iniciadas otrasinstancias del adaptador en el clster, permanecern inactivas respecto al sucesoactivo hasta que la instancia activa del adaptador acabe de procesar el suceso. Si elservidor en el que se ha iniciado la hebra de sondeo concluye por algn motivo, seactivar una instancia del adaptador que se est ejecutando en uno de losservidores de respaldo.

    Alta disponibilidad para las operaciones de salida

    En los entornos en clster, hay disponibles varias instancias del adaptador pararealizar solicitudes de salida. En consecuencia, si el entorno tiene variasaplicaciones que interactan con el mismo WebSphere Adapter para solicitudes de

    salida, puede mejorar el rendimiento desplegando el mdulo del adaptador en unentorno en clster.

    WebSphere Application Server Network Deployment tiene una capacidad degestin de carga de trabajo que distribuye el proceso de salida entre las instanciasdel adaptador. Como resultado, las operaciones de salida en un entorno en clsterson similares a las operaciones en un entorno de un nico servidor: una solainstancia del adaptador procesa slo una solicitud de salida cada vez. Para obtenerms informacin sobre la gestin de la carga de trabajo, consultehttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.html.

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

    http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.htmlhttp://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/trun_wlm_cluster_v61.html
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    20/80

    Nota: Las instancias del adaptador se replican en un entorno de servidores enclster. Cuando la propiedad enableHASupport est establecida en true(verdadera), que es el valor predeterminado, slo una instancia replicada deladaptador sondea de forma activa sucesos mientras que las dems instanciasse encuentran en modalidad de espera. Si la propiedad enableHASupportest establecida en false (falsa), todas las instancias replicadas del adaptadoren los miembros del clster sondean de forma activa los sucesos. Esto puede

    dar como resultado una duplicacin de sucesos. No cambie el valor deenableHASupport a false (falso) para entornos de un nico servidor. Paraobtener informacin sobre cmo cambiar el valor de esta propiedad,consulte la seccin de las propiedades del adaptador de recursos en estedocumento. Para determinar si la duplicacin del adaptador est soportadaen un entorno en clster, consulte la seccin de los requisitos de software yhardware de este documento.

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    21/80

    Captulo 5. Instalacin del adaptador

    Para instalar el adaptador, debe comprobar los requisitos previos del sistema y, acontinuacin, 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 configurarWebSphere Adapter paraJDBC, versin 6.0.2. Tambin debe verificar si el entornosatisface todos los requisitos necesarios de hardware y software. Estos requisitos sedividen en dos categoras: plataformas soportadas para ejecutar el instalador deladaptador, y requisitos de hardware y software para configurar, desplegar yejecutar el adaptador.

    Instalacin de WebSphere Adapter para JDBC

    La informacin sobre la instalacin de WebSphere Adapter paraJDBC se

    proporciona en la seccin Installing the Adapter del manual Adapter forJDBCUser Guide. Incluye informacin de instalacin especfica de Adapter paraJDBC.

    Plataformas soportadas para la ejecucin del instalador deladaptador

    Las plataformas soportadas para la ejecucin del instalador del adaptador estnubicadas 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 yejecucin del adaptador estn ubicados en el siguiente sitio web: IBM WebSphereAdapters e IBM WebSphere Business Integration Adapters: requisitos de software.En la lista de IBM WebSphere Adapters, seleccione el enlace para Adapter forOracle E-Business Suite, versin 6.0.2.

    Realizacin de la instalacin

    Los pasos para instalar el adaptador son los mismos para todos los WebSphereAdapters. Puede instalar el adaptador utilizando una interfaz grfica de usuario orealizando una instalacin desatendida.

    Antes de empezar

    Revise los requisitos previos de instalacin.

    Cmo realizar esta tarea

    1. Instale el adaptador utilizando las instruccionesbsicas de instalacin, que soncomunes a todos los adaptadores. Estos pasos estn ubicados en la seccinInstalacin del manual Instalacin de IBM WebSphere Adapters.

    Nota: Algunos WebSphere Adapters requieren que realice pasos adicionalesespecficos al adaptador a fin de completar la instalacin. WebSphereAdapter para Oracle E-Business Suite no tiene este requisito.

    Copyright IBM Corp. 2006 17

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://www-1.ibm.com/support/docview.wss?uid=swg27006249http://www-1.ibm.com/support/docview.wss?uid=swg27006249http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbc.doc/%20doc/stjdb_welcome.html
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    22/80

    2. Despus de realizar los pasos de instalacinbsicos, puede configurar eladaptador.

    Resultado

    Se copia una carpeta de ejemplos en la estacin de trabajo en la que se hainstalado el adaptador. Si ha aceptado la ubicacin de instalacin predeterminada,

    la carpeta se coloca en uno de los siguientes directorios, enbase al sistemaoperativo:

    v C:\Archivos de programa\IBM\ResourceAdapters\OracleEBS (sistemasWindows)

    v /opt/IBM/ResourceAdapters/OracleEBS (sistemas UNIX)

    Desinstalacin del adaptador

    Los pasos para desinstalar el adaptador son los mismos para todos los WebSphereAdapters. Puede desinstalar el adaptador utilizando una interfaz grfica de usuarioo realizando una desinstalacin desatendida.

    Acerca de esta tarea

    La desinstalacin del adaptador puede ser una tarea necesaria para la resolucinde un problema de instalacin. Los pasos para la desinstalacin del adaptadorestn ubicados en la seccin Desinstalacin del manual Instalacin de WebSphereAdapters.

    Nota: Si necesita desinstalar un adaptador que ya est desplegado, consulte laseccin Informacin adicional que puede necesitar de Informacinrelacionada con el producto en la pgina 67.

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.htmlhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.ins.doc/doc/stins_welcome.html
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    23/80

    Captulo 6. Ejemplos

    El contenido y los artefactos de ejemplo que componen WebSphere Adapter paraOracle E-Business Suite muestran mtodos para estructurar la integracin de salida

    y de entrada entre labase de datos de Oracle E-Business Suite y el sistemaWebSphere Business Integration.

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

    Para utilizar los ejemplos, debe utilizar una cuenta de labase de datos que leproporcione derecho sobre los artefactos necesarios para ejecutar el contenido deejemplo y debe utilizar una cuenta de Oracle E-Business Suite que le permitarealizar responsabilidades de administrador de flujo de trabajo para aplicacionesweb, administrador del sistema y administrador de Receivables.

    Para los fines de estos ejemplos, se presupone que la cuenta de usuario que ejecutatodos los scripts es el usuario de APPS para labase 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 labase de datos Oracle para determinar lacuenta que se utilizar para ejecutar el contenido de ejemplo. Si desea seleccionaruna cuenta de usuario distinta, trabaje con el administrador de labase de datospara asegurarse de que el usuario tenga derechos sobre todos los artefactos debasede 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 aestas responsabilidades, stas se pueden aadir. Para cambiar lasresponsabilidades asignadas a la cuenta que utilizar, inicie la sesin conuna cuenta que tenga derechos de responsabilidad de Administrador delsistema y vaya la opcin de men Security ->User->Define (Seguridad->Usuario ->Definir). Para obtener informacin especfica sobre lamodificacin 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 undirectorio de ejemplos. El directorio de ejemplos tiene el contenido que utilizarpara ejecutar las aplicaciones de ejemplo.

    1. Busque la carpeta Sample en el directorio de instalacin de IBM WebSphereAdapter para Oracle E-Business Suite.

    Copyright IBM Corp. 2006 19

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    24/80

    2. Descomprima el archivo oracleEBSSamples.zip. Los archivos de ejemplo sedescriben en la tabla siguiente.

    Tabla1. Archivosde 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 desuceso

    Ibm_customer_event_pkg.pls Script de creacin de paquetes para losprocedimientos utilizados en los ejemplos decreacin de objetos de cliente

    Ibm_customer_event_key_s.sql Script de creacin de secuencias de claves desucesos

    Ibm_submit_request.sql Script de SQL para insertar unprocedimiento especial al que llamardespus de que se hayan creado entradas desuceso en las tablas de la interfaz paramover los datos a las tablasbase

    Raise_inbound_event.sql Script de SQL para emitir el suceso entrantede cliente

    Ibm_create_synonyms.sql Crea los nombres de sinnimo utilizados alcrear 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 enuna aplicacin Oracle y recuperar los datos de la aplicacin. En este caso deejemplo, utiliza WebSphere Adapter paraJDBC como el mtodo de integracinpara crear un cliente en labase de datos Financials de Oracle E-Business Suite ypara recuperar de nuevo la informacin de cliente de labase de datos Financials.

    La realizacin de este situacin de ejemplo le mostrar cmo configurar los flujosde informacin entre Oracle E-Business Suite y WebSphere Process Server parasucesos de salida, independientemente del mdulo de Oracle E-Business Suite queutilice; por ejemplo, podra utilizar Payables o General Ledger.

    Preparacin para el proceso de salidaDebe ejecutar archivos script de SQL para prepararse para el proceso de salida.Necesita crear sinnimos para ahorrar tiempo posteriormente cuando genereobjetos de negocio desde labase de datos de Oracle E-Business Suite. Tambinnecesita insertar artefactos en Oracle E-Business Suite antes de poder procesarobjetos utilizando las tablas debase de datos.

    Cmo realizar esta tarea1. Cree sinnimos

    Abra la herramienta SQL*Plus (o un programa similar para procesar sentenciasSQL). Inicie la sesin en SQL*Plus utilizando una cuenta de labase de datosque tenga otorgados derechos de administrador debase de datos (DBA).

    Ejecute el archivo ibm_create_synonyms.sql.

    Por ejemplo: SQL> @C:\samplecontent\ibm_create_synonyms.sql.

    El tamao de labase de datos y el nmero de artefactos de labase de datos enlabase de datos de Oracle E-Business Suite pueden alargar el proceso de

    bsqueda en listas grandes al ejecutar el asistente Descubrimiento de servicios

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    25/80

    de empresa para generar objetos. La creacin de los sinnimos le ayudar aacelerar labsqueda. Adems, los sinnimos ayudan a resolver un problemarelacionado con el controlador de labase de datos Oracle. Este problema sedocumenta 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 denominadoIBM_WEBSPHERE_CUSTOMER_IMP en el esquema APPS de Oracle. Esteprocedimiento se utiliza para mover los datos de cliente de las tablas de lainterfaz Oracle a las tablasbase. Utilizar las tablas de la interfaz al construir elobjeto de negocio Create (crear).

    Creacin del proyecto del adaptadorPara empezar el proceso de creacin de un mdulo para la comunicacin con unaaplicacin Oracle E-Business Suite, cree un proyecto de adaptadorJDBC. Elproyecto del adaptador (denominado un proyecto de conector en WebSphereIntegration Developer) contiene el propio Adapter paraJDBC adems de otros

    artefactos relacionados. Necesita crear el proyecto importando el archivo RAR, quese ha copiado en el sistema de archivos local durante la instalacin de AdapterparaJDBC, en WebSphere Integration Developer.

    Antes de empezar

    Asegrese de tener acceso a la documentacin para Adapter paraJDBC. Para veresa documentacin, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

    Cmo realizar esta tarea

    1. Revise la informacin de la seccin Configuring the adapter for deploymentdel 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 elproyecto del adaptador en el espacio de trabajo de WebSphere IntegrationDeveloper.

    Adicin de dependencias externas de softwareDespus de crear el proyecto en WebSphere Integration Developer, necesita aadiruna referencia al controladorJDBC en el proyecto antes de poder configurar eladaptador para el proceso de salida.

    Antes de empezar

    Asegrese de tener acceso a la documentacin para Adapter paraJDBC. Para veresa documentacin, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

    Cmo realizar esta tarea

    Aadir dependencias externas

    Realice la tarea Adding external software dependencies descrita en el manualWebSphere Adapters:Adapter for JDBC User Guide para aadir una referencia alcontroladorJDBC en el proyecto.

    Captulo 6. Ejemplos 21

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    26/80

    Configuracin del adaptador para el proceso de salidaNecesita crear los objetos de negocio necesarios para procesar datos en OracleE-Business Suite. Para realizar esta tarea, utilice el asistente Descubrimiento deservicios de empresa para WebSphere Adapter paraJDBC. En primer lugar,inicialice el asistente Descubrimiento de servicios de empresa configurando valoresde las propiedades que permiten al adaptador configurar un canal de

    comunicaciones a unabase de datos especfica. A continuacin, ejecute unaconsulta de objetos de negocio. Finalmente, debe especificar los valores de laspropiedades de seleccin para el archivo de importacin.

    Generacin de objetos de negocio utilizando Descubrimiento deservicios de empresaPara el proceso de salida, cree dos conjuntos de objetos de negocio. El primerconjunto se utiliza para pasar datos para nuevos clientes y actualizaciones a datospara clientes existentes a labase de datos. El segundo conjunto de objetos se utilizapara recuperar datos de cliente directamente de las tablasbase Oracle. Antes degenerar los objetos de negocio, necesita establecer propiedades de conexin paraque el asistente Descubrimiento de servicios de empresa se conecte al EIS (sistemade informacin de empresa).

    Cmo establecer las propiedades de conexin para Descubrimiento de serviciosde empresa:

    Necesita establecer los valores de las propiedades de conexin del descubrimientode servicios de empresa para la instancia de labase de datos. Estas propiedadespermiten al asistente Descubrimiento de servicios de empresa en Adapter para

    JDBC conectarse a labase de datos Oracle para el descubrimiento y para lacreacin de la descripcin del servicio.

    Cmo realizar esta tarea

    1. En WebSphere Integration Developer, en la perspectiva Integracin empresarial,seleccione Archivo > Nuevo > Descubrimiento de servicios de empresa.

    2. En la ventana Seleccionar un adaptador de recursos de servicios de empresa,seleccione Adaptador EMDJDBC y pulse Siguiente.

    3. En la ventana Configurar valores para el agente de descubrimiento, especifiquela informacin para labase de datos en los campos de las propiedades de laconfiguracin de la conexin. Son necesarios cuatro valores de propiedad deconexin de descubrimiento de servicios de empresa para el ejemplo. La tablasiguiente lista estas propiedades y sus descripciones. Para obtener detallesacerca de estas propiedades, consulte Enterprise service discovery connectionproperties de la seccin Reference del manual WebSphere Adapters:Adapterfor JDBC User Guide. Para ver esa documentacin, consultehttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

    Pulse Siguiente.Tabla2. Propiedadesdedescubrimientode serviciosde empresa

    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 connectionproperties en la seccin Reference del manualWebSphere Adapters: Adapter for JDBC User Guide.

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    27/80

    Tabla2. Propiedadesdedescubrimientode serviciosde empresa (continuacin)

    Propiedad Descripcin

    JDBCDriverClass Consulte Enterprise service discovery connectionproperties en la seccin Reference del manualWebSphereAdapters: Adapter for JDBC User Guide.

    Seleccin de objetos de negocio y servicios:

    Despus de configurar las propiedades de conexin, ejecute una consulta para losobjetos de labase de datos. Puede examinar la estructura del rbol de metadatospara comprender la estructura de los objetos del EIS (sistema de informacin de laempresa) y seleccionar los objetos necesarios para la descripcin del servicio. Paraeste ejemplo, ejecuta una consulta sobre el esquema de Accounts Receivable (AR) yselecciona sinnimos que representan las tablas de la interfaz de Oracle E-BusinessSuite.

    Cmo realizar esta tarea

    1. Especifique las propiedades de filtro

    En la ventana Buscar y descubrir servicios de empresa, pulse Editar consulta.En la ventana Propiedades de filtro de la consulta, especifique AR en el campode la propiedad Filtro de nombre de esquema para visualizar el esquema deAccounts Receivable (AR).

    El campo de la propiedad Tipos lista las entradas siguientes: tablas, vistas,procedimientos almacenados y sinnimos/apodos. Puede aadir o eliminarnodos de esta lista.

    Seleccione el recuadro de seleccin Aadir ASI de objeto de negocio y pulseAceptar. A continuacin, siempre que aada un objeto cuando ejecute laconsulta de metadatos en el paso 2, aparecer una ventana denominadaParmetros de configuracin para (nombre de objeto) para especificar lainformacin especfica de la aplicacin.

    2. Ejecute la consulta de metadatosa. Visualice los objetos comprendidos en la consulta

    Pulse Ejecutar consulta. El esquema AR y los elementos de datos delesquema 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 deimportacin 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 ventanaIBM_C_CUST_PROFILE.

    Seleccione AfterCreateSP y pulse Aceptar en la ventana Aadir.En el rea AfterCreateSP de los Parmetros de configuracin para laventana 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 transcurrabastante rato hasta que el campo Filtro de nombre SP se active.

    Captulo 6. Ejemplos 23

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    28/80

    v Especifique IBM_WEBSPHERE_CUSTOMER_IMP en el campo Filtro denombre SP.

    v Seleccione IBM_WEBSPHERE_CUSTOMER_IMP en la lista Procedimientoalmacenado.

    Pulse Aceptar.

    Despus de un momento, el objeto seleccionado se visualizar en el panel

    inferior.En este ejemplo, procesa los datos utilizando las tablasbase y de la interfazincorporada de Oracle. Slo es necesaria la operacin Create (crear) paraenviar tanto los datos de cliente como las actualizaciones a datos de clienteexistentes. Como parte de la llamada a la operacin Create (crear) delobjeto, el procedimiento almacenado IBM_WEBSPHERE_CUSTOMER_IMPse ejecuta utilizando el valor AfterCreateASI para el objeto a procesar. Esteprocedimiento almacenado mueve los datos de la interfaz a las tablasbase.

    d. Seleccione los sinnimos restantes

    Seleccione cada uno de los restantes sinnimos (vea la lista siguiente) ypulse Aadir. Cuando aparezca la ventana Parmetros de configuracinpara (nombre de objeto), pulse simplemente Aceptar. No aada el valor

    AfterCreateSP.Cuando haya finalizado, pulse Siguiente.

    Los sinnimos restantes son los siguientes:

    1) AR.IBM_C_CUST_INTERFACE2) AR.IBM_C_CUST_BANKS

    3) AR.IBM_C_CONTACTS

    4) AR.IBM_C_PAY_METHODS5) AR.IBM_R_CUST_PROFILES

    6) AR.IBM_R_CUST_ACCOUNTS

    7) AR.IBM_R_PARTIES

    8)AR.IBM_R_ACCT_SITES9) AR.IBM_R_SITE_USES

    10) AR.IBM_R_PARTY_SITES

    11) AR.IBM_R_LOCATIONS12) AR.IBM_R_CONTACTS_CUSTOMER

    13) AR.IBM_R_CONTACTS_SITES

    Para obtener informacin sobre la informacin especfica de la aplicacin delos atributos, verbos, y nivel de objeto, consulte la seccinApplication-specific information del manual IBM WebSphere Adapters:Adapterfor JDBC User Guide. Para ver esa documentacin, consultehttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

    .

    Generacin de definiciones de objeto de negocio y artefactos relacionados:

    Despus de que haya seleccionado objetos debase de datos, deber especificarvalores para las propiedades de seleccin para los archivos de importacin yexportacin.

    Cmo realizar esta tarea

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    29/80

    1. Especifique el valor de NameSpace

    En la vista Configurar objetos de Descubrimiento de servicios de empresa, dejeel 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 soportepara el tipo de servicio que ha seleccionado. Elimine las siguientes operaciones:Delete, Update, ApplyChanges, y RetrieveAll resaltndolas y pulsandoEliminar.

    Las siguientes operaciones permanecen:

    v Create

    v Retrieve

    Deje los valores por omisin para los campos MaxRecords y BOLocation. PulseSiguiente.

    Configuracin de las propiedades del adaptadorPara configurar un canal de comunicaciones a unabase de datos especfica para elproceso de salida, configure las propiedades de la fbrica de conexin gestionada(J2C) y del adaptador de recursos que el adaptador utiliza. Tambin necesita crearun mdulo de integracin comercial donde se guarden todos los artefactos y losvalores de propiedad.

    Cmo realizar esta tarea

    1. Especifique un nuevo nombre de mdulo

    En la ventana Generar artefactos, pulse Nuevo junto al campo Mdulo. En laventana Nuevo proyecto de integracin, confirme que Crear un proyecto demdulo est seleccionado. En la ventana Nuevo mdulo, especifiqueOracle_Outbound, y pulse Finalizar. Este mdulo albergar todos los artefactosgenerados.

    2. Establezca los valores de propiedad de configuracinEn la parte inferior de la ventana, pulse elbotn Utilizar propiedades deconexin descubiertas.

    Para el proceso de salida, aparecern los campos de propiedades para laspropiedades de la fbrica de conexinJ2C y del adaptador de recursos. Para lasPropiedades de la fbrica de conexinJ2C (gestionado), en Credenciales deusuario en el campo Nombre de usuario, especifique el nombre de usuario delabase de datos. En el campo Contrasea, especifique la contrasea de labasede datos.

    Para Propiedades del adaptador de recursos, en Varios establezca el valor paraProveedor de base de datos en Oracle. Pulse Finalizar.

    Para obtener informacin sobre estas propiedades, consulte la seccinReference del manual WebSphere Adapters:Adapterfor JDBC User Guide. Paraver esa documentacin, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.

    Cmo guardar el proyecto del adaptadorNecesita guardar el mdulo de integracin comercial para el proceso de salida quecontiene los artefactos y los valores de propiedad que ha creado.

    Cmo realizar esta tarea

    1. En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.

    Captulo 6. Ejemplos 25

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    30/80

    2. Seleccione Archivo > Guardar.

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

    Creacin de objetos de negocio

    Este ejemplo utiliza un conjunto de objetos de negocio principales e hijo pararellenar 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, ascomo actualizaciones a los datos existentes de cliente. Este ejemplo tambin utilizaun segundo conjunto de objetos para recuperar los datos de cliente directamentede las tablasbase Oracle, utilizando la operacin Retrieve (recuperar). Debe crearlos objetos de negocio tanto para la operacin Create (crear) como para laoperacin 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 seestructuran como objetos de negocio hijo.

    Objetos de negocio de las tablas de base de datos

    La siguiente tabla lista las tablas debase de datos para el esquema AR con losnombres de tabla, objeto de negocio y unabreve descripcin de la informacin quecontiene cada objeto.

    Nota: Para obtener ms informacin sobre los datos de la tabla, consulte ladocumentacin para aplicaciones Oracle, especialmente la seccin de la guadel usuario de Receivables que describe la interfaz del cliente.

    Tabla3. Tablasdebase dedatospara el esquemadeAR

    Nombre de la tabla Objeto de negocio Descripcin

    AR.RA_CUSTOMER_PROFILES_INT_ALL

    ArIbm_C_Cust_Profile Tabla de la interfaz delPerfil de cliente, quecontiene informacin dealto nivel sobre el cliente

    AR.RA_CUSTOMERS_INTERFACE_ALL

    ArIbm_C_Cust_Interface Tabla principal paraclientes, as como paradirecciones de cliente

    AR.RA_CONTACT_PHONES_INT_ALL

    ArIbm_C_Contacts Informacin de contacto yde telfono

    AR.RA_CUST_PAY_METHOD_INT_ALL

    ArIbm_C_Pay_Methods Mtodos de pago asociadoscon 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 lastablasbase Oracle E-Business Suite. Debido a que la operacin Retrieve (recuperar)no modifica los valores de las tablasbase, puede recuperar los datos de estas tablasdirectamente. No necesita utilizar tablas de la interfaz de usuario.

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    31/80

    Objetos de negocio de una tabla base

    La siguiente tabla muestra la estructura de los objetos de negocio para la operacinRetrieve (recuperar) de las tablasbase, incluyendo el nombre de tabla, el nombrede objeto de negocio y la descripcin. La siguiente seccin muestra la relacin delos objetos de negocio que configura para la operacin Retrieve (recuperar).

    Tabla4. Objetosde negociopara la operacinRetrieveen las tablasbaseNombre de la tabla Objeto de negocio Descripcin

    AR.HZ_CUST_ACCOUNTS ArIbm_R_Cust_Accounts Nmero de cliente, tipoy otra informacin decliente.

    AR.HZ_CUSTOMER_PROFILES

    ArIbm_R_Profiles Informacin de perfil dealto nivel para el cliente.

    AR.HZ_PARTIES ArIbm_R_Parties Nombre del cliente y, sise trata de una personay no de un negocio, losdetalles de la persona.

    AR.HZ_PARTY_SITES ArIbm_R_Party_Sites Enlaces entre los ID de

    direccin de cliente y losID de ubicacin de ladireccin.

    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 direccincomercial 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 ynmero de telfono. La

    tabla se lista dos veces,porque tanto sites comocustomers(PARTY_SITES yPARTIES) utilizan lamisma tabla para losdetalles de contactos.

    AR.HZ_CONTACT_POINTS ArIbm_R_Contacts_Customer Detalles de contacto ynmero de telfono. Latabla se lista dos veces,porque tanto sites comocustomers(PARTY_SITES yPARTIES) utilizan lamisma tabla para losdetalles de contactos.

    Relacin de los objetos de negocio

    Para que la operacin Retrieve (recuperar) sea satisfactoria, los enlaces queconectan 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 objetosque debe configurar para la operacin Retrieve (recuperar).

    Captulo 6. Ejemplos 27

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    32/80

    Para crear los objetos, cree los objetos hijo y establezca la relacin de clave forneade informacin especfica de la aplicacin entre los objetos padre e hijo. Paraobtener ms informacin sobre la naturaleza de los objetos de negocio, consulte laseccin Business objects del manual WebSphere Adapters: Adapterfor JDBC UserGuide. 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 paraJDBC procesa los objetos de negocio creando filas en las tablas de

    base de datos correspondientes de Oracle E-Business Suite.

    Cmo realizar esta tarea

    1. Seleccione un objeto de nivel superior

    En la perspectiva Integracin empresarial de WebSphere Integration Developer,expanda el mdulo Oracle_Outbound.

    Expanda Tipos de datos. Efecte una doble pulsacin en el objeto

    ArIbm_C_Cust_Profile.2. Aada un hijo al objeto de nivel superior

    a. En la parte superior de la ventana Objeto de negocio, pulse elbotn paraaadir un atributo a un objeto de negocio.

    ArIbm_R_Cust_Accounts

    ArIbm_R_Parties ArIbm_R_Profiles ArIbm_R_Acct_Sites

    ArIbm_R_Site_UsesArIbm_R_Contacts_Customer

    ArIbm R Par ty Si tes_ _ _

    ArIbm R Locations_ _ ArIbm R Contacts Sites_ _ _

    Figura8. Relacionesde objetospara laoperacinRetrieve (recuperar)

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

    http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdbhttp://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb
  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    33/80

    b. En la vista Propiedades, pulse la pestaa Descripcin y especifique losvalores 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 seleccioneArIbm_C_Cust_Interface.

    v Seleccione el recuadro de seleccin Matriz.

    3. Aada los objetos hijo restantes

    Utilice los dos pasos anteriores para aadir los objetos de negocio hijorestantes. La tabla siguiente muestra los atributos de nombre y tipo que sedeben especificar para cada objeto de negocio hijo.

    Tabla5. Atributosde nombrey 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 despusdel procedimiento de creacin.

    Figura9. Adicindeun atributo

    Figura10. Entradasdeatributo

    Captulo 6. Ejemplos 29

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    34/80

    4. Guarde el mdulo

    En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.

    En labarra de mens, seleccione Archivo > Guardar.

    Creacin de objetos para la operacin Retrieve (recuperar)Para crear los objetos de negocios para la operacin Retrieve (recuperar), debeestablecer una relacin entre los objetos de negocio padre e hijo. Adapter para

    JDBC procesa los objetos de negocio recuperando filas de las tablasbasecorrespondientes de Oracle E-Business Suite.

    Acerca de esta tarea

    Utilice los pasos descritos en este procedimiento para crear un objeto de negocio

    de nivel superior y aadir sus objetos hijo, y para crear los objetos restantes para laoperacin Retrieve (recuperar). Despus de haber creado el objeto de nivelsuperior, utilice la informacin en la tabla proporcionada para aadir objetos hijo yestablecer los valores de clave fornea.

    Cmo realizar esta tarea

    1. Seleccione un objeto de nivel superior

    En la perspectiva Integracin empresarial de WebSphere Integration Developer,expanda el mdulo Oracle_Outbound.

    Expanda Tipos de datos. Efecte una doble pulsacin en el objetoArIbm_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 deelemento ASI, en la columna situada a la derecha de jdbcasi:PrimaryKey,cambie el valor a true.

    Figura11. Conjuntodeobjetosdenegociocreadospara laoperacinCreate (crear)

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    35/80

    3. Aada el primer objeto de negocio hijoa. En la parte superior de la ventana Objeto de negocio, pulse elbotn para

    aadir un atributo a un objeto de negocio.

    b. En la vista Propiedades, pulse la pestaa Descripcin y especifique losvalores para el atributo.v En el campo Nombre, especifique Perfiles.

    v En el campo Tipo, utilice las flechas para seleccionarArIbm_R_Cust_Profiles.

    v Seleccione el recuadro de seleccin Matriz.

    4. Aada los restantes objetos de negocio hijo al objeto de nivel superior

    Repita el paso anterior para aadir dos o ms objetos de negocio hijo al objetoArIbm_R_Cust_Accounts. La tabla siguiente muestra los atributos de nombre ytipo que se deben especificar para cada objeto de negocio hijo.

    Tabla6. Atributosde nombrey tipo

    Nombre TipoParties ArIbm_R_Parties

    AccountSites ArIbm_R_Acct_Sites

    La siguiente figura muestra el aspecto que tiene el conjunto de objetos despusdel procedimiento de creacin.

    Figura12. Establecimientode la clave primaria

    Captulo 6. Ejemplos 31

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    36/80

    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 unobjeto hijo a los objetos de negocio restantes que necesita crear para laoperacin Retrieve (recuperar). La informacin especfica de la aplicacin (ASI)de la Clave fornea permite que el adaptador recupere objetos hijo enbase a unvalor de atributo en el objeto padre.

    Establezca el valor de Clave fornea para los ocho objetos de la tabladenominada Objetos que requieren valores de Clave fornea y objetos hijo.Utilice el nombre y valor de atributo proporcionado en la tabla para cadaobjeto.

    Para los objetos de negocio de la tabla que tienen objetos hijos, necesita aadirvalores de objeto de negocio hijo. Especifique el Nombre y el Tipo de objetohijo proporcionado en la tabla para cada objeto hijo.

    a. Establezca el valor de Clave fornea para el objetoEn la vista Integracin empresarial, efecte una doble pulsacin en elnombre del objeto. Pulse el nombre de atributo que se proporciona en latabla para el objeto seleccionado.

    En la vista Propiedades, pulse la pestaa Informacin de aplicacin.

    En la ventana Atributo nombre de atributo, pulse con elbotn derecho en elrecuadro Propiedades de elemento ASI. Seleccione Aadir despus de >jdbcasi:ForeignKey.

    En la columna situada a la derecha de jdbcasi:ForeignKey, establezca elvalor listado en la tabla para el objeto seleccionado.

    b. Aada los objetos de negocio hijo

    En la vista Integracin empresarial, efecte una doble pulsacin en elnombre del objeto. En la parte superior de la ventana Objeto de negocio,pulse elbotn para aadir un atributo a un objeto de negocio.

    En la vista Propiedades, pulse la pestaa Descripcin y especifique losvalores para el atributo.

    v En el campo Nombre, especifique el nombre de objeto hijo de la tablapara el objeto seleccionado.

    v En el campo Tipo, utilice las flechas para seleccionar el tipo de objeto hijoen la tabla para el mismo objeto.

    v Seleccione el recuadro de seleccin Matriz.

    Figura13. Conjuntode objetoscreados para la operacinRetrieve (recuperar)

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    37/80

    Tabla7. Objetosque requierenvalores deClave forneay objetoshijo

    Objeto Valores

    ArIbm_R_Cust_Profiles Atributo de ForeignKey = cust_account_idValor de ForeignKey = cust_account_id

    ArIbm_R_Parties Atributo de ForeignKey = party_idValor de ForeignKey = party_id

    Objeto hijo:Nombre = ContactsTipo = ArIbm_R_Contacts_Customer

    ArIbm_R_Party_Sites Atributo de ForeignKey = party_site_idValor de ForeignKey = party_site_idObjeto hijo:

    Nombre = LocationsTipo = ArIbm_R_Locations

    Objeto hijo:Nombre = ContactsTipos = ArIbm_R_Contacts_Sites

    ArIbm_R_Acct_Sites Atributo de ForeignKey = cust_account_idValor de ForeignKey = cust_account_id

    Objeto hijo:Nombre = PartySitesTipo = ArIbm_R_Party_Sites

    Objeto hijo:Nombre = SiteUsesTipo = ArIbm_R_Site_Uses

    ArIbm_R_Site_Uses Atributo de ForeignKey = cust_acct_site_idValor de ForeignKey = cust_acct_site_id

    ArIbm_R_Locations Atributo de ForeignKey = location_idValor de ForeignKey = location_id

    ArIbm_R_Contacts_Sites Atributo de ForeignKey = owner_table_idValor de ForeignKey = party_site_id

    ArIbm_R_Contacts_Customer Atributo de ForeignKey = owner_table_idValor de ForeignKey = party_id

    6. Guarde el mdulo

    En la vista Integracin empresarial, pulse el mdulo Oracle_Outbound.

    En labarra de mens, seleccione Archivo > Guardar.

    Despliegue del proyecto del adaptador en el entorno deprueba

    Para probar la aplicacin del adaptador, en primer lugar necesita instalar elmdulo SCA (Service Component Architecture) para el proceso de salida en elcliente de prueba de integracin de WebSphere Integration Developer. El mduloSCA que contiene un archivo de importacin del EIS (sistema de informacin de laempresa) se produce ejecutando el asistente Descubrimiento de empresa.

    Cmo realizar esta tarea

    1. En WebSphere Integration Developer, pulse la pestaa Servidores para abrir lavista Servidores.

    Captulo 6. Ejemplos 33

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    38/80

    2. Si WebSphere Process Server no se est ejecutando, pulse con elbotn derechoen el nombre del mismo y seleccione Iniciar. Una vez que se inicie, la entradaEstado del mismo se actualizar a Iniciado.

    3. Pulse con elbotn derecho en el nombre de su WebSphere Process Server yseleccione Aadir y eliminar proyectos.

    4. En la lista Proyectos disponibles de la izquierda, seleccione el mdulo deladaptador Oracle_OutboundApp y pulse Aadir. Pulse Finalizar.

    Cmo probar la operacin Create (crear)Despus de haber desplegado el modulo de proceso de salida en WebSphereProcess Server, pruebe la aplicacin del adaptador ensamblado utilizando el cliente

    de prueba de integracin de WebSphere Integration Developer. Puede probar laoperacin Create (crear) y, a continuacin, la operacin Retrieve (recuperar).

    Acerca de esta tarea

    Para probar la operacin Create (crear), cree una entrada de cliente que tenga dosdirecciones y un nmero de telfono.

    Cmo realizar esta tarea

    1. Seleccione el mdulo a probar

    En Websphere Integration Developer, pulse con elbotn derecho del ratn en elmdulo Oracle_Outbound y seleccione Probar > Probar mdulo.

    2. Establezca los valores de pruebaEn la ventana Oracle_Outbound_Test, utilice las flechas para establecer losvalores de prueba que se muestran en la tabla siguiente.

    Tabla8. Valores de pruebapara la operacinCreate (crear)

    Elemento Valor de prueba

    Configuracin Prueba de mdulo por omisin

    Mdulo Oracle_Outbound

    Componente JDBCOutboundInterface

    Interfaz JDBCOutboundInterface

    Operacin createArIbm_C_Cust_Profile

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

    Necesita establecer los valores de atributo para el objeto Perfil de cliente, que esel objeto de nivel superior ArIbm_C_Cust_Profile. Debido a que este ejemploutiliza dos direcciones y un contacto, tambin necesita establecer valores paralos dos objetos hijo del tipo Contactos. Las tablas siguientes proporcionan losvalores para cada objeto e indican cualquier restriccin, como por ejemplo si elvalor tiene que ser exclusivo.

    Oracle requiere valores de ID para la importacin. Estos valores representan losvalores de ID correspondientes para los objetos en el sistema desde el que se

    Figura14. Vista Servidor

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    39/80

    originan los objetos. Los valores de ID se utilizan en mltiples objetos, deforma que necesitar registra los valores que utilizar para poder especificarlosde forma coherente para los distintos objetos. Para cada uno de los siguientescinco valores, cree valores de serie exclusivos de serie.

    v CustomerReference#

    v AddressReference#1

    v

    AddressReference#2v TelephoneReference#

    v CustomerNameReference

    Nota: Para obtener ms informacin sobre los valores necesarios y otros valorespermitidos para datos en las tablas de la interfaz Oracle, consulte ladocumentacin para aplicaciones Oracle Applications, especficamente elmanual Oracle Receivables User Guide.

    a. Establezca el verbo en Create (crear).

    b. En la ventana Eventos del Diagrama de ensamblaje, en Parmetros desolicitud inicial, pulse la columna Valor que aparece en la fila del nombrede cada atributo cuyo valor necesita establecer y especifique el valor de las

    tablas siguientes.

    Nota:

    v Para establecer un valor para un atributo en , pulse elcampo del valor para el atributo. Pulse la flecha y seleccione de la lista.

    Figura15. Valores de los atributos

    Captulo 6. Ejemplos 35

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    40/80

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

    un objeto hijo de ese tipo (un contacto).

    Tabla9. Valores parael objetode nivel superior

    Atributo Valor Notas

    Insert_update_flag I

    Orig_system_customer_ref

    CustomerReference # Utilice el valor que haregistrado. El valor debe serexclusivo.

    Customer_profile_class_name

    DEFAULT

    Credit_hold N

    Last_updated_by -1

    Last_update_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Creation_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Created_by -1

    Org_id 204

    La tabla siguiente lista los valores para el nuevo elemento para el atributoAddresses.

    Figura16. UtilizacindeAadirelementoparaaadirun objetohijo

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    41/80

    Tabla10. Valores parael nuevoelementoparael atributoAddresses

    Atributo Valor Notas

    Orig_system_customer_ref

    CustomerReference# Utilice el valor que haregistrado. El valor debe serexclusivo.

    Site_use_code BILL_TO

    Orig_system_address_ref

    AddressReference# Utilice el valor que haregistrado. El valor debe serexclusivo.

    Insert_update_flag I

    Customer_name CustomerNameReference Utilice el valor que haregistrado. El valor debe serexclusivo.

    Customer_number

    Customer_status A

    Primary_site_use_flag

    Y

    Location Address1 Test Address 1 Tiene la opcin de utilizar su

    propia informacin dedireccin.

    Address2

    Address3

    Address4

    City San Mateo

    State CA

    Province

    County San MateoPostal_code 94010

    country US

    Cust_category_code CUSTOMER

    Last_updated_by -1

    Last_update_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Created_by -1

    Creation_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Org_id 204Customer_name_phonetic

    CustomerNameReference Utilice el valor que haregistrado.

    La tabla siguiente lista los valores para el segundo elemento para el atributoAddresses.

    Captulo 6. Ejemplos 37

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    42/80

    Tabla11. Valores parael segundoelementoparael atributoAddresses

    Atributo Valor Notas

    Orig_system_customer_ref

    CustomerReference# Utilice el valor que haregistrado. El valor debe serexclusivo.

    Site_use_code SHIP_TO

    Orig_system_address_ref

    AddressReference#2 Utilice el valor que haregistrado. El valor debe serexclusivo.

    Insert_update_flag I

    Customer_name CustomerNameReference Utilice el valor que haregistrado. El valor debe serexclusivo.

    Customer_number

    Customer_status A

    Primary_site_use_flag

    Y

    Location Address1 Test Address 2 Tiene la opcin de utilizar su

    propia informacin dedireccin.

    Address2

    Address3

    Address4

    City San Mateo

    State CA

    Province

    County San MateoPostal_code 94010

    country US

    Cust_category_code CUSTOMER

    Last_updated_by -1

    Last_update_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Created_by -1

    Creation_date 2006-06-25 12:00:00 Fecha y hora de hoy. Notiene que ser exacta.

    Org_id 204Customer_name_phonetic

    CustomerNameReference Utilice el valor que haregistrado.

    La tabla siguiente lista los valores para un elemento para el atributoContacts.

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

  • 7/21/2019 Spanish Wsa 20061222 Oraebiz

    43/80

    Tabla12. Valores paraun elementopara el atributoContacts

    Atributo Valor Notas

    Orig_system_contact_ref

    Orig_system_telephone_ref

    TelephoneReference# Utilice el valor que haregistrado. El valor debe ser

    exclusivo.Orig_system_customer_ref

    CustomerReference# Utilice el valor que haregistrado. El valor debe serexclusivo.

    Orig_system_address_ref

    AddressReference#1 Utilice el valor que haregistrado. El valor debe serexclusivo.

    Insert_update_flag I

    Contact_first_name

    Contact_last_name

    Contact_title

    Contact_job_title Telephone 5551212 Tiene la opcin de utilizar su

    propio nmero de telfono.

    Telephone_extension 1234 Utilice si no t