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 |
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.