Scopo
Indica a quali dispositivi occorre inviare la notifica. Normalmente viene utilizzata la funzione DeviceNotificationID per leggere l'ID che identifica univocamente il dispositivo e l'applicazione, installata sul dispositivo, che riceverà la notifica.
La proprietà DNID è di tipo stringa e deve contenere l'elenco degli identificativi dei dispositivi a cui occorre inviare la notifica.
Ciascun identificativo (Device Notification ID) è una stringa composta da tre parti separate da underscore:
- la prima parte identifica il sistema operativo e può assumere i seguenti valori: IOS, AND, WIN o CHR;
- la seconda parte identifica il dispositivo e l'applicazione (in esecuzione su quel dispositivo) che riceverà le notifiche;
- la terza parte rappresenta il GUID dell'applicazione offline, che è utilizzato da Caravel per avviare il servizio ed inviare la notifica. Il GUID è presente anche se si legge il valore della funzione DeviceNotificationID da un'applicazione offline compilata come pacchetto di installazione e non eseguita dentro al browser Caravel.
Tramite il componente IDNotification è possibile inviare la stessa notifica a più dispositivi contemporaneamente, elencando i loro ID nella proprietà DNID separando ciascun ID con una virgola:
DNID1, DNID2, ...dove DNID1 e DNID2 sono due Device Notification ID. Se si desidera inviare una notifica ad un solo dispositivo, è sufficiente assegnare alla proprietà DNID l'identificativo del dispositivo.
Sintassi
IDNotification idn = new()
idn.DNID ="IOS_A70A32AA8763599EF704A3489CC41426575F1A8CD3C0EF6_DD4FD-89DD-4D5E-D418-6A8A8D52CBBC"
idn.DNID =
Esempio di codice
// ********************
// Sends a notification
// ********************
public void NewForm.SendNotification()
{
IDNotification idn = new()
idn.DNID = "[DEVICE NOTIFICATION ID]"
idn.title = "Title"
idn.message = "How are you?"
idn.payload = "[DATA SENT TO OFFLINE APP]"
//
idn.send()
}
// Sends a notification
// ********************
public void NewForm.SendNotification()
{
IDNotification idn = new()
idn.DNID = "[DEVICE NOTIFICATION ID]"
idn.title = "Title"
idn.message = "How are you?"
idn.payload = "[DATA SENT TO OFFLINE APP]"
//
idn.send()
}
- Per le notifiche locali non è necessario specificare questo identificativo, in quanto la notifica locale viene generata dalla shell e verrà ricevuta dallo stesso dispositivo su cui è in esecuzione la shell nativa.
-
Per le notifiche push è obbligatorio specificarlo ed è necessario recuperarlo dal dispositivo a cui si desidera inviare una notifica.
Per ottenere il DeviceNotificationID di un dispositivo è sufficiente:
- leggere il valore della funzione DeviceNotificationID quando l'applicazione offline è in esecuzione all'interno della shell nativa ed inviarlo ad un server che lo può memorizzare su database per poi utilizzarlo quando occorre inviare una notifica a quel dispositivo;
- leggere il valore della funzione DeviceNotificationID all'interno dell'evento OnSynchronize (lato server) se è stata utilizzata la sincronizzazione. Se l'applicazione offline è in esecuzione all'interno della shell nativa, infatti, invia automaticamente il proprio DeviceNotificationID al server all'interno del messaggio di sincronizzazione.
Ultima modifica: 18/09/2019 / Validità: da 12.5.5400