Program

L'oggetto Program fornisce metodi e funzioni per interfacciarsi direttamente con Nios4.

clienttype = program.type()

if clienttype == 1 then

output.print("Client windows")

else

output.print("Other client")

end

*value* = program.type()

Restituisce il tipo di client attuale.

0 nessuno

1 windows

2 android

3 ios

4 web

5 mac

program.showdataview(*tablename*, *gguid*)

Carica e visualizza un dataview in modal. Se viene passato un gguid valido verrà caricata la riga a cui fà riferimento. Non interagisce con lo script e quindi va usato solo come chiusura del programma.

program.forcesync()

Se il database è cloud lo forza a sincronizzare con il server.

program.newemail()

Crea un nuovo oggetto Email.

program.loadspreadsheet(*pathfile*)

Carica un file di formato Excel o CSV convertendolo in un oggetto Datatable.

program.newhttprequest()

Crea un nuovo oggetto Httprequest.

program.openurl(*url*)

Invia l'indirizzo di una pagina web al browser del dispositivo.

program.usertoken()

Restituisce il token di accesso dell'account utente

program.getusercategory()

Restituisce il valore della categoria utente.

*dataform* = program.newdataform()

Crea un nuovo oggetto dataform. L’oggetto dataform permette di creare un form di selezione composto da campi di inserimento che permettono all’utente di digitare o selezionare dei valori.

*dataview* = program.newdataview (*tablename*,*gguid*)

Crea un nuovo oggetto dataview. L’oggetto dataview è una scheda di editazione dati. Occorre indicare il nome della tabella e l’eventuale gguid della riga da caricare. Per creare una scheda nuova basterà dare una stringa nulla (“”) come gguid.

*fileinfo* = program.newfileinfo(*pathfile*)

Crea un nuovo oggetto fileinfo. L’oggetto permette di estrapolare informazioni e di manipolare un file.

program.refreshsection(*tablename*)

Aggiorna tutte le sezioni forzando il programma a ricaricare i dati dal database. In caso venga passata stringa nulla (“”) il programma aggiornerà tutte le sezioni.

*list* = program.listlocalusers()

Viene ridato un elenco degli utenti locali del database attualmente aperto.

*list* = program.listglobalusers()

Viene ridato un elenco degli utenti cloud che hanno accesso al database attualmente aperto.

*list* = program.listnamedatabases()

Viene ridato un elenco dei nomi dei database attualmente collegati al client.

*list* = program.listpathdatabases()

Viene ridato un elenco dei percorsi dei database attualmente collegati al client Windows. I database presi in considerazione sono solo i percorsi dei database in formato Access.

*value* = program.getusername()

Permette di recuperare il nome dell’utente attuale.

*value* = program.getuserid()

Permette di recuperare l’ID dell’utente attuale.

*value* = program.useradmin()

Restituisce un valore che indica se l’utente è l’amministratore del database.

*xmldocument* = program.newxmldocument()

Crea un oggetto xmldocument per poter gestire e creare un file XML.

*xmldocument* = program.loadxmldocument(*path*)

Crea un oggetto xmldocument caricando da un file XML. Se viene data una stringa nulla (“”) per il percorso, il programma chiede (se il client è Windows) di selezionare il file da una finestra di caricamento.

program.showwarning(*message*)

Visualizza un messaggio di warning sulla barra di stato del programma.

program.showconfirm(*message*)

Visualizza un messaggio di conferma sulla barra di stato del programma.

program.showerror(*message*)

Visualizza un messaggio di errore sulla barra di stato del programma.

*list* = program.geocoding(*address_string*)

Restituisce la latitudine e la longitudine di un indirizzo. La funzione è utilizzabile solo sui dispositivi mobile.

*list* = program.geocodingreverse(*lat*,*lng*)

Restituisce l’indirizzo in base a una longitudine e una latitudine.

*list* = program.geolocation()

Restituisce il punto GPS attuale. La funzione è utilizzabile solo sui dispositivi mobile.

*notification* = program.newnotification()

Crea un nuovo oggetto notifica.

*value* = program.showmessagebox(*message*,*stylebutton*,*styleicon*)

Il comando visualizza un messaggio per richedere la conferma o l'annullamento.

message = il messaggio da visualizzare

Valore di ritorno (value)

Nessuno = 0

Si = 1

No = 2

Ok = 3

Annulla = 4

Tipo icona (styleicon)

Nessuna = 0

Info = 1

Domanda = 2

Critico = 3

Errore = 4

Tipo pulsanti (stylebutton)

Nessuno = 0

Ok= 1

Ok Annulla = 2

Si No = 3

Si No Annulla = 4

*value* = program.showinputbox(*message*,*defaultvalue*,*ispassword*)

Visualizza una casella di testo per inserire un valore.

message = Il messaggio da visualizzare

defaultvalue = il valore di default da visualizzare

ispassword = booleano. Se il valore durante l'inserimento deve essere mascherato