English
Instant Developer Foundation Documentazione
  • Reference Librerie
  • Libreria Client
  • Libreria Applicazione
  • Eventi

On Synchronize

evento link

Condizioni 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
}

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.

Vedi Anche

  • On Login (evento)

Ti serve altro aiuto?

Consulta il Forum