Collections et partage en équipe

Les requêtes ne sont utiles que si vous pouvez les retrouver. Echo organise le travail en espaces et en collections et vous permet de partager cette structure avec votre équipe selon vos besoins.

Organisez votre travail

Les espaces constituent le premier niveau : utilisez-en un par projet, produit ou client. Les collections y contiennent des requêtes et des dossiers imbriqués. Un espace créé sur le bureau est personnel et vous appartient dans l'organisation sélectionnée. La propriété et l'accès d'une équipe sont gérés séparément ; donner le nom d'une équipe à un espace n'en fait pas un espace d'équipe. Consultez votre compte pour connaître les limites du forfait actif.

Garder le tout organisé est simple :

  • Recherchez un nom dans la barre latérale. Les dossiers contenant des résultats restent visibles pour situer chaque élément.
  • Renommez un élément depuis son menu ou dans l'arbre. Déplacez les requêtes entre collections et les dossiers dans un espace ou entre les espaces auxquels vous avez accès.
  • Choisissez l'ordre alphabétique ou revenez à l'ordre par défaut enregistré. Le tri modifie la présentation de l'arbre.
  • Dupliquez une requête pour essayer une variante sans changer l'original. La duplication copie les requêtes, pas des espaces entiers ni des arbres de collections.
  • Activez le mode sélection pour cocher plusieurs éléments. Sélectionner tous les éléments visibles respecte la recherche actuelle. Utilisez la barre de sélection pour déplacer, supprimer ou exporter ; la duplication groupée concerne les requêtes sélectionnées.

Supprimer une collection ou un espace supprime aussi son contenu. Lisez la confirmation, notamment après avoir sélectionné un dossier et ses éléments. La sélection du dossier inclut déjà ses descendants.

Les nouveaux onglets HTTP ou gRPC peuvent commencer comme brouillons. Enregistrez un brouillon dans une collection pour le réutiliser. Requête rapide crée une requête enregistrée dans la collection Quick de l'espace Personal et crée ces groupes si nécessaire. Consultez le premier envoi dans premiers pas.

Partagez avec l'équipe

Connectez-vous, choisissez le bon espace de travail et synchronisez d'abord la collection. En tant que propriétaire, ouvrez Partager dans son menu, recherchez une personne de l'organisation, choisissez le niveau d'accès et ajoutez-la. Le même dialogue présente les autorisations existantes pour modifier un niveau ou révoquer un accès. Les changements de partage exigent une connexion et peuvent échouer même si l'enregistrement d'une requête sur l'appareil fonctionne.

Chaque partage possède un niveau d'autorisation :

Niveau Usage dans une collection personnelle partagée
Lecture Ouvrir et envoyer des requêtes sans modifier la collection enregistrée.
Contribution Ajouter et modifier des requêtes.
Accès complet Ajouter, modifier et supprimer des requêtes.

L'accès complet ne transfère pas la propriété. Sur le bureau, gérer la collection elle-même, notamment son nom, sa structure et son partage, reste soumis à la propriété. Les groupes reçus par partage ne sont pas des destinations libres pour déplacer des éléments ou créer des dossiers. Les collections d'équipe reçues dans ces groupes sont en lecture seule, même si un niveau supérieur est enregistré dans un autre contexte.

Les destinataires trouvent les collections dans Partagé avec moi, regroupées par la personne qui les a partagées. Synchronisez après les changements d'accès. Si la modification devient indisponible, vérifiez l'autorisation actuelle et l'espace de travail. Partager une requête ne donne pas non plus accès à son API cible, qui continue à vérifier ses propres identifiants.

Travaillez dans plusieurs organisations

Si vous appartenez à plusieurs organisations, le sélecteur d'espace de travail permet de passer de l'une à l'autre sans vous déconnecter puis vous reconnecter. Chaque espace de travail conserve ses propres espaces, collections et partages. Choisissez le même espace de travail dans Echo et Maestro pour travailler avec des mocks synchronisés, des contrats et des applications.

Synchronisez entre appareils

Le travail de votre compte se synchronise par le service Gapfy : espaces, collections, requêtes, environnements, planifications, serveurs de mock et suppressions. Supprimer une collection sur le bureau transmet cette suppression aux autres appareils. L'historique des requêtes et les cookies restent sur l'appareil. Une planification ou un mock synchronisé ne s'exécute pas nécessairement sur un serveur ; son mode d'exécution ou d'hébergement le détermine.

Utilisez Synchroniser maintenant pour envoyer les modifications en attente et récupérer les mises à jour. La barre d'état et le journal de synchronisation de l'Inspector permettent de distinguer un cycle terminé d'une absence de connexion, d'une connexion au compte nécessaire ou d'un échec partiel. Si une limite du forfait refuse une modification, l'élément reste en attente sur l'appareil. Résolvez cette limite et réessayez avant de compter sur cette modification chez vos collègues.

Les applications Android et iOS partagent le moteur de synchronisation. Les collections de votre compte peuvent vous suivre entre le bureau et le mobile sans export séparé pour chaque appareil. Leurs éditeurs et outils disponibles diffèrent ; consultez le guide mobile.

Examiner l'activité et les conflits

Activité permet de retrouver les changements enregistrés, comme la création, le renommage et la suppression d'éléments. Filtrez par action, type d'élément, date ou texte, appliquez les filtres et ouvrez le contexte d'une entrée pour revenir à l'élément concerné.

Lorsque plusieurs appareils modifient un élément, la synchronisation peut choisir automatiquement une version selon ses règles de date de mise à jour. Les conflits enregistrés permettent d'examiner ces décisions après coup. Ils ne signifient pas que la synchronisation s'est toujours arrêtée avant de remplacer une valeur.

  1. Ouvrez Conflits et filtrez par type d'élément, résolution, date ou texte.
  2. Développez une entrée pour comparer les versions capturées sur l'appareil et sur le serveur.
  3. Acquittez-la si le résultat actuel convient. Cette action marque l'examen de l'entrée, sans restaurer de données.
  4. Choisissez de conserver la version distante pour restaurer la copie capturée du serveur. Lisez la confirmation : cette action modifie l'élément sur l'appareil et le place en attente de synchronisation.
  5. Utilisez la fusion si vous avez besoin de champs des deux versions. Choisissez la valeur de l'appareil ou du serveur pour chaque champ différent, ou utilisez les actions pour tous les champs, puis appliquez le résultat.

Vous pouvez inclure les entrées déjà examinées dans la liste ultérieurement. La restauration et la fusion exigent que les versions enregistrées soient disponibles et que l'élément existe encore.

Réparer des éléments absents du serveur

Le dialogue des problèmes de synchronisation regroupe les éléments de l'appareil dont l'équivalent sur le serveur, ou le dossier parent, est introuvable. Vérifiez le nom et le contenu du groupe. Restaurer le renvoie pour le recréer sur le serveur. Supprimer la copie locale retire le groupe de cet appareil après confirmation. Cela peut inclure des collections et des requêtes imbriquées.

Choisissez selon la copie à conserver. Restaurer peut ramener du contenu supprimé volontairement par une autre personne ; supprimer la copie de l'appareil abandonne son travail non synchronisé. Après une réparation, attendez la synchronisation suivante et vérifiez son résultat. Cette réparation est distincte du choix des champs dans un conflit enregistré.

Partagez un mock que l'on peut appeler

Partager une collection donne à vos collègues accès à votre travail organisé. Pour donner un endpoint HTTP à une application, publiez un mock synchronisé depuis le panneau d'hébergement public de Maestro. Créer et essayer un mock sur le bureau est compris dans tous les forfaits Echo, Free inclus ; le publier sur le service public fait partie d'Echo Pro et Pro AI et, dans un espace d'équipe, nécessite aussi Echo/ManageHosting. Le guide de l'hébergement public de mocks explique les URL publiques et les contrôles d'hébergement.

Pour accéder automatiquement à la publication de contrats, aux contrats liés ou aux règles pour .NET, utilisez applications et clés. Créer une nouvelle clé fait partie d'Echo Pro et Pro AI, même si les contrats dans Maestro restent compris dans Free. Les autorisations des collections et les scopes des clés d'application ont des rôles différents. Partager une collection ne crée pas de clé.

Mode invité et travail local

Organiser les requêtes, les espaces et les dossiers et utiliser les opérations groupées fonctionne aussi en mode invité, entièrement hors ligne. Le partage, la synchronisation et les espaces de travail nécessitent un compte connecté. Consultez premiers pas pour connaître la différence entre les deux modes.

Étapes suivantes