Notificaciones en Jitterbit App Builder

Descripción general

Las notificaciones son mensajes que App Builder envía a los usuarios de tu aplicación cuando ocurre un evento, como un clic en un botón o una verificación programada. Una notificación se puede entregar como correo electrónico, mensaje de texto, alerta en la aplicación o notificación push, y opcionalmente puede permitir que el destinatario responda navegando a una página o activando un evento.

Esta página describe los tres pasos necesarios para configurar notificaciones en tus aplicaciones:

1. Configurar un servidor de notificaciones
   Configura el servidor utilizado para entregar notificaciones.

2. Crear una notificación
   Define el contenido del mensaje y el objeto utilizado para enviarlo.

3. Agregar opciones de respuesta
   Opcionalmente, permite que los destinatarios respondan navegando a una página o activando un evento.

Esta página también incluye tutoriales completos de todo el proceso, con dos ejemplos: una notificación en la aplicación y un mensaje SMS.

Para mensajes enviados por administradores a múltiples usuarios a la vez, en lugar de ser activados por un evento de la aplicación, consulta Notificaciones del sistema.

Paso 1: Configurar un servidor de notificaciones

Antes de poder enviar una notificación, debes configurar al menos un servidor de notificaciones para el método de entrega que planeas utilizar. App Builder admite los siguientes métodos de entrega:

• Correo electrónico, enviado a través de un servidor SMTP.

• SMS (mensaje de texto), enviado a través de Twilio.

• En la aplicación (alerta de App Builder), una ventana emergente que se muestra al destinatario mientras está conectado a la aplicación.

• Push, enviado a través de Jitterbit Blabber, para aplicaciones que utilizan Jitterbit Wrapper o un wrapper personalizado, u OneSignal, para aplicaciones móviles nativas que utilizan tu propia cuenta de OneSignal.

Para ver y administrar servidores de notificaciones, selecciona IDE > Notification Servers:

La lista de servidores está compuesta por las siguientes columnas:

• Name: El nombre del servidor.

• Type: El tipo de notificación que se puede configurar con ese servidor.

• Description: Una breve descripción.

• URI: El URI (si aplica).

• Status: El estado actual del servidor.

Haz doble clic en cualquier fila o haz clic en el icono al final para ver y editar los detalles de un servidor determinado. Todos los servidores excepto In-app requieren configuración antes de usarse:

• SMTP (Correo electrónico) requiere que se completen la dirección de origen, el URI y las secciones de Security.
• Blabber, OneSignal y SMS requieren que se complete la sección de Security.

Paso 2: Crear una notificación

Crear una notificación significa crear una regla de negocio con su Purpose establecido en Notification, desde la pestaña Notifications del App Workbench. La regla define el contenido del mensaje de la notificación y selecciona el objeto de datos público (Delivery Method) utilizado para enviarlo, como Email, Text Message, App Builder Alert o Push Notification.

Para crear una notificación:

1. Navega a App Workbench > Notifications.
2. Haz clic en + Notification.
3. Asígnale un Name.
4. Confirma que Purpose sea Notification.
5. Selecciona el Delivery Method que deseas utilizar. Cada método de entrega envía una notificación a través de un objeto de datos público específico, que determina los detalles de la notificación. Si el objeto de datos que necesitas no está disponible, es posible que debas crear una conexión de fuente de datos a App Builder (Sealed) para la aplicación en la que estás trabajando.
6. Haz clic en Create.

Al hacer clic en Create se abre el Rule Builder en modo de edición, donde defines las columnas que utiliza la notificación, de la misma manera que lo harías al editar cualquier otra regla de negocio. Para las columnas disponibles en cada método de entrega, consulta Objetos de datos públicos por método de entrega a continuación.

Objetos de datos públicos por método de entrega

Cada método de entrega envía una notificación a través de un objeto de datos público específico — un conjunto predefinido de columnas que determina detalles como el destinatario, remitente y comportamiento de entrega. El Método de Entrega que selecciones al crear una notificación determina a cuál objeto de datos público deben asignarse las columnas de tu notificación, en la definición mvSQL del Rule Builder.

Las siguientes secciones describen las columnas disponibles para cada objeto de datos público, además de las columnas comunes a todos ellos.

Columnas comunes

Estas columnas son comunes a cada objeto de datos público descrito a continuación:

Correo electrónico

Las columnas para el objeto de datos público Email son las siguientes:

Las notificaciones enviadas por correo electrónico pueden incluir archivos adjuntos de muchos tipos de archivo, como .pdf, .docx, .txt o .xlsx, utilizando las columnas Attachment() y FileDataSourceId descritas a continuación. App Builder adjunta archivos del directorio data/pdf de forma predeterminada, o del directorio especificado por FileDataSourceId.

Si la notificación contiene opciones, la columna AppBuilderUrl especifica la URL utilizada al generar enlaces a esas opciones. Si no se proporciona AppBuilderUrl, App Builder recurre a la URL predeterminada del sitio del servidor, configurada desde IDE > Security Providers > More (desde el panel Configuration) > Sites. Para más información, consulta Sites and aliases.

Mensaje de Texto

El objeto de datos público Mensaje de Texto se utiliza para enviar mensajes SMS. Las columnas del objeto de datos público Mensaje de Texto son las siguientes:

Alerta de App Builder

Las columnas del objeto de datos público Alerta de App Builder son las siguientes. Este objeto es similar, pero no idéntico, al objeto de datos público Notification_Create.

Notificación Push

El objeto de datos público Notificación Push envía una notificación push a un usuario. Las columnas del objeto de datos público Notificación Push son las siguientes:

Escribir el mensaje de notificación

Para escribir el mensaje de la notificación, haz clic en la pestaña Notificaciones nuevamente y selecciona tu notificación del panel Reglas de Notificación. Ingresa el mensaje en el campo Body del panel Mensaje; este campo es obligatorio y el evento de notificación falla con un error si se deja vacío.

El mensaje admite sustituciones usando la sintaxis {{fieldname}}, que App Builder reemplaza con el valor de columna correspondiente cuando se envía la notificación. Por ejemplo, el cuerpo puede contener:

Hola {{CustomerName}},

En este ejemplo, CustomerName debe estar contenido en las columnas de la regla de notificación junto con los otros campos requeridos. Las sustituciones pueden agregar una bandera url opcional para indicar que el valor es una URL y requiere codificación de URL, por ejemplo {{fieldname|url}}. Una bandera HTML opcional trata el marcado HTML en el valor como texto sin formato, por ejemplo {{fieldname|HTML}} sustituye un valor de <b>Jitterbit</b> como Jitterbit.

Para la mayoría de los mensajes, editar el campo Body de texto sin formato es suficiente. Si necesitas un formato personalizado más allá del texto sin formato, haz clic en Más > Editar HTML para editar directamente el HTML subyacente del mensaje.

Para correos electrónicos, también debe especificarse un Asunto, que también admite sustituciones; como el campo Body, dejar vacío causa que el evento de notificación falle con un error.

Traducciones

Si tu aplicación admite varios idiomas, también puedes traducir una notificación. Tres campos admiten esto: el Body de la notificación, su Asunto (para correos electrónicos) y el Nombre de cada opción de respuesta. En lugar de ingresar texto literal en estos campos, ingresa una clave de traducción; App Builder busca el valor para el idioma del destinatario en el paquete de traducciones de la aplicación cuando se envía la notificación.

Debe agregar manualmente estas claves de traducción al paquete de traducción de la aplicación; App Builder no las importa automáticamente.

Si edita el mensaje usando More > Edit HTML, agregue la clave de traducción como una cadena de texto sin formato en lugar de HTML, o la búsqueda fallará.

Para obtener más información sobre cómo configurar idiomas y paquetes de traducción, consulte Translations.

Step 3: Add response options

Una notificación puede incluir opcionalmente una o más opciones de respuesta que permiten al destinatario responder. Una notificación sin opciones es puramente informativa: App Builder no registra una respuesta y no se agregan enlaces al mensaje.

Cuando una notificación tiene una o más opciones, App Builder registra automáticamente la respuesta del destinatario. Para correos electrónicos y alertas de App Builder, cada opción es un enlace en el que se puede hacer clic para volver a App Builder. Para SMS, el destinatario responde con el Name de la opción para seleccionarla.

Los enlaces de notificación expiran después de 7 días y no se pueden configurar para que duren más tiempo.

Para agregar una opción de respuesta a una notificación:

1. En el panel Options de la notificación, haga clic en el botón + Option.
2. Establezca Index para determinar el orden de la opción en relación con otras opciones.
3. Establezca Name para identificar la opción. Para una opción SMS Reply, este es también el texto con el que el destinatario debe responder.
4. Establezca Option Type en Link o SMS Reply.
5. Para una opción Link, seleccione la página a la que vincular en Link To Page. La página debe estar marcada como Public en su configuración Edge Case.
6. Haga clic en Save.

Navegar a la página seleccionada en Link To Page completa la respuesta para una opción Link. Si esa página también tiene un evento de lógica empresarial vinculado a ella, el evento se ejecuta antes de que se represente la página, y completar la respuesta también depende de que ese evento se ejecute correctamente. Consulte Data object event binding a continuación para conocer las restricciones que se aplican a ese evento.

Data object event binding

Cuando la página vinculada en el campo Link To Page de una opción de respuesta también tiene un evento de lógica empresarial vinculado a ella, ese evento debe pertenecer al primer panel de la página (el panel con el índice más bajo, en la posición superior izquierda) o al objeto de datos público de la página, si se define uno. Los eventos que pertenecen a cualquier otro panel de la página no se pueden vincular a una opción de respuesta.

Por ejemplo, considere una página apilada con dos grupos uno al lado del otro: el primero, con índice 10, contiene los paneles Customer y CustomerAddress, y el segundo, con índice 20, contiene los paneles Employee y EmployeeAddress:

Customer es el primer panel de la página, por lo que sus eventos son elegibles. CustomerAddress, Employee y EmployeeAddress no son elegibles, ya que ninguno de ellos es el primer panel de la página.

App Builder también solo permite vincular a eventos personalizados, no a eventos del sistema. Por ejemplo, no puede vincular a los eventos Save, Insert, Update o Delete.

Cuando se completa el evento vinculado, App Builder redirige al destinatario a la página, pero cualquier mensaje posterior o resultado de validación del evento se pierde para entonces, ya que App Builder no muestra esos elementos al destinatario para eventos a nivel de página. Puede solucionar esto mostrando datos en los paneles de la página que cambien según si el evento se ejecutó correctamente. Por la misma razón, una advertencia de validación simplemente impide que el evento se ejecute, porque no hay mecanismos para que el destinatario la acepte o rechace.

En este punto, tiene todo lo que necesita para crear una notificación: un servidor para entregarla, una regla que defina su mensaje y datos, y, opcionalmente, una o más opciones de respuesta.

Full walkthroughs

Los siguientes ejemplos le guían a través de todo el proceso de creación de una notificación, desde la configuración de un método de entrega hasta la adición de una opción de respuesta. El primer ejemplo utiliza App Builder Alert como método de entrega; el segundo utiliza Text Message (SMS).

Configuración de notificación de ejemplo

Este ejemplo añade una notificación de aprobación de cliente a la página Clientes de una aplicación hipotética llamada Northwinds, utilizando Alerta de App Builder como método de entrega.

1. Crea la notificación y establece su método de entrega:

   1. Navega a App Workbench.
   2. Haz clic en Notificaciones.
   3. Haz clic en + Notificación.
   4. Asígnale un Nombre. Por ejemplo: CustomersRequestApprovalAlert.
   5. Confirma que Propósito es Notificación.

   6. Selecciona Alerta de App Builder como Método de entrega.

      Nota

      Si no ves este objeto de datos disponible, crea una conexión de fuente de datos a App Builder (Sealed) para la aplicación en la que estés trabajando.

   7. Haz clic en Crear.

2. Define el mvSQL de la notificación, asignando la tabla Clientes a las columnas que el objeto Alerta de App Builder necesita:

   1. Haz clic en el botón +Tablas.
   2. Añade tu tabla Seleccionar desde, que en este caso es Clientes.

   3. Añade las siguientes columnas y haz clic en la pestaña Columnas para definir:

      Columna	Alias	Destino
      'all'	To	To
      "C".CustomerId	CustomerId	Binding()
      "C".CustomerName	CustomerName

      Nota

      CustomerName se añade aquí para que pueda usarse más adelante como parámetro de sustitución en el mensaje de notificación.

3. Escribe el mensaje de la notificación:

   1. Navega a App Workbench.
   2. Haz clic en Notificaciones.
   3. Selecciona la notificación que creaste en el paso 1, que en nuestro ejemplo es CustomerRequestApprovalAlert.

   4. Introduce el mensaje en el campo Cuerpo, por ejemplo:

      Por favor, revisa el siguiente cliente:
      Cliente: {{CustomerName}}

   5. Haz clic en el icono e introduce cualquier Ayuda técnica para ayudar a explicar la notificación a otros desarrolladores.

4. (Opcional) Añade una opción de respuesta que enlace a una página:

   1. Desde la página App Workbench > Notificaciones, selecciona la notificación.
   2. Haz clic en el botón + Opción.
   3. Crea una nueva opción:
      1. Establece Índice en 10.
      2. Establece Nombre en Revisar.
      3. Selecciona el valor Enlazar a página. En este ejemplo, enlaza a la página Clientes. Si la página a la que deseas enlazar no aparece, asegúrate de que esté marcada como Pública en su configuración de Caso extremo.
      4. Haz clic en Guardar.

5. Este ejemplo asume que la página Clientes ya está marcada como Pública, con un evento llamado Solicitar aprobación definido en su primer panel. Vincula ese evento a la opción de enlace, para que se ejecute cuando el destinatario lo siga:

   1. Navega al evento del objeto de datos.
   2. Haz clic en el icono Lógica empresarial.
   3. Haz clic en el botón Eventos.
   4. Selecciona el evento. Por ejemplo: Solicitar aprobación.
   5. Haz clic en Registrar existente desde el panel Acciones.
   6. Selecciona Notificación como Tipo de acción.
   7. Selecciona la notificación que creamos en el paso anterior. Por ejemplo: CustomerRequestApprovalAlert.
   8. Haz clic en Guardar.
   9. Verifica que los Enlaces explícitos sean correctos. Por ejemplo: CustomerId - CustomerId.

6. Prueba la notificación. Navega a tu página y haz clic en el botón que ejecuta el evento de notificación. Todos los usuarios de App Builder que hayan iniciado sesión deberían ver una ventana emergente con el mensaje de notificación.

Configuración de notificación SMS de ejemplo

Este ejemplo añade la misma notificación de aprobación de cliente a la misma página Clientes, utilizando Mensaje de texto (SMS) como método de entrega.

1. Configura la seguridad de App Builder, para que App Builder pueda autenticar las respuestas SMS entrantes de Twilio:

   1. Navega a IDE > Proveedores de seguridad.
   2. Haz clic en + Autenticación de usuario en el panel Autenticación de usuario.
      1. Introduce un Nombre (p. ej. Autenticación HTTP básica).
      2. Selecciona Autenticación HTTP básica como Tipo.
      3. Haz clic en Habilitado para habilitar.
      4. Haz clic en Guardar.
   3. Navega a IDE > Gestión de usuarios.
      1. En el panel Usuarios, localiza el usuario que deseas autenticar cuando llegue una respuesta SMS. Haz doble clic en la fila del usuario o haz clic en el icono al final de la misma. Se abre el diálogo Usuario.

1. Haz clic en Más > Claves. Se abre el diálogo Claves.
2. Haz clic en Crear. Se abre el diálogo Generar clave.
3. Selecciona el proveedor Http Basic Auth creado anteriormente.
4. Haz clic en Guardar.

1. Configura Twilio para enviar y recibir mensajes SMS:

   1. Crea un servicio de mensajería:

      1. Inicia sesión en tu cuenta de Twilio.
      2. Ve a Communications Cloud > Programmable SMS.
      3. Haz clic en Messaging Services.
      4. Crea un nuevo Messaging Service (Notificaciones, bidireccional) y adjunta un número de teléfono de Twilio a él.
      5. Anota el MessagingServiceSid. Se utilizará para la configuración más adelante.
      6. Habilita la opción Process Inbound Message.
      7. Ingresa la siguiente URL de solicitud, reemplazando <username>, <secret_key> y <your_AppBuilder_Server> con tus valores: https://<username>:<secret_key>@<your_AppBuilder_Server>/webhook/v1/vinyl/bridge_inbound

   2. Recopila las credenciales de Twilio:

      1. Ve a Console Dashboard > Settings.
      2. Anota las siguientes credenciales activas:
         • Account Sid
         • Auth Token

2. Conecta App Builder a Twilio, utilizando las credenciales recopiladas en el paso anterior:

   1. Ve a IDE > Servidores de notificación.
   2. Haz doble clic en la fila SMS.
   3. Agrega la siguiente configuración:
      • Nombre de usuario: Ingresa tu Account Sid de Twilio.
      • Contraseña: Ingresa tu Auth Token de Twilio.
      • MessagingServiceSid: Ingresa tu MessagingServiceSid de Twilio.

3. Establece la URL del sitio web que App Builder utiliza al generar enlaces en el mensaje SMS:

   1. Ve a IDE > Proveedores de seguridad.
   2. En Configuración, haz clic en Más > Sitios.
   3. Haz clic en + Sitio.
   4. Establece el valor de URL a la URL de tu sitio web. Por ejemplo: https://vinyl.jitterbit.com.
   5. Haz clic en Guardar.

4. Ahora, crea y configura la notificación SMS misma, siguiendo el mismo proceso general que el ejemplo anterior, pero esta vez, en lugar de App Builder Alert, selecciona Mensaje de texto como el Método de entrega:

   1. Crea la notificación y establece su método de entrega:

      1. Ve a App Workbench > Notificaciones.
      2. Haz clic en + Notificación.
      3. Asígnale un Nombre.
      4. Selecciona Notificación como el Propósito.

      5. Selecciona Mensaje de texto como el Método de entrega.

         Nota

         Si no ves este objeto de datos disponible, crea una conexión de fuente de datos a App Builder (Sealed) para la aplicación en la que estés trabajando.

      6. Haz clic en Crear.

   2. Define el mvSQL de la notificación, asignando el número de teléfono y las columnas del cliente al objeto Mensaje de texto:

      1. Haz clic en el botón +Tabla y agrega la tabla que requiere la regla. Por ejemplo, Customers.

      2. Haz clic en la pestaña Columnas y agrega las siguientes columnas:

         Columna	Alias	Destino
         '+15551112222' (reemplaza con tu número de teléfono)	To()	To()
         "C".CustomerId	CustomerId	Binding()
         "C".CustomerName	CustomerName

         Nota

         CustomerName se agrega aquí para que pueda usarse más adelante como parámetro de sustitución en el mensaje de notificación.

   3. Escribe el mensaje y agrega dos opciones de respuesta: una a la que el destinatario pueda responder por SMS y otra que enlace a una página:

5. Haz clic en la pestaña Notificaciones. 2. Ingresa el siguiente mensaje en el campo Cuerpo:

       ```
       Reply {{1}} to approve {{CustomerName}}. Review {{Review}}
       ```
   
   3.  Haz clic en el botón **+ Opción** del panel **Opciones**:
       1.  Establece **Índice** en `10`.
       2.  Establece **Nombre** en **Revisión**.
       3.  Selecciona la página a la que deseas vincular. En nuestro ejemplo, nos vincularemos a la página **Cliente** de Northwinds. Si la página que deseas vincular no aparece, asegúrate de que esté marcada como **Pública** en su configuración de **Caso Extremo**.
       4.  Establece el **Tipo de Opción** en **Vínculo**.
       5.  Haz clic en **Guardar**.
   
   4.  Haz clic en el botón **+ Opción** del panel **Opciones**:
       1.  Establece **Índice** en `20`.
       2.  Establece **Nombre** en **1**.
       3.  Selecciona la página a la que deseas vincular. En nuestro ejemplo, nos vincularemos a la página **Cliente** de Northwinds y ejecutaremos el evento `Approve`.
       4.  Establece el **Tipo de Opción** en **Respuesta SMS**.
       5.  Haz clic en **Guardar**.
   

   1. Este ejemplo asume que la página Clientes ya está marcada como Pública, con un evento llamado Request Approval definido en su primer panel. Vincula ese evento a la opción Vínculo, para que se ejecute cuando el destinatario la siga:

      1. Navega al evento del objeto de datos.
      2. Haz clic en el icono Lógica de Negocio.
      3. Haz clic en el botón Eventos.
      4. Selecciona el evento. Por ejemplo: Request Approval.
      5. Haz clic en Registrar Existente del panel Acciones.
      6. Selecciona Notificación como el Tipo de Acción.
      7. Selecciona la notificación que creamos en el paso anterior. Por ejemplo: Customer_RequestApprovalSms.
      8. Haz clic en Guardar.
      9. Verifica que los Vínculos Explícitos sean correctos. Por ejemplo: CustomerId - CustomerId.

   2. Prueba la notificación. Navega a tu página y haz clic en el botón que ejecuta el evento de notificación.

Notificaciones del sistema

A diferencia de las notificaciones descritas anteriormente en esta página, que App Builder envía automáticamente a un destinatario específico cuando ocurre un evento de negocio, las notificaciones del sistema son mensajes de difusión que un administrador envía manualmente o programa para enviar más tarde a un grupo de usuarios a la vez, por ejemplo, todos con acceso a una aplicación o un grupo de seguridad o rol específico. Los administradores utilizan notificaciones del sistema para cosas como ventanas de mantenimiento planificado o actualizaciones de aplicaciones, que no necesitan estar vinculadas a un registro específico o activadas por un evento.

Las notificaciones del sistema se muestran a los usuarios activos y permanecen en su Centro de Notificaciones (bajo el menú de hamburguesa) hasta que se descartan o expiran. Las notificaciones del sistema forman parte de la función Mantenimiento y solo admiten alertas en la aplicación. También son específicas del entorno: a diferencia de las notificaciones de aplicación, que se promocionan con tu código entre entornos, una notificación del sistema debe recrearse en cada entorno.

Para configurar una notificación del sistema, selecciona IDE > Mantenimiento, luego selecciona la pestaña Notificaciones (disponible desde App Builder 4.44) y sigue estos pasos:

1. En el panel Notificaciones Programadas, haz clic en el botón Programar o Enviar Ahora.

2. En el diálogo Notificación, ingresa valores para los siguientes campos:

   • Para: Haz clic en el campo y luego selecciona uno de los siguientes:

     • Todos

     • Un grupo de usuarios basado en lo siguiente:

       • Su acceso a una aplicación o fuente de datos otorgado por sus grupos o roles.

       • Grupos de seguridad.

       • Los roles de la fuente de datos.

   • De: Define quién envió la notificación (generalmente el usuario de servicio).

   • Programar Para: (Opcional) Programa una notificación para que se envíe más tarde (por ejemplo, una hora antes de una actualización de aplicación planificada).

   • Expira En: Una fecha y hora en la que la notificación expira y ya no se mostrará a los usuarios. En este momento, los usuarios que han visto y descartado el mensaje tendrán la notificación eliminada de sus centros de notificaciones.

3. Body: El contenido del mensaje que se muestra a los usuarios.

4. Haz clic en el botón Send o Schedule.

Un servicio de fondo envía notificaciones programadas. De forma predeterminada, el servicio se ejecuta con la cuenta del Service User. Para cambiar qué usuario ejecuta el servicio, sigue estos pasos:

1. Selecciona IDE > Maintenance, luego selecciona la pestaña Settings.

2. Haz clic en el menú Background Notification User y selecciona el usuario que ejecutará el servicio.