model (get) (post)
La commande permet de récupérer tous les enregistrements contenus dans un tableau spécifique. Dans ce cas également les donnèes ne sont envoyées que si l'utilisateur possède les permissions d'affichage.
Il est également possible d'ajouter un message à l'appel pour filtrer les enregistrements.
Paramètres
tablename
Nom du tableau à interroger
db
Nom de la base de donnèes contenant le tableau
gguid
L'identifiant global de l'enregistrement (facultatif)
token
Le jeton d'identification d'utilisateur
Exemple
https://web.nios4.com/ws/?action=model&db=db&tablename=customer&token=00000000
Body facultatif
{
"fields": [ tableau de noms des champs à retourner, par défaut tous ],
"search": { optionnel
"fields": [ tableau des champs de recherche textuelle ],
"query": "chaîne à rechercher dans au moins un des champs spécifiés"
},
"conditions": { couples champ/valeur en AND },
"timerange": { filtre pour l'agenda, optionnel
"field_from": "nom du champ FROM",
"field_to": "nom du champ TO",
"tid_from": TID de début,
"tid_to": TID de fin
},
"order_info": [ ["nom du champ", true pour ASC], ... ],
"group_by": [ < tableau de noms des champs pour le GROUP BY ]
}
Réponse
{
"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 réponse contient tous les enregistrements requis (ou l'enregistrement spécifique par son identifiant global) contenant toutes les valeurs. Les enregistrements sont également filtrés selon les permissions de l'utilisateur.
Il est également présent la clé totale pour identifier rapidement le nombre d'enregistrements retournés.