model (get) (post)
Il comando permette di recuperare tutti i record contenuti all’interno di una specifica tabella. Anche in questo caso i dati vengono inviati solo se l’utente possiede i permessi di visualizzazione.
E’ possibile inoltre aggiungere un post alla chiamata per poter filtrare i record.
Parametri
tablename
Nome della tabella da interrogare
db
Nome del database contenente la tabella
gguid
L’id globale del record (facoltativo)
token
Il token di identificazione dell’utente
page
numero di pagina 1-based, vuoto per non fare la paginazione, opzionale
perpage
numero di record per pagina
gguid
GGUID del record da leggere, opzionale, se specificato ritorna un solo record e tutti i parametri seguenti sono ignorati
Esempio
https://web.nios4.com/ws/?action=model&db=db&tablename=customer&token=00000000
Body facoltativo
{
"fields": [ array dei nomi dei campi da ritornare, di default tutti ],
"search": { opzionale
"fields": [ array dei campi sui quali effettuare la ricerca testuale ],
"query": "stringa da cercare in almeno uno dei campi specificati"
},
"conditions": { coppie campo/valore in AND },
"timerange": { filtro per l'agenda, opzionale
"field_from": "nome del campo FROM",
"field_to": "nome del campo TO",
"tid_from": TID di inizio,
"tid_to": TID di fine
},
"order_info": [ ["nome campo", true per ASC], ... ],
"group_by": [ <array dei nomi dei campi per il GROUP BY ]
}
Risposta
{
"error": false,
"records": [
{
"gguid": "g",
"tid": 20191126145027,
"eli": 1,
"arc": 0,
"ut": "user",
"ind": 0,
"gguidp": "",
"exp": "",
"uta": "1070",
"tap": "",
"dsp": "",
"dsc": "",
"dsq1": 0,
"dsq2": 0,
"utc": "user",
"tidc": 20180618182500,
"name": "Customer",
}
],
"total": 1
}
La risposta contiene tutti i record richiesti (o quello specifico attraverso il suo identificativo globale) contenente tutti i valori. I record sono inoltre filtrati in base ai permessi dell’utente.
E’ presente anche la chiave total per identificare rapidamente il numero dei record ritornati.