Guides
Migrer des collections Postman vers Endvia
Comment importer dans Endvia des collections, environnements et exports de données Postman ; valeurs secrètes, tests et stockage dans un dossier.
Endvia fonctionne directement avec les fichiers Postman : les collections sont importées, modifiées et enregistrées de nouveau au format Postman. Il n'y a ni compte ni serveur de synchronisation.
Que peut-on migrer ?
- Les fichiers Postman Collection v2.0 et v2.1 ; les dossiers, paramètres d'authentification, variables, scripts et descriptions sont conservés.
- Les fichiers d'environnement et de variables globales.
- L'export de données Postman (.zip) : toutes les collections et tous les environnements dans un seul fichier.
Étapes
- Dans Postman, exportez sous forme de fichiers la collection et les environnements qu'elle utilise, ou demandez l'export de données de votre compte.
- Dans Endvia, sélectionnez les fichiers avec Fichier › Importer (Ctrl/⌘ O). Les fichiers sont traités sur cet appareil.
- La fenêtre qui s'ouvre liste les éléments reconnus : pour les collections, le nombre de requêtes et de réponses d'exemple ; pour les environnements, le nombre de variables. Les éventuels avertissements s'affichent également ici.
- Vérifiez la liste et cliquez sur le bouton d'importation (par ex. Importer 3 éléments).
- Avec Requête › Gérer les environnements (Ctrl/⌘ E), choisissez l'environnement à utiliser à l'aide du bouton Activer.
- Ouvrez une requête et essayez-la avec Envoyer (Ctrl/⌘ ↵). Les résultats des tests s'affichent dans la section Tests de la réponse.
- Pour exécuter toute la collection dans l'ordre, ouvrez Affichage › Exécuteur.
Que signifient les avertissements ?
La fenêtre d'importation signale à l'avance ce que Endvia ne peut pas exécuter dans le fichier, ou ce qui manque dans le fichier :
- Variables secrètes : les variables secrètes dont la valeur ne figure pas dans le fichier doivent être saisies de nouveau dans l'environnement.
- pm.sendRequest et require : les scripts s'exécutent dans un environnement sans accès au réseau, pendant 5 secondes au maximum. Les lignes contenant ces appels produisent une erreur. Sont pris en charge pm.test, pm.expect, pm.environment et pm.response.
- Champs de formulaire attendant un fichier : les fichiers ne font pas partie de la collection ; ils doivent être sélectionnés de nouveau.
Stocker dans un dossier
Dans Chrome, Edge et Opera, Fichier › Connecter à un dossier conserve les collections sous forme de fichiers Postman dans le dossier choisi. Ce dossier peut être un dépôt git ou un lecteur partagé. Les valeurs verrouillées (secrètes) ne sont écrites ni dans ces fichiers ni dans les exports. La collection ouverte peut aussi être enregistrée seule comme fichier Postman avec la commande Fichier › Exporter : (nom de la collection).
Différence entre navigateur et ordinateur
Dans la version pour navigateur, les requêtes sont envoyées selon les règles du navigateur : si le serveur ne l'autorise pas (CORS), la réponse ne peut pas être lue, et certains en-têtes sont définis par le navigateur. Pour envoyer des requêtes sans cette restriction, l'application de bureau est nécessaire ; elle est en préparation. gRPC, MQTT et Socket.IO ne sont pas pris en charge.
Endvia s'ouvre immédiatement dans le navigateur.