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

On Command

evento copia link

Condizioni di notifica

Evento notificato dall'applicazione quando viene passato un comando via URL. Questo accade se:

  • Nell'URL utilizzata per aprire l'applicazione è presente il parametro CMD.
  • Quando l'utente scrive il codice del comando nel campo cmd: della testata dell'applicazione e preme invio.

Utilizzo consigliato

L'evento di OnCommand può essere utilizzato per controllare l'applicazione mediante un semplice link. E' possibile ad esempio decidere quale schermata verrà aperta all'avvio a seconda del comando passato.

Argomenti

Command E' una stringa contenente il valore del parametro di URL di nome CMD

Esempio di codice

// ***************************************************
// Fired when a CMD tag is present in the query string
// ***************************************************

event EsempiGL.OnCommand(
  string Command // What is this parameter for?
)
{
  string comando = "" // Leggo il comando dall'URL
  // 
  comando := GetURLCommand()
  // 
  // Se c'è almeno un comando

  if comando <> Empty String
  {
    EsempiGL.UserName := Default User Name
    EsempiGL.UserRole := Anonymous
    // 
    // Modifico la caption dell'applicazione per dare il benvenuto all'utente

    EsempiGL.MainCaption := Benvenuto nell'applicazione di esempio di
      IN:DE
    // 
    // Imposto la welcome url al sito di Pro Gamma, verrà mostrato ogni volta
    // che non ci sono form aperte

    EsempiGL.WelcomeURL := www.progamma.com
    // 
    // Imposto il logoff Url al sito di Pro Gamma, verrà aperto alla chiusura
    // dell'applicazione

    EsempiGL.LogoffURL := www.progamma.com
    // 
    // Se il comando è "PRODOTTI" apro il form prodotti

    if comando = PRODOTTI
    {
      Prodotti.Show(??)
    }
  }
}
  • Il valore del parametro viene passato via URL formattato così:
    [URL applicazione]?CMD=[comando].
  • E' possibile specificare ulteriori parametri del comando aggiungendoli alla query string come nel seguente esempio:
    [URL applicazione]?CMD=[comando]&PAR1=VALORE&PAR2=VALORE....
    Il parametri del comando potranno essere recuperati con la funzione GetURLParam dell'applicazione.
  • Se si desidera che l'applicazione salti la pagina di login nel caso di comando sulla query string, è necessario impostare la proprietà UserRole dell'applicazione nell'evento di Initialize oppure nell'evento di OnCommand.

Ultima modifica: 10/10/2022 / Validità: da 6.5.2680

Vedi Anche

  • Initialize (evento)
  • On Login (evento)
  • Get URL Param (funzione)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum