Notificación¶

Una notificación es un concepto de nivel de aplicación que permite a un desarrollador enviar una notificación o un mensaje a un usuario. Este mensaje puede tener múltiples opciones que definen cómo puede responder el usuario al mensaje. Cuando hay opciones en una notificación, la respuesta del usuario se rastrea automáticamente mediante App Builder las notificaciones admiten archivos adjuntos de cualquier tipo (por ejemplo, .PDF, .DOCX, .TXT, .XLSX, etc.). Si utiliza archivos adjuntos, la notificación utilizará el formato data/pdf directorio si no se especifica ningún otro directorio. Alternativamente, si especifica un FileDataSourceId, esta es la ubicación App Builder buscará los archivos adjuntos.

Para utilizar los objetos de datos públicos necesarios para la notificación, su aplicación requiere App Builder (Sellado) para configurarse como una fuente de datos disponible para la aplicación. Además de ser una fuente de datos disponible para la aplicación, debe establecer o configurar un enlace entre las fuentes de datos.

En términos de qué URL se utiliza para enviar notificaciones, App Builder utilizará la información de URL especificada en la regla de notificación, si está disponible. Si no se encuentra, App Builder se utilizará la URL predeterminada del sitio del servidor. El valor predeterminado del sitio del servidor se configura desde IDE > Proveedores de seguridad > Más (desde el panel de configuración) > Sitios. Para obtener más información sobre los sitios y las URL, consulte Sitios y alias artículo.

Nota

Los enlaces de notificación están activos de forma predeterminada durante 7 días. Después del período de 7 días, caducan y ya no son enlaces activos. Esta no es una opción configurable actualmente en App Builder.

Tipos de Mensajes¶

Una notificación puede utilizar uno de los siguientes tipos de mensajes:

Correo - No es de sorprender que un correo.
SMS - Un mensaje SMS enviado y recibido por el servicio Twilio.
App Builder alerta - Una ventana emergente que aparece en el navegador del usuario cuando inicia sesión. App Builder. Anteriormente llamado Notificación.

Todos los tipos de mensajes admiten la adición de opciones que brindan formas para que el usuario responda a un mensaje. Para Correos y App Builder alertas, las URLs se incluyen en el mensaje y enlace a App Builder en el caso del tipo de envío SMS, también puedes responder a un SMS con el nombre de la opción para ejecutar el evento asociado.

Próximas versiones de App Builder probablemente admitirá el envío de mensajes a servidores REST.

Opciones¶

Las notificaciones pueden tener 0 o más opciones. Cuando una notificación no contiene opciones, no se espera ninguna respuesta del usuario y, en consecuencia, no se proporciona ningún seguimiento de la respuesta del usuario. No se agregarán enlaces al mensaje saliente. Esto se considera una notificación informativa.

Cuando una notificación contiene 1 o más opciones, se envía un mensaje con enlaces URL a App Builder que permiten al Usuario responder de alguna manera. La respuesta del Usuario al mensaje (es decir, qué opción seleccionó) se registra mediante la notificación.

Configuración¶

Las opciones de notificación se pueden configurar de dos maneras:

Enlace a la página: se proporciona un enlace que permite al usuario navegar a una página. La navegación exitosa a la página se considera una respuesta completa a la opción.
Evento de página de ejecución: se proporciona un enlace que envía al usuario a una página y ejecuta un evento específico antes de que se muestre la página. Nuevamente, la respuesta del usuario se considera completa una vez que se activa el evento.

Para que una página sea elegible para cualquiera de las opciones anteriores, la página debe estar marcada como Compartida.

Por ejemplo, un administrador puede ejecutar un evento que haga que se envíe un correo a un usuario final. El correo contiene texto y tres botones:

Revisar: al hacer clic en Revisar, el usuario puede acceder a una página específica en App Builder.
Aprobar: al hacer clic en Aprobar, el usuario puede ir a una página diferente Y ejecutar un evento contra algunos objetos de datos en la página.
Rechazar: al hacer clic en Rechazar, el usuario puede ir a una página diferente Y ejecutar un evento en la misma página o en los objetos de datos de una página diferente.

El evento debe ejecutarse antes de que se muestre la página, ya que puede afectar los datos que se encuentran en los paneles de la página. Para ejecutar un evento, el desarrollador debe:

Configure la página Enlace a como Compartida.
Incluya el evento en el objeto de datos de la página o como una de las fuentes de datos del panel de una sola fila de la página. Puede encontrar más información sobre este punto en la sección Vinculación de eventos de objetos de datos que aparece a continuación.

Vinculación de Eventos de Objetos de Datos¶

App Builder limita los eventos que se pueden vincular a un enlace. En concreto, esta limitación solo permite eventos que pertenecen a un objeto de datos o tabla que está vinculado a un panel de una sola fila no vinculado en la página de destino. Por ejemplo, consideremos una página que tiene 6 paneles de una sola fila:

Cliente -> Dirección del cliente -> Mapa del cliente
Empleado -> Dirección del empleado -> Mapa del empleado

En este ejemplo, los paneles Cliente y Empleado no están vinculados a ningún otro panel de la página. Por lo tanto, un desarrollador puede elegir eventos de las fuentes de datos de esos dos paneles (junto con un objeto de datos de página, si se especifica uno).

App Builder también limita los eventos que se pueden vincular a eventos que no son del sistema. Por ejemplo, el desarrollador no puede enlace eventos Guardar, Insertar, Actualizar o Eliminar.

Registro de Notificaciones¶

Vinculación a una Notificación¶

La página Registro de notificaciones en App Builder permite al desarrollador enlace una notificación a una aplicación. Se trata de una relación de 1 a 1. Se puede configurar información adicional sobre el mensaje de notificación dentro del registro de notificaciones.

Creación de Mensajes¶

El mensaje de notificación se puede definir en la sección Plantilla de la página Registro de notificaciones. Este es el contenido principal de la notificación en sí.

Las sustituciones se realizan en la Plantilla y utilizan el {{nombre del campo}}Sintaxis. Las sustituciones pueden agregar un carácter opcional. url bandera para indicar que el valor es una URL y requiere codificación de URL, por ejemplo {{nombre del campo|url}}.

En cuanto a la sustitución, el cuerpo puede contener:

Hello {{NombreCliente}},

En cuyo caso CustomerName debe estar incluido en las columnas de la regla de notificación junto con los demás campos obligatorios.

En el caso de los correos, se puede especificar un Asunto en la página de Registro de notificaciones. El campo Asunto también admite sustituciones.

Traducciones¶

Las notificaciones admiten traducciones rudimentarias. Hay tres campos que se utilizan para las traducciones:

Opción de notificación Nombre
Registro de notificación Mensaje
Registro de notificaciones Asunto (para Correos)

Al crear el mensaje de notificación, App Builder intentará encontrar traducciones para cada uno de estos campos, asumiendo que su contenido especifica la clave de traducción correspondiente. El desarrollador también debe agregar las claves al paquete de traducción de la aplicación manualmente (actualmente no se importan automáticamente para una aplicación). Se debe tener cuidado con el campo Plantilla para agregar la clave de traducción como una cadena sin formato y no como HTML. Hay un ícono de "código" en la parte inferior derecha del campo Plantilla de registro de notificaciones que le permite editar directamente la cadena.

Limitaciones¶

El evento ejecutado en el enlace de opción pertenece a los Datos de página o a un Objeto de datos de panel de una sola fila. Actualmente, no mostramos ningún resultado de validación ni mensajes de publicación para eventos de nivel de página. En otras palabras, el evento se ejecuta primero y, cuando se completa, el Usuario es redirigido a su página. Cuando llega a su página, los resultados del evento se pierden. Por lo tanto, si el evento tiene un mensaje de publicación o falla la validación, el sistema no mostrará esos resultados al Usuario final. El desarrollador puede solucionar esto fácilmente mostrando datos en sus paneles que cambian según la ejecución exitosa de un evento.

Debido a la limitación anterior, las advertencias de validación harán que un evento no se ejecute. No contamos con una interfaz de usuario que permita al usuario aceptar o rechazar la advertencia.
La tabla Archivo de una fuente de datos de Amazon S3 no se puede extraer mediante una regla de notificación.

Notificación de Objetos de Datos Públicos¶

Los objetos de datos públicos utilizados como destinos de notificación se definen a continuación.

Columnas Comunes¶

Estas columnas son comunes a todos los objetos de datos públicos de Notificación:

Nombre	Obligatorio	Objetivo múltiple	Ejemplo	Descripción
Binding()	No	Sí	CustomerID	Si se proporciona, esto identificará el registro que coincide con la opción para esta notificación. Se pueden definir múltiples enlaces.

Correo¶

El objeto de datos públicos Correo es similar, pero no totalmente coherente, con la funcionalidad del complemento de Correo SMTP. Las columnas para el objeto de datos públicos Correo son las siguientes:

Nota

Si utiliza más de una dirección de Correo para enviar a Para o Cc, separe los valores con una coma.

Nombre	Obligatorio	Multi-objetivo	Ejemplo	Descripción
Para()	Sí	Sí	'usuario1@zudy.com,usuario2@zudy.com'	Lista delimitada por comas de direcciones de correo a las que se enviarán los mensajes. Se pueden utilizar varios campos Para() para enviar mensajes a varios destinatarios (además de utilizar valores delimitados por comas). Se genera una excepción si no se proporciona este campo o si es nulo.
Cc()	No	Sí	'usuario1@zudy.com,usuario2@zudy.com'	Lista delimitada por comas de direcciones de correo a las que se enviará una copia. De manera similar a To(), se pueden especificar múltiples destinos para la concatenación automática.
De	No	No	'noreply@zudy.com'	Define la dirección de remitente del correo. Si no se proporciona De, se utilizará la dirección de remitente definida en el registro Be_NotificationEndpoint.
App Builder url	Depende	No	'https://ejemplo.com/MiApp Builder'	App Builder la URL es obligatoria si la notificación contiene opciones. Esta URL se utiliza al generar enlaces a las distintas opciones de notificación. Esta es la URL a la que se accede App Builder desde el punto de vista del receptor del mensaje. No requiere barra diagonal final.
Attachment()	No	No	'somepath/files/*'	Si se proporciona, se adjuntarán archivos al correo. Si la cadena Attachment() termina con un asterisco (*), se supone que la cadena representa una ruta de directorio y todos los archivos adjuntos en el directorio se adjuntarán al correo.
FileDataSourceId	No	No	UUID	Identificador único que hace referencia a la fuente de datos a la que se debe hacer referencia para localizar los archivos adjuntos.
Idioma	No	No	'es'	Si se proporciona, se intentará traducir tanto los campos de Plantilla como de Asunto del Registro de Notificación asociado. Además, se traducirá el Nombre de las opciones de notificación.

Mensaje de Texto¶

El objeto de datos públicos Mensaje de texto se utiliza para enviar SMS. Las columnas para el objeto de datos públicos Mensaje de texto son las siguientes:

Nombre	Obligatorio	Multi-objetivo	Ejemplo	Descripción
To()	Yes	Yes	'+15559990000'	Un único número de teléfono en el formato esperado por Twilio. Se pueden enviar varios campos To() a varios destinatarios. Se genera una excepción si no se proporciona este campo o es nulo.
Idioma	No	No	'es'	Si se proporciona, se intentará traducir el campo Plantilla del Registro de Notificación asociado. Además, el Nombre de las opciones de notificación se traducirá en una versión futura.

App Builder alerta¶

La notificación App Builder el objeto de datos públicos Alert es similar, pero no totalmente coherente, con el objeto de datos públicos Create_Notification. Las columnas de App Builder los objetos de datos públicos de Alert son los siguientes:

Nombre	Obligatorio	Multiobjetivo	Ejemplo	Descripción
To()	Yes	No	all	To representa al usuario al que estamos enviando. Se genera una excepción si este campo no se proporciona o es nulo. Puede usar expresiones especiales: 'session' para apuntar a la sesión del usuario actual 'all' para apuntar a todos los usuarios que actualmente están conectados App Builder. Para enviar a un destinatario específico App Builder usuario, especifique el UserId del usuario.
From	No	No	who('userid')	From representa el usuario del que proviene este mensaje. Si no se proporciona, se asumirá que es el usuario que ejecuta la acción.
Persistente	No	No	1	Valor booleano que indica si la alerta debe considerarse persistente. Este atributo solo se aplica cuando se envía una alerta a un UserId. Todas las alertas tienen un botón Descartar que elimina la alerta del panel de notificaciones del usuario. El usuario puede ignorar la alerta o cerrar su ventana o cerrar sesión. App Builder si persistente es verdadero (1), la alerta se mostrará repetidamente, cada vez que el Usuario inicie sesión en App Builder, hasta que el Usuario descarte activamente la alerta. Utilice esta técnica para asegurarse de que el Usuario lea una alerta.
Tiempo de espera	No	No	15	Si se proporciona, el tiempo de espera representa la cantidad de tiempo (en segundos) que se debe esperar antes de cerrar automáticamente la ventana emergente de alerta.
SendToPushNotificationEnabledUser	No	No	0	Si se proporciona, el App Builder la alerta se puede configurar para que se envíe únicamente a los usuarios que no tengan un dispositivo habilitado para notificaciones push. Esto permite que un desarrollador envíe an App Builder notificación de alerta y notificación push en el mismo evento y evita que un usuario reciba tanto una notificación de escritorio como una notificación push.

Notificación Push¶

El objeto de datos públicos Push Notification permite que la notificación envíe una notificación push a un usuario. Las columnas del objeto de datos públicos Push Notification son las siguientes:

Nombre	Obligatorio	Multi-Target	Ejemplo	Descripción
Para	Sí	No	85cc99ff-b4a6-4a32-bfeb-537d346ee52c	Para es el usuario (ID de usuario) al que le enviamos la notificación push. Si el usuario no tiene un dispositivo de notificación push, la regla de notificación se ejecutará de todos modos, pero no se enviará ningún mensaje. Se genera una excepción si no se proporciona este campo o es nulo.
ToAppUserId	No	No	100	Si el usuario se denota por un ID de usuario de la aplicación, este valor debe proporcionarse además del campo Para.
De	Sí	No	who('userid')	De representa el usuario del que proviene este mensaje.
Insignia	No	No	1	Si se proporciona, esto establecerá el número de insignia en el ícono de la aplicación.

Configuración de Notificaciones¶

Ejemplo de Configuración de Notificaciones¶

Pasos para configurar una notificación. Supondremos que estamos agregando una Notificación de aprobación del cliente a la página de Clientes de Northwinds.

Crear Notificación¶

Crear una regla que tenga como objetivo un objeto de datos públicos de notificación.

Pasos para Crear una Notificación¶

Vaya a App Workbench
Haga clic en Notificaciones
Haga clic en + Notificación
Asignar un Nombre. Por ejemplo, CustomersRequestApprovalAlert
Confirme que el propósito es Notificación
Seleccione App Builder alerta como destino. Si no ve este objeto de datos disponible, cree una conexión de fuente de datos a App Builder(Sellado) para la aplicación en la que estás trabajando.
Haz clic en Guardar

Definir Notificación Mvsql¶

Haga clic en el botón +Tablas
Agregue su tabla 'seleccionar de'. Por ejemplo, Clientes
Agregue las siguientes columnas y haga clic en la pestaña Columnas para definir:

Columna	Alias	Objetivo
todos	Para	Para
"C".CustomerId	CustomerId	Vinculación()
"C".NombreCliente	NombreCliente

Nota

Tenga en cuenta que agregamos CustomerName para que podamos usarlo más adelante como parámetro de sustitución en nuestro mensaje de notificación.

Definir Opciones de Notificación¶

Vaya a App Workbench
Haga clic en Notificaciones
Seleccione la regla de negocio de notificación. Por ejemplo: CustomerRequestApprovalAlert
Ingrese la información del mensaje para la notificación en el campo Cuerpo
- Por ejemplo: Revise el siguiente cliente:
- Cliente: {{NombreCliente}}
Haga clic en el ícono del lápiz e ingrese la Ayuda técnica para ayudar a explicar la Notificación a otros desarrolladores

Defina opcionalmente una página de aterrizaje y un evento de prelanzamiento para ejecutar

Desde la página App Workbench > Notificaciones, seleccione la Notificación
Haga clic en el botón + Opción
Crear una nueva opción.
- Establezca Índice en 10
- Establecer Nombre en Revisión
- Seleccione el valor Enlace a página. En nuestro ejemplo, enlace a la página "Cliente" de Northwinds. Si la página a la que desea enlace no aparece, asegúrese de que esté marcada como "Compartida" en la configuración de casos extremos.
Haga clic en la marca de verificación para guardar el registro

Registrar Notificación con un Evento¶

Registrar una notificación como una acción con un evento. En este caso, asumimos que el evento está asociado con un botón en la página de inicio. También asumiremos que el evento se llama "Solicitar aprobación".

Navegue hasta el evento del objeto de datos
Haga clic en el ícono Lógica de negocios
Haga clic en el botón Eventos
Seleccione el evento. Por ejemplo: Solicitar aprobación
Haga clic en Registrar existente en el panel Acciones
Seleccione Notificación como el tipo de acción
Seleccione la notificación que creamos en el paso anterior. Por ejemplo: CustomerRequestApprovalAlert
Haga clic en Guardar
Verifique que los Enlaces explícitos sean correctos. Por ejemplo: CustomerId - CustomerId

¡Pruébalo!¶

En este punto, la notificación está completamente configurada. Navegue a su página y haga clic en el botón que ejecuta el evento de notificación. App Builder los usuarios del sistema deberían ver una ventana emergente con el mensaje de notificación.

Configuración de Notificaciones por SMS¶

Pasos para configurar una notificación por SMS. Supondremos que estamos agregando una Notificación de aprobación del cliente a la página de clientes de Northwinds.

Necesitará acceso a una cuenta de Twilio para completar la configuración.

Configuración App Builder seguridad¶

Vaya a IDE > Proveedores de seguridad
Haga clic en + Autenticación de usuario en el panel Autenticación de usuario.
- Ingrese un Nombre (p. ej., "Autenticación básica HTTP")
- Seleccione "Autenticación básica HTTP" como Tipo
- Haga clic en "Habilitado" para habilitar
- Haga clic en Guardar
Vaya a IDE > Administración de usuarios
- Haga doble clic en el registro de usuario que desea autenticar cuando llegue una respuesta SMS
- Tenga en cuenta que este usuario debe tener acceso a lo siguiente:
  - App Builder aplicación
  - El evento que se ejecutará en la notificación
Haga clic en el ícono Claves desde Autenticación
Haga clic en Crear
Seleccione el proveedor "Http Basic Auth" creado anteriormente
Haga clic en Guardar

Nota

La "clave" secreta que se crea para este proveedor. La combinación del nombre de usuario y la clave secreta se utilizará al configurar Twilio.

Configurar Twilio¶

Crear Servicio de Mensajería¶

Inicia sesión en tu cuenta de Twilio
Vaya a Nube de comunicaciones > SMS programables
Haga clic en Servicios de mensajería
Cree un nuevo servicio de mensajería (notificaciones, bidireccional) y adjúntele un número de teléfono de Twilio
Anote el MessagingServiceSid. Esto se utilizará para la configuración más adelante.
Habilitar la opción “Procesar mensaje entrante”
Introduzca la siguiente URL de solicitud:
- https://:@/webhook/v1/vinyl/bridge_inbound
- Por ejemplo, https://admin:P124asfgOmkA@vinyl.zudy.com/webhook/v1/vinyl/bridge_inbound

Recopilar Credenciales de Twilio¶

Vaya a Panel de control de la consola > Configuración
Anote las credenciales LIVE:
- ID de la cuenta
- Token de autenticación

Configurar Extremo de SMS¶

Vaya a IDE > Servidores de notificaciones
Haga doble clic en el registro 'SMS'
Agregue la siguiente configuración:
- Nombre de usuario -> ID de cuenta de Twilio
- Contraseña -> Token de autenticación de Twilio
- ID de servicio de mensajería -> ID de servicio de mensajería de Twilio

Configurar la URL del Sitio Web¶

Vaya a IDE > Proveedores de seguridad
En Configuración, haga clic en Más > Sitios
Haga clic en + Sitio
Establezca como valor de URL la URL de su sitio web. Por ejemplo: https://vinyl.zudy.com
Haga clic en Guardar

Configurar la Notificación por SMS¶

Crear Notificación¶

Crear una regla que tenga como objetivo un objeto de datos públicos de notificación.

Pasos para Crear una Notificación¶

Vaya a App Workbench > Notificaciones
Haga clic en + Notificación
Asignar un Nombre
Seleccione Notificación como Propósito
Seleccione Mensaje de texto como Destino. Si no ve este objeto de datos disponible, cree una conexión de Fuente de datos a App Builder(Sellado) para la aplicación en la que estás trabajando.
Haz clic en Guardar

Definir Notificación Mvsql¶

Haga clic en el botón +Tabla y agregue la tabla que requiere la regla
- Por ejemplo, clientes
Haga clic en la pestaña Columnas y agregue las siguientes columnas:

Columna	Alias	Objetivo
'+15551112222' (reemplazar con su número de teléfono)	Para()	Para()
"C".CustomerId	CustomerId	Vinculación()
"C".NombreCliente	NombreCliente

Nota

Agregamos "CustomerName" para que luego podamos usarlo como parámetro de sustitución en nuestro mensaje de Notificación.

Definir Opciones de Notificación¶

Además de definir la información del mensaje, definiremos dos opciones para este ejemplo de notificación: una que se activa al responder al SMS y otra que es un enlace a una página.

Haga clic en la pestaña de navegación Notificación
Introduzca el siguiente mensaje en el cuerpo del mensaje:

Reply {{1}} to approve {{NombreCliente}}. Review {{Revisión}}

Haga clic en el botón +Opción del panel Opciones
- Establezca Índice en 10
- Establecer Nombre en Revisión
- Seleccione la página a la que desea enlace. En nuestro ejemplo, enlace a la página "Cliente" de Northwinds. Si la página a la que desea enlace no aparece, asegúrese de que esté marcada como "Compartida" en la configuración de casos extremos.
- Establezca la opción Tipo en 'Enlace'
Haga clic en el botón +Opción del panel Opciones
- Establezca Índice en 20
- Establezca Nombre en 1
- Seleccione la página a la que enlace. En nuestro ejemplo, enlace a la página "Cliente" de Northwinds y ejecutaremos el evento "Aprobar".
- Establezca la opción Tipo en 'Respuesta SMS'

Registrar Notificación con un Evento¶

Registrar una notificación como una acción con un evento. En este caso, asumimos que el evento está asociado con un botón en la página de inicio. También asumiremos que el evento se llama "Solicitar aprobación".

Navegue hasta el evento del objeto de datos
Haga clic en el ícono Lógica de negocios
Haga clic en el botón Eventos
Seleccione el evento. Por ejemplo: Solicitar aprobación
Haga clic en Registrar existente en el panel Acciones
Seleccione Notificación como Tipo de acción
Seleccione la notificación que creamos en el paso anterior. Por ejemplo: Customer_RequestApprovalSms
Haga clic en Guardar
Verifique que los enlaces explícitos sean correctos. Por ejemplo: CustomerId- CustomerId

Configurar Notificaciones Push¶

Las notificaciones push se configuran de manera similar a otras notificaciones en App Builder. El App Builder el administrador del servidor debe configurar correctamente el extremo de notificaciones push para que funcione como se espera.

Si está configurando notificaciones push con la API de Blabber, debe descargar la aplicación complementaria de iOS, iniciar sesión en el servidor correspondiente con las credenciales adecuadas y habilitar las notificaciones push en la propia aplicación. Además, se requiere una clave API para completar la configuración.

¡Pruébalo!¶

En este punto, la notificación está completamente configurada. Vaya a su página y haga clic en el botón que ejecuta el evento de notificación.