Scopo
Permette di inviare una notifica.
Se l'applicazione è offline, chiederà alla shell nativa di generare una notifica locale sul dispositivo. Tale notifica può essere utile per applicazioni di tipo calendario, dove occorre avvisare l'utente ad una data precisa.
Quando l'applicazione riceve la notifica viene notificato l'evento OnCommand con Command=NOTIFICATION. Il comando ricevuto ha come parametri TITLE, TEXT, PAYLOAD e TAPPED.
Se l'applicazione è online, invece, verrà inviata una notifica push. In questo caso occorre eseguire la procedura lato server in una applicazione C# o Java. L'applicazione web contatta i servizi di notifica specifici per il dispositivo (Apple, Android, Windows8) che, a loro volta, inviano la notifica al dispositivo.
Per inviare la stessa notifica a più dispositivi contemporaneamente, occorre elencare 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
idn.Send()
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()
}
- La procedura genera eccezione se si invia una notifica push e fallisce l'invio della notifica ad almeno uno dei dispositivi elencati nella proprietà DNID. Se è attivo il modulo di debug lato server, è possibile sapere perché è fallito l'invio della notifica.
- In caso di errore, si consiglia di verificare che le porte di comunicazione dei vari servizi di notifica (Apple, Google e Microsoft) non siano bloccate.
Ultima modifica: 18/10/2023 / Validità: da 12.5.5400