Saltar al contenido

Tipos de acción de evento en Jitterbit App Builder

App Builder admite muchos tipos de acción de Evento diferentes que se pueden definir para acciones asociadas con eventos, dependiendo del uso previsto de la acción. Esta página describe los diferentes tipos de acción y cómo se pueden trabajar con ellos.

Para acceder a los diferentes tipos de acción de Evento:

  1. Selecciona App Workbench > Reglas.

  2. Localiza la tabla (o regla) donde deseas definir una acción y haz clic en su ícono correspondiente de Eventos. Se abre el diálogo de Todos los Eventos.

  3. Selecciona el evento intrínseco o personalizado que debería activar la acción haciendo doble clic en su fila. Se abre un diálogo.

  4. En el panel de Acciones, selecciona Registrar y configura el tipo de acción en el diálogo de Acción resultante (en la imagen).

    Diálogo de acción

Hay nueve tipos de acción disponibles, divididos en Básico y Caso Especial. El tipo de acción predeterminado es Regla, ya que es el más utilizado. Los tipos de acción básicos, reglas y notificaciones, están documentados por separado, mientras que esta página documenta los tipos restantes.

Tipos de acción:

Llamada a API

Utiliza el tipo de acción Llamada a API para llamar a un Administrador de API o punto final REST como una acción. Para configurar una acción de Llamada a API, accede al diálogo de Acción como se describió anteriormente y luego configura estos campos:

  • Tipo: Establecer en Llamada a API.

  • Punto final: Selecciona el punto final nombrado para llamar con la acción.

  • Etiqueta: (Opcional) Ingresa una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama de eventos. Si no se proporciona ninguna etiqueta, se utilizará el nombre del punto final.

  • Posición

    • Orden: Ingresa un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuándo: Establece en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresa una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haz clic en Guardar.

Nota

Desde la perspectiva de REST, App Builder admite enlaces entrantes y salientes. Las columnas entrantes se envían al punto final, y las salientes provienen de la respuesta del punto final y actualizan el registro en memoria con el valor de REST. Usar un enlace saliente puede resultar en un mensaje de error si la respuesta contiene múltiples registros, ya que App Builder no sabe qué registro usar en este escenario.

Evento

Utiliza el tipo de acción Evento para ejecutar otro evento nombrado. Para configurar una acción de Evento, accede al diálogo de Acción como se describió anteriormente y luego configura estos campos:

  • Tipo: Establece en Evento.

  • Regla: Selecciona la regla que realizará la acción.

  • Evento: Selecciona el evento que la acción invocará.

  • Tratar Advertencias de Validación Como Errores: Habilitado por defecto. Desactiva esta opción si deseas permitir que el evento invocado reciba cualquier advertencia de validación que el usuario eligió continuar, pero cualquier acción anterior a esta se ejecutará nuevamente. Para evitar esto, considera agregar la misma validación en el evento actual (llamador).

  • Etiqueta: (Opcional) Ingresa una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama del evento. Si no se proporciona ninguna etiqueta, se utilizará el nombre del evento objetivo.

  • Posición

    • Orden: Ingresa un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuándo: Establece en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresa una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haz clic en Guardar.

Exportar

Utiliza el tipo de acción Exportar para exportar un informe a un archivo. Esta acción exporta un archivo, lo escribe utilizando comas, tuberías o tabulaciones como delimitadores, y luego lo almacena en la ubicación deseada. Para configurar una acción de Exportar, accede al diálogo de Acción como se describió anteriormente y luego configura estos campos:

  • Tipo: Establecer en Exportar.

  • Regla: Selecciona la regla que realizará la acción.

  • Sistema de Archivos: Selecciona dónde almacenar la información que se está exportando. Esto puede ser un sistema de archivos local o de red.

  • Delimitador: Selecciona qué delimitador (comas, tuberías o tabulaciones) se utilizará para el archivo.

  • Encabezados de Salida: Habilita esta opción si el archivo que se está exportando incluye una fila de encabezado. Deshabilitado por defecto.

  • Columna de Nombre de Archivo: Selecciona la columna del nombre de archivo de la regla de negocio o tabla que se está haciendo referencia.

  • Etiqueta: (Opcional) Ingresa una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama de eventos. Si no se proporciona ninguna etiqueta, se utilizará el nombre de la regla.

  • Posición

    • Orden: Ingresa un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuando: Establecer en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresa una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haz clic en Guardar.

Importar

Utiliza el tipo de acción Importar para importar datos de un sistema de archivos a una o varias tablas. Puedes importar archivos CSV, Excel o HL7. Para configurar una acción de Importar, accede al diálogo de Acción como se describió anteriormente y luego configura estos campos:

  • Tipo: Establecer en Importar.

  • Tipo de Importación: Selecciona el tipo de archivo que se va a importar, ya sea CSV o Excel o HL7.

  • Truncar: (Opcional) Habilita esta opción si deseas que App Builder elimine el contenido de la tabla de destino al importar. Desactivado por defecto.

  • Sistema de Archivos: Selecciona dónde almacenar la información que se está importando. Esto puede ser un sistema de archivos local o de red.

  • Tabla de Destino: Selecciona la tabla nombrada donde residirá el archivo importado.

  • Delimitador: Selecciona qué delimitador (comas, tuberías o tabulaciones) se utilizará para el archivo.

  • Ubicación del Archivo Completado: Selecciona la ubicación del archivo donde se moverá el archivo de importación. Deja este campo en blanco si es el mismo que el Sistema de Archivos.

  • Etiqueta: (Opcional) Ingresa una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama de eventos. Si no se proporciona una etiqueta, se utilizará el nombre de la tabla.

  • Posición

    • Orden: Ingresa un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuando: Establece en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresa una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haz clic en Guardar.

Nota

Los enlaces explícitos no tienen ningún impacto en la importación.

Nota

La acción Importar importa archivos grandes en lotes secuenciales de 1,000 registros. Como cada lote se confirma de manera independiente, un fallo en un lote no revierte los que fueron exitosos anteriormente. Para evitar la duplicación de datos al volver a ejecutar una importación fallida, elimina los registros que ya fueron importados de tu archivo en lugar de reiniciar desde el principio.

Plugin

Utiliza el tipo de acción Plugin para invocar un complemento de acción en App Builder. Para configurar una acción Plugin, accede al diálogo de Acción como se describió anteriormente y luego configura estos campos:

  • Tipo: Establecer en Plugin.

  • Complemento: Selecciona el complemento que realizará la acción. Los complementos disponibles son:

    • Limpiar Caché de Endpoint: Cancela cualquier caché de endpoint generado por acciones anteriores.

    • Commit Event Transactions: Confirma cualquier transacción abierta del evento padre (directamente en el evento o en uno de sus padres).

    • Create Row on Empty Table: Crea una nueva fila si el evento Filter no devuelve ninguna fila.

    • Http Retriever: Recupera contenido de la columna URL y lo almacena en la columna Result.

    • JWT Generator: Genera un Token Web JSON (JWT).

    • Persistable – Refresh Row: Actualiza una fila.

    • Persistable Salesforce – Refresh Rw: Actualiza una fila.

    • Pluralize Name: Pluraliza y humaniza un campo de Name.

    • Run Background Event: Ejecuta el evento Background para el objeto de datos (en segundo plano).

    • Save Report: Guarda el informe en el directorio PDF.

    • Security Provider Hash Password: Hashea el valor de la columna Password utilizando un proveedor de seguridad dado.

    • Security Provider Password Hash Verifier: Verifica una contraseña hasheada utilizando un proveedor de seguridad dado.

    • Sleep: Pausa durante un segundo o un período de Timeout personalizado (en milisegundos).

    • SMTP Mailer: Envía correo utilizando los campos Email, Subject y opcionales Body y From. La sustitución usando {{ field }} está disponible dentro del Body y Subject.

    • Throw Exception: Lanza una excepción.

  • Label: (Opcional) Ingresa una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama del evento. Si no se proporciona una etiqueta, se utilizará el nombre del plugin.

  • Position

    • Order: Ingresa un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Active: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • When: Establece en Before o After para determinar cuándo debe ejecutarse la acción.

  • Technical Help: (Opcional) Ingresa una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haz clic en Save.

Procedure

Utiliza el tipo de acción Procedure para ejecutar un procedimiento almacenado de RDBMS (Sistema de Gestión de Bases de Datos Relacionales). Para configurar una acción Procedure, accede al diálogo de Action como se describió anteriormente y luego configura estos campos:

  • Tipo: Establecer en Plugin.

  • Procedimiento: Seleccionar el procedimiento almacenado que se ejecutará.

  • Etiqueta: (Opcional) Ingresar una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama de eventos.

  • Posición

    • Orden: Ingresar un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuando: Establecer en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresar una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haga clic en Guardar.

RFC (Llamada a Función Remota)

Utilice el tipo de acción RFC para ejecutar una llamada a función remota. Los RFC se utilizan principalmente al trabajar con SAP externamente y configurar llamadas BABI de RFC y lecturas de tablas RFC. Para configurar una acción RFC, acceda al diálogo de Acción como se describió anteriormente y luego configure estos campos:

  • Tipo: Establecer en RFC.

  • RFC: Seleccionar la función que se llamará.

  • Etiqueta: (Opcional) Ingresar una etiqueta (máx. 30 caracteres) que se mostrará en el diagrama de eventos.

  • Posición

    • Orden: Ingresar un valor para controlar el orden de ejecución cuando se ejecute en un evento.

    • Activo: Habilitado por defecto, esta opción determina si la acción se ejecutará.

    • Cuando: Establecer en Antes o Después para determinar cuándo debe ejecutarse la acción.

  • Ayuda Técnica: (Opcional) Ingresar una descripción de las responsabilidades y el comportamiento de la acción para ayudar a otros desarrolladores.

Para completar la creación de la acción, haga clic en Guardar.