Notificaciones Push
OBJETIVOS
Integrate push notifications to your 4d for iOS apps
REQUISITOS PREVIOS
El componente 4D Mobile App Server que permite enviar notificaciones push está integrado en 4D mono usuario y 4D Server.
¿Qué es una notificación push?
On a mobile phone, a push notification is an alert message received via an application, that you can open, delete, allow or block. It can be very useful to notify your app users that a new version is available, for example.
But what about the architecture that needs to be implemented, in order to integrate this functionality into a mobile application? And what is the process of a push notification, from creation to display, on the user's mobile?
Arquitectura técnica
Estos son los diferentes elementos necesarios para crear, enviar y recibir una notificación push móvil:
Prerrequisitos
To send push notifications, an AuthKey_XXXYYY.p8 authentication file from Apple is required.
Primero, vaya a la página de la cuenta de desarrollador Apple, inicie sesión y luego seleccione Certificates, IDs & Profiles.
A continuación, podrá generar su certificado Push y descargarlo.
Finally, activate the Push notification feature to integrate your certificate in your 4D for iOS project from the Publishing section.
Puede encontrar más información sobre este proceso aquí en la documentación del componente.
Ejemplo básico para gestionar sus notificaciones push
Este es un ejemplo para enviar una notificación push a test@4d.com:
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="This is title"
$notification.body:="Here is the content of this notification"
$response:=$pushNotification.send($notification;"test@4d.com")
It couldn't be any easier!
Notificación push con sincronización de datos
Con una notificación push, también puede lanzar una sincronización para actualizar sus datos.
Por ejemplo, si su aplicación tiene una opción de seguimiento de la entrega, la información sobre la entrega se actualizará en la base de datos gracias a una notificación enviada al cliente. Esta notificación, que contiene una solicitud de sincronización de los datos, permitirá al cliente obtener los datos modificados en su teléfono inteligente.
Para ello, en el componente Servidor de aplicaciones 4D Mobile, es necesario especificar si se desea forzar la sincronización de los datos en la notificación push. Por lo tanto, simplemente suministre el valor booleano dataSynchro en el objeto userInfo.
Sincronización de datos con una notificación que abre un registro
Por defecto, una notificación que abre un registro activa automáticamente una sincronización de datos.
Por ejemplo, en una aplicación Contact, si se ha modificado la información específica de un contacto (es decir. el registro de un contacto, como la dirección o el número de teléfono), el usuario recibe una notificación que abre automáticamente el registro correspondiente y sincroniza los datos contenidos en el mismo. Cuando el usuario abre la notificación, la información del contacto se actualiza completamente.
Este es un ejemplo del comportamiento por defecto, una petición dataSynchro con el método open():
Tenga en cuenta que para el método open() exclusivamente, este es el comportamiento por defecto. Como resultado, si no especifica el valor booleano dataSynchro, es true por defecto.
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="This is title"
$notification.body:="Here is the content of this notification"
$entity:=ds.Employees.get("456456")
$response:=$pushNotification.open($entity; $notification; $recipients)
Sin embargo, también se puede optar por no forzar una sincronización de datos, evitando dataSynchro:
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="This is title"
$notification.body:="Here is the content of this notification"
$notification.userInfo:=New object("dataSynchro"; False)
$entity:=ds.Employees.get("456456")
$response:=$pushNotification.open($entity; $notification; $recipients)
Sincronización de datos con una simple notificación
También puede solicitar una sincronización para una simple notificación sin abrir un registro específico. Por ejemplo, se han añadido algunas entradas nuevas. Entonces puede informar a su usuario y actualizar los datos sin ninguna manipulación por su parte.
Aquí hay un ejemplo de código que también puede utilizar con otros métodos, siempre y cuando llene el objeto userInfo con el valor dataSynchro.
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="This is title"
$notification.body:="Here is the content of this notification"
$notification.userInfo:=New object("dataSynchro"; True)
$response:=$pushNotification.send($notification; $recipients)
Configuración Windows
Windows users need to download the last CURL version to work on the variables of the environment of their machine. Or they can insert curl.exe in the Resources folder of their production database.
MobileApps folder
Whether you're working on Windows or on macOS, you need to copy the 4DBASE/MobileApps/ID.BundleID/AuthKey_XXXX.P8 and 4DBASE/MobileApps/ID.BundleID/manifest.json files from your Design database to your production database.
¿Qué hacemos ahora?
El componente que maneja y facilita el proceso también está disponible aquí para que pueda adaptar las notificaciones push a sus propias necesidades. Siéntase libre de usarlo y elegir los aspectos más relevantes para su aplicación. Y por supuesto, todas las contribuciones son bienvenidos a este proyecto, a través de comentarios, informes de errores y aún mejor: "pull requests".