Página 1
WebSphere Adapters ® Versión 6.0.2 Adapter para Oracle E-Business Suite Guía del usuario...
Página 2
22 de diciembre de 2006 Esta edición se aplica a la versión 6, release 0, modificación 2 de WebSphere Adapter para Oracle E-Business Suite (número de producto 5724-N40) y a todos los releases y modificaciones subsiguientes hasta que se indique lo contrario en nuevas ediciones.
Capítulo 2. Notas del release ......3 Capítulo 3. Introducción a WebSphere Adapters ....5 Capítulo 4.
Página 4
Avisos ........71 Información de la interfaz de programación . 73 Marcas registradas y marcas de servicio . . 73 IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Los desarrolladores de integración diseñan, ensamblan, prueban y despliegan soluciones de integración. Esta información está destinada a aquellas personas que van a desplegar WebSphere Adapter para Oracle E-Business Suite en una solución que requiera el intercambio de datos entre los sistemas de información de empresa (EIS) y aplicaciones Java 2 Platform, Enterprise Edition (J2EE).
Página 6
IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Capítulo 2. Notas del release Las notas del release para WebSphere Adapter para Oracle E-Business Suite, versión 6.0.2 resumen las nuevas características 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.
Página 8
IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
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 aplicación o de tecnología. v Los adaptadores de aplicación conectan aplicaciones empaquetadas existentes (tales como software SAP Siebel, PeopleSoft Enterprise y JD Edwards EnterpriseOne) de forma que pueda utilizar datos y servicios específicos de estas...
Página 10
IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Oracle E-Business Suite utilizando WebSphere Adapter para JDBC. La solución WebSphere Adapter para Oracle E-Business Suite no es un adaptador de recursos tradicional. La solución utiliza WebSphere Adapter para JDBC para comunicarse con la base de datos de Oracle E-Business Suite y muestra cómo...
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, Versión 6.0.2.
Internet Protocol Versión 6.0 (IPv6) de pila dual. Para obtener más información sobre esta compatibilidad en WebSphere Application Server, consulte el soporte de IPv6 en el centro de información de WebSphere Application Server. Para obtener más información sobre IPv6, consulte www.ipv6.org.
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.
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 cuándo se ha cambiado un objeto de negocio y rellenar la tabla de sucesos con esa información. Consulte la aplicación de ejemplo para obtener detalles específicos sobre la utilización de Business Event System.
Adaptador Tablas de Tablas JDBC la interfaz base Llamada de la función a la API de Oracle Figura 5. Situación de ejemplo de Create IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Adapter para JDBC se utiliza para rellenar las tablas de la interfaz con datos de los objetos de negocio. Debido a que Oracle permite el proceso tanto de actualizaciones nuevas como de actualizaciones existentes de las entidades de datos mediante las tablas de la interfaz, Create (crear) es la única operación necesaria para procesar datos nuevos y modificados.
WebSphere Adapters en entornos en clúster Puede mejorar el rendimiento y la disponibilidad del adaptador desplegando el módulo de archivado de empresa (EAR) de WebSphere Adapter en un entorno de servidor en clúster. La instancia del adaptador en el módulo EAR se replica en los servidores federados.
En los entornos en clúster, hay disponibles varias instancias del adaptador para realizar solicitudes de salida. En consecuencia, si el entorno tiene varias aplicaciones que interactúan con el mismo WebSphere Adapter para solicitudes de salida, puede mejorar el rendimiento desplegando el módulo del adaptador en un entorno en clúster.
Página 20
Para determinar si la duplicación del adaptador está soportada en un entorno en clúster, consulte la sección de los requisitos de software y hardware de este documento. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
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, versión 6.0.2.
Windows) v /opt/IBM/ResourceAdapters/OracleEBS (sistemas UNIX) Desinstalación del adaptador Los pasos para desinstalar el adaptador son los mismos para todos los WebSphere Adapters. Puede desinstalar el adaptador utilizando una interfaz gráfica de usuario o realizando una desinstalación desatendida. Acerca de esta tarea La desinstalación del adaptador puede ser una tarea necesaria para la resolución...
Ejemplo 1: Envío de datos de salida al EIS Con WebSphere Adapter para Oracle E-Business Suite, puede importar datos en una aplicación Oracle y recuperar los datos de la aplicación. En este caso de ejemplo, utiliza WebSphere Adapter para JDBC como el método de integración...
1. Revise la información de la sección “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 sección para configurar el proyecto del adaptador en el espacio de trabajo de WebSphere Integration Developer.
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 específica.
Página 27
JDBCDriverClass Consulte “Enterprise service discovery connection properties” en la sección “Reference” del manual WebSphere Adapters: Adapter for JDBC User Guide. Selección de objetos de negocio y servicios: Después de configurar las propiedades de conexión, 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 información de la...
Página 28
Después de que haya seleccionado objetos de base de datos, deberá especificar valores para las propiedades de selección para los archivos de importación y exportación. Cómo realizar esta tarea IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Para Propiedades del adaptador de recursos, en Varios establezca el valor para Proveedor de base de datos en Oracle. Pulse Finalizar. Para obtener información sobre estas propiedades, consulte la sección “Reference” del manual WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/infocenter/ dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Oracle E-Business Suite. Debido a que la operación 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. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 31
Objetos de negocio de una tabla base La siguiente tabla muestra la estructura de los objetos de negocio para la operación Retrieve (recuperar) de las tablas base, incluyendo el nombre de tabla, el nombre de objeto de negocio y la descripción. La siguiente sección muestra la relación de los objetos de negocio que configura para la operación Retrieve (recuperar).
Página 32
Para obtener más información sobre la naturaleza de los objetos de negocio, consulte la sección “Business objects” del manual WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/ infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Página 33
Figura 9. Adición de un atributo b. En la vista Propiedades, pulse la pestaña Descripción 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.
Página 34
En la vista Propiedades, pulse la pestaña Información de aplicación. 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. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 35
Figura 12. Establecimiento de la clave primaria 3. Añada el primer objeto de negocio hijo a. En la parte superior de la ventana Objeto de negocio, pulse el botón para añadir un atributo a un objeto de negocio. b. En la vista Propiedades, pulse la pestaña Descripción y especifique los valores para el atributo.
Página 36
En el campo Tipo, utilice las flechas para seleccionar el tipo de objeto hijo en la tabla para el mismo objeto. v Seleccione el recuadro de selección Matriz. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
SCA que contiene un archivo de importación del EIS (sistema de información de la empresa) se produce ejecutando el asistente Descubrimiento de empresa. Cómo realizar esta tarea 1. En WebSphere Integration Developer, pulse la pestaña Servidores para abrir la vista Servidores. Capítulo 6. Ejemplos...
Iniciar. Una vez que se inicie, la entrada Estado del mismo se actualizará a Iniciado. 3. Pulse con el botón derecho en el nombre de su WebSphere Process Server y seleccione Añadir y eliminar proyectos.
Página 39
originan los objetos. Los valores de ID se utilizan en múltiples 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...
Página 40
Creation_date 2006-06-25 12:00:00 Fecha y hora de hoy. No tiene que ser exacta. Created_by Org_id La tabla siguiente lista los valores para el nuevo elemento para el atributo Addresses. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 41
Tabla 10. Valores para el nuevo elemento para el atributo Addresses Atributo Valor Notas Orig_system_ CustomerReference# Utilice el valor que ha customer_ref registrado. El valor debe ser exclusivo. Site_use_code BILL_TO Orig_system_ AddressReference# Utilice el valor que ha address_ref registrado. El valor debe ser exclusivo.
Página 42
Fecha y hora de hoy. No tiene que ser exacta. Org_id Customer_name_ CustomerNameReference Utilice el valor que ha phonetic registrado. La tabla siguiente lista los valores para un elemento para el atributo Contacts. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 43
Tabla 12. Valores para un elemento para el atributo Contacts Atributo Valor Notas Orig_system_ <null> contact_ref Orig_system_ TelephoneReference# Utilice el valor que ha telephone_ref registrado. El valor debe ser exclusivo. Orig_system_ CustomerReference# Utilice el valor que ha customer_ref registrado. El valor debe ser exclusivo.
Cómo borrar el contenido del ejemplo Después de haber probado las operaciones Create (crear) y Retrieve (recuperar), puede borrar el contenido del ejemplo para devolver los datos a su estado original. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Ejemplo 2: Recepción 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 también utiliza WebSphere Adapter para JDBC para sondear sucesos y recuperar datos de cliente. Realizando esta situación de ejemplo, puede ver cómo configurar los flujos de información...
Por ejemplo, especifique: SQL> @C:\samplecontent\ibm_create_synonyms.sql Configuración en Oracle E-Business Suite Esta aplicación de ejemplo utiliza Business Event System de Oracle E-Business Suite, un mecanismo para procesar datos en base a sucesos, suscripciones y IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Tabla 14. Valores de sucesos de negocio Campo Valor Nombre ibm.apps.ar.customer.create Nombre de visualización IBM Create Customer Event Estado Habilitado Nombre de propietario Etiqueta de propietario 5. Guarde la definición del suceso. Nota: Para obtener información específica sobre la utilización de la interfaz de Oracle, consulte la documentación para aplicaciones Oracle.
Tabla 17. Valores de la definición de programa simultáneo Campo Valor Ejecutable IBMCUSTOMEREVENT Nombre abreviado IBMCUSTOMEREVENT Aplicación Receivables Método de ejecución Procedimiento almacenado PL/SQL Nombre del archivo de ejecución IBM_WEBSPHERE_PKG.RAISE_ CUSTOMER_EVENT IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 49
5. Navegue hasta la sección Solicitudes (detalles) y añada una nueva solicitud en los detalles. 6. En el campo del nombre, especifique: IBM Raise Customer Event 7. Guarde los cambios. Nota: Para obtener información específica sobre la utilización de la interfaz de Oracle, consulte la documentación para aplicaciones Oracle.
1. Revise la información de la sección “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 sección para configurar el proyecto del adaptador en el espacio de trabajo de WebSphere Integration Developer.
La tabla siguiente lista estas propiedades y sus descripciones. Para obtener detalles acerca de estas propiedades, consulte “Enterprise service discovery connection properties” de la sección “Reference” del manual WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/ infocenter/dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Oracle_Inbound y pulse Finalizar. Este módulo albergará todos los artefactos generados. 2. Establezca los valores de propiedad de configuración En la parte inferior de la ventana, pulse el botón Utilizar propiedades de conexión descubiertas. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Para Propiedades del adaptador de recursos, en Varios, establezca el valor de Proveedor de base de datos en Oracle. Pulse Finalizar. Para obtener información sobre estas propiedades, consulte la sección “Reference” del manual WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/infocenter/ dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Oracle. El diagrama siguiente muestra las relaciones de los objetos que debe configurar para la operación Retrieve (recuperar). IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Para obtener más información sobre los objetos de negocio, consulte la sección “Business objects” en WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/ v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Página 56
Tabla 21. Atributos de nombre y tipo Nombre Tipo Parties ArIbm_R_Parties AccountSites ArIbm_R_Acct_Sites La siguiente figura muestra el aspecto que tiene el conjunto de objetos después del procedimiento de creación. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 57
Figura 19. Conjunto de objetos creados para la operación Retrieve (recuperar) 5. Cree los objetos de negocio restantes para la operación Retrieve (recuperar) Este paso describe cómo establecer el valor de Clave foránea y cómo añadir un objeto hijo a los objetos de negocio restantes que necesita crear para la operación Retrieve (recuperar).
Creación del componente Utilice el Editor de ensamblaje de WebSphere Integration Developer para crear un nuevo componente. Necesita hacer esto a fin de que la aplicación de ejemplo de entrada tenga un punto final que pueda percibir sucesos y recuperar y procesar datos.
1. Abra el Diagrama de ensamblaje para el componente JDBCInboundInterface. En la vista Integración empresarial de WebSphere Integration Developer, expanda el Módulo Oracle_Inbound. Pulse con el botón derecho en Oracle_Inbound, la primera entrada que aparecerá debajo del módulo expandido y seleccione Abrir con > Editor de ensamblaje. Esto abre el Diagrama de ensamblaje: JDBCInboundInterface.
Servidores. Figura 20. Vista Servidor 2. Si WebSphere Process Server no se está ejecutando, pulse con el botón 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 botón derecho del ratón en el nombre de su WebSphere Process Server y seleccione Añadir y eliminar proyectos. 4. En la lista Proyectos disponibles de la izquierda, seleccione el módulo del adaptador Oracle_Inbound y pulse Añadir.
3. En la ventana Seleccionar ubicación de despliegue, seleccione el servidor de aplicaciones donde se ejecutará la aplicación y, a continuación, 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 información de cliente que se esperaba del proceso de entrada.
Cómo realizar esta tarea 1. En WebSphere Integration Developer, en la perspectiva Integración 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.
Página 64
Pulse Añadir a lista de importación. Nota: Debido al gran número de procedimientos almacenados, es posible que la lista no se rellene inmediatamente. En la ventana Parámetros de configuración para FND_PROGRAM.EXECUTABLE, pulse Aceptar. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Página 65
Para Propiedades del adaptador de recursos, en Varios establezca el valor para el campo Proveedor de base de datos en Oracle. Pulse Finalizar. Para obtener información sobre estas propiedades, consulte la sección “Reference” del manual WebSphere Adapters: Adapter for JDBC User Guide. Para ver esa documentación, consulte http://publib.boulder.ibm.com/infocenter/ dmndhelp/v6rxmx/topic/com.ibm.wsadapters602.jca_jdb.
Servidores. Figura 21. Vista Servidor 2. Si WebSphere Process Server no se está ejecutando, pulse con el botón derecho en el nombre del mismo y seleccione Iniciar. Una vez que se inicie, la entrada Estado del mismo se actualizará a Iniciado.
Process Server y pulse Finalizar. Verificación de los resultados de la prueba en Oracle E-Business Suite Después de ejecutar la prueba en el cliente de prueba de integración de WebSphere Integration Developer, verifique si el programa simultáneo se ha creado en Oracle E-Business Suite.
6. Guarde los cambios. Visualización 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 sólo son para su referencia. Probablemente no se ejecutarán en su entorno del sistema de información de empresa.
Oracle E-Business Suite. Para problemas encontrados al ejecutar Adapter para JDBC, consulte la sección “Configuring troubleshooting tools” del manual WebSphere Adapters: Adapter for JDBC User Guide. Describe cómo habilitar el registro y el rastreo, cómo habilitar...
Página 70
Common Event Infrastructure y cómo instalar IBM Support Assistant. Para ver esa documentación, consulte http://publib.boulder.ibm.com/infocenter/dmndhelp/ v6rxmx/topic/com.ibm.wsadapters602.jca_jdb. IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Se proporciona información detallada sobre los mensajes e información relacionada con el producto para su consulta. Mensajes Los mensajes emitidos por IBM WebSphere Adapters se documentan en el centro de información de WebSphere Adapters, versión 6.0.2. Puede ver los mensajes del adaptador en el enlace siguiente: WebSphere Adapters messages..
Soporte y asistencia v Soporte del producto WebSphere Adapters v Notas técnicas de WebSphere Adapters - en el campo Additional search terms (Términos adicionales de búsqueda) especifique el nombre del adaptador y pulse Go (Ir). IBM WebSphere Adapters: Adapter para Oracle E-Business Suite Guía del usuario...
Los materiales en estos sitios web no forman parte de los materiales para este producto de IBM y la utilización de estos sitios web la realiza el usuario bajo su propia responsabilidad.
Página 76
Los usuarios de este documento deben verificar los datos disponibles para su entorno específico. La información 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 públicamente.