Requêtes, dossiers et dossiers de variables
L’arbre d’un projet Restorm compte quatre familles d’éléments.
Le dossier simple
Section titled “Le dossier simple”Un conteneur de rangement, sans effet sur l’exécution. Utilisez-le pour
regrouper par domaine fonctionnel (Facturation, Utilisateurs…).
Le dossier de variables
Section titled “Le dossier de variables”C’est la pièce centrale. Un dossier de variables (ou dossier d’environnement) porte :
- ses environnements (
local,recette,production…), chacun avec ses variables, et éventuellement des sous-environnements ; - ses listes de valeurs personnalisées ;
- les énumérations issues d’un import ;
- la documentation d’API générée à l’import (modèles, descriptions, schémas de sécurité) ;
- les routes d’authentification proposées à ses requêtes.
Toute requête placée sous ce dossier hérite de l’environnement sélectionné.
C’est ce qui vous permet d’écrire {{baseUrl}}/users une seule fois et de
basculer d’un environnement à l’autre depuis la smartbar.
Un import crée toujours un dossier de variables : c’est l’unité de « re-synchronisation » quand vous rechargez la spécification source.
La requête
Section titled “La requête”Une requête porte un type (le protocole), un nom, une icône, des notes, des tags, et la configuration propre à son protocole. Elle peut aussi porter :
- une route d’authentification (Authentification) ;
- des paramètres rapides enregistrés.
Créez-en une par clic droit ▸ Ajouter ▸ puis le protocole voulu. La liste complète est au catalogue des protocoles.
Le même menu Ajouter propose les huit serveurs, qui sont des éléments à part entière : voir Mode serveur.
Le scénario
Section titled “Le scénario”Un graphe d’actions qui orchestre des requêtes et de la logique. Voir Scénarios.
Gestes utiles
Section titled “Gestes utiles”| Geste | Effet |
|---|---|
F2 | Renommer l’élément sélectionné |
Ctrl+D | Cloner l’élément (avec son sous-arbre) |
Suppr | Supprimer |
| Glisser-déposer | Déplacer dans l’arbre, réordonner les favoris |
| Clic milieu sur un fil d’Ariane | Ouvrir l’ancêtre dans un onglet d’arrière-plan |
Requêtes dépréciées
Section titled “Requêtes dépréciées”Une requête peut être marquée dépréciée — c’est notamment ce que fait la re-synchronisation d’un import lorsqu’une opération disparaît de la spécification source. Elle reste dans l’arbre, avec un bandeau d’avertissement en tête de son onglet, plutôt que d’être supprimée sous vos pieds.