eventoCondizioni di notifica
Questo evento viene notificato all'applicazione quando un terminale remoto inizia una sessione di sincronizzazione. E' l'analogo dell'evento di OnLogin che avviene quando un browser inizia a usare l'applicazione.
Utilizzo consigliato
Questo evento deve essere gestito per autenticare l'utente e decidere il cosiddetto Client Domain, cioè il suo dominio di appartenenza che permette poi al framework di sincronizzazione di parzializzare i dati da inviare al terminale.
Argomenti
| User Name | User name comunicato dal terminale remoto |
| Password | Password comunicata dal terminale remoto |
| Domain | Parametro di output di tipo stringa che deve essere impostato al valore del dominio in cui l'utente è stato riconosciuto. Il significato di questa stringa è legato all'applicazione e dovrà essere utilizzato negli eventi sucessivi di sincronizzazione per parzializzare i dati. Il valore in input corrisponde al dominio utilizzato dal terminale durante l'ultima sincronizzazione. |
| Last Sync | Data e ora dell'ultima sincronizzazione, come comunicato dal terminale remoto |
| Cancel | Parametro booleano di output. Se impostato a true interrompe la sincronizzazione. Solitamente avviene quando l'utente non viene riconosciuto. |
Esempio di codice
// ****************************************************************************
// Evento notificato quando un client vuole sincronizzare documenti con questo
// server
// ****************************************************************************
event RemoteClient.OnSynchronize(
string Username // Contiene lo username del client che vuole sincro...
string Password // Contiene la password del client che vuole sincro...
inout string Domain // Parametro di output che deve essere impostato al...
inout boolean Cancel // Se impostato a True impedisce la sincronizzazion...
date time LastSync // Istante in cui il client ha effettuato l'ultima ...
)
{
// In questo esempio, lo username corrisponde al dominio (ID Impiegato)
// Se l'utente ha cambiato dominio, aggiorno forzatamente gli ordini e le
// righe
if (Domain != "" && Domain != Username)
{
SyncService.resyncClass(Ordini.className())
SyncService.resyncClass(DettagliOrdini.className())
}
//
Domain = Username
}
// Evento notificato quando un client vuole sincronizzare documenti con questo
// server
// ****************************************************************************
event RemoteClient.OnSynchronize(
string Username // Contiene lo username del client che vuole sincro...
string Password // Contiene la password del client che vuole sincro...
inout string Domain // Parametro di output che deve essere impostato al...
inout boolean Cancel // Se impostato a True impedisce la sincronizzazion...
date time LastSync // Istante in cui il client ha effettuato l'ultima ...
)
{
// In questo esempio, lo username corrisponde al dominio (ID Impiegato)
// Se l'utente ha cambiato dominio, aggiorno forzatamente gli ordini e le
// righe
if (Domain != "" && Domain != Username)
{
SyncService.resyncClass(Ordini.className())
SyncService.resyncClass(DettagliOrdini.className())
}
//
Domain = Username
}
Ultima modifica: 03/04/2020 / Validità: da 10.5.4660
Per maggiori informazioni sul framework di sincronizzazione si consiglia di leggere il pagrafo 5.11 della guida all'utilizzo di In.de.