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

Program

*value* = program.type()

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

program.newhttprequest()

*dataform* = program.newdataform()

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

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

program.refreshsection(*tablename*)

*list* = program.listlocalusers()

*list* = program.listglobalusers()

*list* = program.listnamedatabases()

*list* = program.listpathdatabases()

*value* = program.getusername()

*value* = program.getuserid()

*value* = program.useradmin()

*xmldocument* = program.newxmldocument()

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

program.showwarning(*message*)

program.showconfirm(*message*)

program.showerror(*message*)

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

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

*list* = program.geolocation()

*notification* = program.newnotification()

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

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