Requêtes
Les requêtes définissent ce qu’une app peut lire et modifier. Elles se trouvent dans l’onglet Requêtes de l’App-Builder et s’exécutent sur le serveur : le navigateur n’envoie que le nom de la requête et les valeurs de ses paramètres – table, filtre, champs et valeurs ne lui parviennent jamais et ne peuvent pas être modifiés.
Types
| Type | Pour | Champs |
|---|---|---|
| Lister des enregistrements | listes pour tableaux, listes, graphiques, listes déroulantes | table, champs (aucun = tous), filtre, tri, maximum par page |
| Un enregistrement | détails, p. ex. dans un dialogue | table, enregistrement (clé primaire), champs |
| Créer un enregistrement | enregistrer un formulaire | table, valeurs (colonne → valeur) |
| Modifier un enregistrement | changer un statut, modifier | table, enregistrement, valeurs |
| Supprimer un enregistrement | – | table, enregistrement |
| Téléverser un fichier | pièces jointes d’un enregistrement, p. ex. photos ou justificatifs | table, enregistrement, colonne de pièces jointes ; le fichier provient d’un champ Fichier |
| Exécuter un workflow | logique sur le serveur | workflow (voir Workflows et sources REST) |
| Endpoint personnalisé | endpoints de scripts existants | méthode, chemin |
| Source REST | API externe | source, méthode, chemin, corps |
Paramètres et variables
Une requête n’accepte que des paramètres déclarés (nom, type texte/nombre/oui-non/date/quelconque, obligatoire). Dans le filtre, les valeurs, l’enregistrement, le chemin et le corps, des variables les insèrent :
{{params.<nom>}}– un paramètre. Seul, il garde son type.{{user.id}},{{user.email}},{{user.role}}– le compte connecté (vide dans les apps publiques).{{now}}(instant) et{{today}}(date).
Les variables sont insérées dans la structure enregistrée, jamais dans un texte de requête – une valeur ne peut devenir qu’une valeur. Dans les chemins des sources REST, elles sont encodées pour l’URL. Valeur de filtre vide = pas de condition : si la variable d’une condition est vide, la condition disparaît – un champ de recherche vide affiche tout. Depuis les variables crée les paramètres à partir des variables utilisées.
Les éléments de données indiquent les valeurs des paramètres dans leurs propriétés, les actions dans l’étape Exécuter la requête (avec Formulaire, les valeurs d’un formulaire deviennent des paramètres du même nom). En bas de l’onglet, chaque requête peut être essayée avec des valeurs d’exemple (les requêtes d’écriture modifient réellement les données).
Droits
- Apps avec connexion : chaque requête atteint exactement sa table à son niveau (lecture ou écriture) – et jamais plus que ce que le compte peut déjà : pour les viewers, leurs autorisations de table s’appliquent en plus.
- Les utilisateurs d’apps n’ont pas d’autorisations de table ; seules les requêtes de leurs apps s’appliquent.
- Les apps publiques s’exécutent avec une identité d’app anonyme : exactement les requêtes de l’app, identiques pour tous les visiteurs – connectés compris.
- Les champs calculés font partie de la table : lookups, rollups, formules, liens, enregistrements enfants et valeurs affichées des clés étrangères viennent avec la table de la requête (ou les tables d’un workflow), même lorsqu’ils puisent dans d’autres tables – dans
fieldsetwhere, ils s’utilisent sous leur nom d’API. Les utilisateurs d’apps et les apps publiques les voient tels que la table est construite ; pour les viewers, les champs issus de tables qu’ils ne peuvent pas lire restent masqués. - Hooks, webhooks et champs calculés fonctionnent comme avec l’API REST. L’exécution autorise 600 appels par minute et par IP.