Programas de concurrencia del conector EBS en Jitterbit Design Studio

Los programas de concurrencia de EBS disponibles dentro del conector Oracle EBS te permiten utilizar programas concurrentes de Oracle EBS existentes para acceder a datos y funciones de Oracle EBS. Esto permite que Jitterbit llene las tablas de interfaz de Oracle, ejecute programas concurrentes y recupere información sobre el estado de la ejecución. Esta actividad se puede utilizar para inspeccionar el repositorio de integración en busca del esquema de las tablas de interfaz para el(los) programa(s) concurrente(s) seleccionado(s), así como los parámetros requeridos para ejecutar el programa concurrente.

El concepto y la implementación de programas concurrentes utilizados aquí son específicos de las aplicaciones de Oracle. Puedes aprender más sobre la implementación de programas concurrentes de Oracle en Guía del Administrador del Sistema de Oracle EBS - Definición de Programas y Solicitudes Concurrentes.

Esta página describe cómo utilizar programas de concurrencia de EBS en Jitterbit utilizando un ejemplo simplificado que primero llena las tablas de interfaz de Oracle con nuevos datos de clientes a través de una conexión de base de datos JDBC en Jitterbit, y luego llama a un programa de concurrencia de EBS para validar y aplicar los datos recién creados en las tablas base de Oracle.

Llenando tablas de interfaz de Oracle

Antes de utilizar un programa concurrente de Oracle en una operación de Jitterbit, ya deberías haber configurado una operación que proporcione los datos que deseas acceder con tu instancia de Oracle EBS. Esto se logra a través de la funcionalidad estándar proporcionada por Jitterbit y no es parte del Conector Oracle EBS.

Por ejemplo, la primera operación a continuación comienza con una fuente CSV local, luego transforma esos datos para su inserción en una base de datos Oracle EBS. Esta primera operación esencialmente llena las tablas de interfaz en la base de datos Oracle. La segunda operación, que ejecuta un programa de concurrencia seleccionado para validar y aplicar estos datos a las tablas base, es parte del Conector Oracle EBS y se cubrirá en otras secciones de esta página.

El procedimiento para configurar una operación que llena las tablas de interfaz de Oracle no es específico del Conector Oracle EBS y se puede configurar a través de una transformación estándar. Consulta Asistente de texto a base de datos para obtener instrucciones detalladas relacionadas con este ejemplo. También se puede utilizar una variedad de otras Fuentes para suministrar los datos para la operación.

En el ejemplo utilizado aquí, el objetivo de la base de datos Oracle EBS está configurado utilizando el controlador Oracle [JDBC] con las mismas credenciales que se utilizan para el punto final del conector ebs. El objetivo de la base de datos EBS configurado está preparado para esta operación de ejemplo de la siguiente manera:

Creando una operación de programa de concurrencia EBS

En el mismo proyecto donde has configurado la operación que proporciona los datos a las tablas de interfaz de Oracle, deberías crear otra operación que ejecute el programa de concurrencia para validar y aplicar estos datos a las tablas base de Oracle. Los pasos a continuación describen cómo crear una nueva operación para el programa de concurrencia, y después de que se haya creado esa operación, se muestra cómo encadenar la operación del programa concurrente para que se ejecute después de que la primera operación se haya completado con éxito.

1. Dentro de tu proyecto en Jitterbit Studio, hay varias formas de iniciar un nuevo programa de concurrencia de EBS. Cada una de las siguientes opciones iniciará el Asistente para el Programa de Concurrencia de EBS para guiarte a través del proceso.

   • Ve a Archivo > Nuevo > Conectores > Nuevo Programa de Concurrencia de EBS.
   • En el árbol a la izquierda bajo Conectores, haz clic derecho en la categoría Oracle EBS, luego selecciona Nuevo Programa de Concurrencia de EBS.
   • En el árbol a la izquierda bajo Conectores, haz doble clic en la categoría Oracle EBS, luego haz clic derecho en Programas de Concurrencia de EBS y selecciona Nuevo Programa de Concurrencia de EBS.
   • En la barra de herramientas superior, haz clic en el ícono del conector (pieza de rompecabezas naranja) . En la ventana emergente, selecciona Oracle EBS, luego selecciona Programa de Concurrencia de EBS.

2. La pantalla de Endpoint del Asistente para el Programa de Concurrencia de EBS debería abrirse en la vista principal de Studio. Esta pantalla solicita seleccionar el endpoint al que te gustaría acceder para obtener datos. Ya deberías haber configurado tu endpoint en endpoint del conector de EBS. Usa el menú desplegable para seleccionar el endpoint apropiado. Haz clic en Siguiente cuando termines.

   

3. La pantalla de Catálogo del Asistente para el Programa de Concurrencia de EBS presenta una lista de categorías que contienen programas concurrentes específicos disponibles dentro de tu instancia de Oracle EBS. Estos son específicos de EBS, y necesitarás saber bajo qué categoría se encuentra tu programa concurrente deseado dentro del catálogo de EBS.

   En este ejemplo, para crear nuevos datos de clientes en la instancia de Oracle EBS conectada, seleccionaremos la categoría "Cuentas por Cobrar". Luego haz clic en Siguiente para continuar.

   

   Nota

   Durante la selección de catálogo y programa, si tienes muchos elementos disponibles en tu instancia de EBS, es posible que debas esperar un momento para que se carguen. También puedes ingresar un nombre de elemento en el campo Filtro. Prueba el botón Actualizar si los resultados no son lo que esperabas.

4. La pantalla de Programa del Asistente de Programa de Concurrencia de EBS presenta una lista de los programas concurrentes específicos disponibles dentro de la categoría seleccionada. Estos son específicos de EBS, y necesitarás saber qué programa concurrente deseas utilizar.

   En este ejemplo, utilizaremos el programa concurrente "RACUST". Haz clic en Finalizar para continuar.

   

5. Jitterbit procederá a crear una estructura de solicitud y respuesta de API de EBS que definirá los parámetros dentro de tu programa concurrente. Debería aparecer una nueva pestaña en Studio llamada Programas de Concurrencia de EBS. Puedes renombrar tu programa de concurrencia aquí si lo deseas. También puedes usar los botones + - o las flechas para expandir todos los elementos dentro de cada estructura.

6. A continuación, en la misma pantalla, haz clic en el botón Crear Operación ubicado bajo Usar en una Integración en la esquina superior derecha. Esto creará la operación de Jitterbit que utilizará tu programa de concurrencia en Oracle EBS.

7. Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica del programa de concurrencia dentro de una operación de Jitterbit. Guarda tu operación haciendo clic en el ícono de disco simple para guardar solo esta operación o en el ícono de discos múltiples para guardar todos los cambios en tu proyecto de integración. Deberías ver que el asterisco en la pestaña Operaciones y el título de la operación desaparecen a medida que tu nueva operación de programa de concurrencia se crea y guarda en tu proyecto.

8. Si tienes otra operación que llena las tablas de interfaz de Oracle, puedes encadenar las dos operaciones juntas en este momento. Para hacerlo, haz clic derecho en el fondo de la primera operación y selecciona En Éxito > Operación > Seleccionar Existente, luego selecciona la operación existente que acabas de crear. En este caso, esta fue nuestra operación RACUST, que hemos nombrado "2. Ejecutar Programa de Concurrencia - RACUST." La pestaña Operaciones debería verse similar a la de abajo.

   

   Nota

   Los íconos de Source, Request, Response y Target en la imagen anterior son marcadores de posición para los componentes de la operación, que definiremos en la siguiente sección.

Definiendo los componentes de la operación del programa de concurrencia

A continuación, necesitamos definir los otros componentes de la operación del programa de concurrencia, incluyendo Source, Request, Response y Target.

Puedes regresar a la representación gráfica de la operación que has creado y hacer doble clic en cada ícono para configurar cada componente, o puedes crear Source, Request, Response y Target por separado y luego arrastrarlos y soltarlos desde el árbol a la izquierda directamente sobre los íconos en la representación visual de tu operación.

Se pueden utilizar muchos tipos diferentes de datos para cada componente de la operación. Para aprender más sobre opciones de personalización adicionales, consulta la sección de Design Studio de nuestra documentación.

• Source: Con el fin de simplificar este ejemplo, la fuente estará codificada de forma fija. Por lo tanto, eliminaremos la fuente haciendo clic derecho en el ícono de la fuente en el gráfico de operación y seleccionando Remove From Graph.

  Nota

  Hay una variedad de tipos de fuente disponibles en Jitterbit. Consulta Sources para más información.

• Target: Haz doble clic en el ícono de Target. Con el fin de simplificar este ejemplo, vamos a enviar el resultado, el estado y la fase de la operación a un archivo XML. Haz clic en el botón Create New Target, asigna un Name a tu destino (por ejemplo, Example Target). Para este ejemplo, estamos utilizando un agente privado con archivos locales habilitados, y por lo tanto seleccionamos un Type de "Local File" y Browse a una ubicación en el agente privado donde queremos guardar los datos. Ingresa una Folder y un Filename que te gustaría guardar.

  Nota

  También puedes exportar a una variedad de tipos de destino diferentes. El tipo no tiene que ser el mismo que el tipo de origen. Consulta Targets para ver las opciones.

• Request: Haz doble clic en el ícono de Request y selecciona Create New Transformation. Esto abrirá el Transformation Wizard que te guiará a través de la creación de la solicitud.

  Nota

  Se proporciona información adicional sobre las estructuras de solicitud en Transformations.

  1. En la primera pantalla, Name, proporciona un Name para tu transformación o déjalo como el predeterminado. Luego usa el menú desplegable Source para seleccionar la fuente para la transformación. En el ejemplo, nuestra fuente está codificada, así que seleccionaremos "None." Haz clic en Finish para continuar.

  2. La pestaña Transformations debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los elementos de origen y destino en cada árbol. En una transformación estándar, arrastrarías y soltarías cada campo que te gustaría mapear de un árbol al otro. Para este ejemplo, para codificar la fuente, haz doble clic en cada campo del lado de destino y escribe los siguientes valores en el script:

     TARGET: EBS Concurrency Program: RACUST INPUT > RACUST > HEADER	Script
     USER_NAME	<trans> "SERVICES" </trans>
     RESPONSIBILITY	<trans> "QUICK_CUSTOMER" </trans>
     RESP_APPLICATION	<trans> "AR" </trans>
     SECURITY_GROUP	<trans> "STANDARD" </trans>
     SERVER_NAME	<trans> "" </trans>
     ORG_ID	<trans> "204" </trans>

     OBJETIVO: Programa de Concurrencia EBS: RACUST ENTRADA > RACUST > ENTRADAS_DEL_PROGRAMA	Script
     APLICACIÓN	<trans> "AR" </trans>
     PROGRAMA	<trans> "RACUST" </trans>
     DESCRIPCIÓN	<trans> "INVENTARIO" </trans>
     HORA_INICIO	<trans> "" </trans>
     SUB_SOLICITUD	<trans> "" </trans>
     CREAR_CLIENTE_RECÍPROCO	<trans> "1" </trans>
     ID_ORG	<trans> "204" </trans>

     Después de codificar la fuente, tu mapeo de transformación debería verse similar al que se muestra a continuación.

     

• Respuesta: Haz doble clic en el ícono de Respuesta y selecciona Crear Nueva Transformación. Esto abrirá el Asistente de Transformación que te guiará a través de la creación de la respuesta.

  Nota

  Se proporciona información adicional sobre las estructuras de respuesta en Transformaciones.

  1. En la primera pantalla, Nombre, proporciona un Nombre para tu transformación o déjalo como el predeterminado. Luego usa el menú desplegable Objetivo para seleccionar el objetivo de la transformación. En el ejemplo, queremos usar la respuesta de EBS, así que seleccionamos "Respuesta de Función de Oracle EBS." Haz clic en Siguiente para continuar.

  2. En la siguiente pantalla, Target, utiliza el menú desplegable para seleccionar el programa de concurrencia que ya has configurado (por ejemplo, "RACUST"). La parte inferior de la pantalla mostrará las estructuras de solicitud y respuesta asociadas con este programa. Haz clic en Finish para continuar.

  3. La pestaña Transformations debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los lados de origen y destino. Haz clic y arrastra la carpeta "OUTPUT" del lado izquierdo (lado de origen) a la carpeta "OUTPUT" en el lado derecho (lado de destino). Tu pantalla de mapeo debería verse similar a la de abajo.

     

La configuración final de la operación debería verse similar a la de abajo.

Implementar y ejecutar las operaciones

Con la operación para insertar datos en las tablas de interfaz de Oracle, así como la operación del programa de concurrencia de EBS completamente configuradas, estamos listos para desplegar y ejecutar las operaciones.

1. Desde la primera operación dentro de la pestaña Operations, haz clic en el icono de desplegar .
2. Luego haz clic en el icono de ejecutar para colocar las operaciones en la cola para su ejecución. La primera operación se completará primero, seguida de la segunda operación que está encadenada para ejecutarse si la primera operación es exitosa.
3. En la parte inferior de la pantalla, el Operation monitor debería indicar que tu primera operación se ejecutó con éxito. Si no, puedes hacer doble clic en el icono de Status para ver cualquier mensaje de registro. Si deseas verificar que tu segunda operación también se haya ejecutado con éxito, también puedes hacer clic derecho en Operations en el árbol de la izquierda y seleccionar Operation Log para ver los registros de todas las operaciones en tu proyecto.
4. También deberías ver ahora la respuesta de salida que se mapeó a tu archivo de destino. En el ejemplo, el archivo XML ahora se crea localmente en la ubicación que especificaste. Dado que la operación se ejecutó con éxito, vemos un resultado de "Success," un estado de "Normal," y una fase de "Completed."