# Mener une campagne

> Ouvrir une campagne, remettre les feuillets aux testeurs, suivre, déclarer où en est la recette, recevoir le PV et autoriser l’exploitation.

## Ouvrir une campagne

Menu **Campagnes** (ou la page du projet) › **Ouvrir une campagne** :

- **le projet** ;
- **la nature** : **Recette** (le défaut — on éprouve le logiciel, chaque ligne se coche ok, ko ou er) ou **Prise en main** (on forme les personnes à l’exploitation, chaque ligne se coche acquis, à revoir ou non vu — voir [une campagne de prise en main](#une-campagne-de-prise-en-main)) ;
- **la version candidate** : celle que l’on éprouve, par exemple `guerway-api 0.25.0` ;
- **l’instance à éprouver** : l’adresse où les testeurs jouent, par exemple `https://direction.eaststore.fr` — **jamais la production** (ValiTrax refuse une adresse qui commence par `prod`).

**La campagne naît prête** : ValiTrax tire de QaTrax les feuillets du projet, les prépare et ouvre la recette. Le message en haut de la campagne le dit (« Campagne prête : 10 feuillet(s) venus de QaTrax »). S’il dit que la trame n’a pas pu venir, prévenez l’administrateur : la [liaison avec QaTrax](/aide/administration#la-liaison-avec-qatrax) ou la clé du projet chez QaTrax est à vérifier ([une campagne sans feuillet](/aide/administration#une-campagne-sans-feuillet)). La campagne se répare ensuite, sans en ouvrir une autre.

## Une campagne de prise en main

> **Une campagne de recette ne montre pas les fiches de formation**, même quand la trame les contient : elle ne présente que les feuillets de recette (`SPEC-RCT-…`). Sa carte **Fiches de prise en main dans la trame** nomme les fiches de formation et propose **Ouvrir la prise en main** sur la même version ; une fois ouverte, elle y mène. Pour une entreprise cliente, passez par la [nouvelle vente](/aide/entreprises#une-nouvelle-vente).

Une campagne **Prise en main** sert à **former** les personnes qui vont exploiter le logiciel, fiche par fiche, rôle par rôle. Le feuillet est le même qu’en recette — une ligne, trois cases, une remarque dessous, des pièces — mais ses colonnes changent :

| colonne | quand la cocher |
|---|---|
| **acquis** | le geste est fait seul, sans aide, et la personne sait dire ce que l’écran lui a répondu |
| **à revoir** | le geste est fait avec de l’aide, ou en hésitant : il se reprend avant l’exploitation |
| **non vu** | l’exercice n’a pas été fait (temps, étape d’avant manquante) : il reste à faire |

- **Les fiches viennent de QaTrax**, comme les feuillets de recette : ce sont les exigences `SPEC-PEM-<rôle>` du projet (par exemple « 04-G-agent-guichet », lignes PM-G1, PM-G2…). La campagne les prépare à l’ouverture ; vous les remettez de la même façon.
- En haut de la campagne, les compteurs disent **acquis**, **à revoir**, **non vu**. La carte **Lignes à reprendre** liste les lignes à revoir ou non vues, avec la remarque et la personne : elles se reprennent avec le formateur.
- **Rien ne part à QaTrax** : une ligne « à revoir » n’est pas un défaut du logiciel. La carte « Où en est la recette ? » n’existe pas pour une prise en main, et une déclaration est refusée avec un message.
- La [console des formations](/aide/formations) suit toutes les prises en main du projet : qui est prêt, ce qui reste. *Prévu* : les **lignes difficiles** partiront à QaTrax comme **demandes d’amélioration**, jamais comme bugs ([remonter les lignes difficiles](/aide/formations#remonter-les-lignes-difficiles-a-qatrax)).
- Une **anomalie** constatée pendant la formation (une page qui ne répond pas) se déclare toujours en bas de la fiche ; si c’est un vrai défaut, faites-la jouer dans une campagne de **recette**.

## Remettre les feuillets

La carte **Feuillets par rôle** liste les feuillets dans l’ordre (01-A-administrateur, 02-DR-directeur-regional…), avec leur nombre de lignes et leur état. Pour chacun : choisissez un **testeur** dans la liste, puis **Remettre au testeur**. Il est prévenu par courriel et trouve le feuillet dans **Mes feuillets**. Le nom du testeur et l’état de son feuillet (remis, rendu) s’affichent ensuite sur la ligne.

La liste est vide ? [Ajoutez des testeurs](/aide/testeurs) sur la page du projet. Un même testeur peut recevoir plusieurs feuillets ; un même feuillet peut être remis à plusieurs testeurs.

## Suivre la recette

En haut de la campagne : feuillets rendus, nombre de **ok**, **ko**, **er**, anomalies.

- La carte **Défauts relevés** liste les **lignes** cochées ko ou er : qui l’a relevée, sa remarque, ses pièces, et ce que QaTrax en dit. Le dernier relevé de chaque feuillet fait foi ; si une même ligne est relevée dans **plusieurs feuillets** (deux testeurs, un feuillet remis deux fois), elle compte pour son **pire** relevé — er, puis ko, puis ok : un défaut ne disparaît pas tant qu’un testeur le voit encore.

![Défauts relevés : la ligne A2 en ko, relevée par Camille, avec sa remarque et une pièce — « à corriger » chez QaTrax](/aide/images/campagne-defauts-a-corriger.png)
- La carte **Anomalies** liste les défauts qui ne tiennent à **aucune ligne** (« Déclarer une anomalie » dans le feuillet). Un ko sur une ligne n’y figure donc pas : il est dans **Défauts relevés**.

## Les défauts et leurs corrections

Le chemin d’un défaut :

1. un testeur coche **ko** ou **er** sur une ligne, avec sa remarque et ses captures ;
2. vous **déclarez** où en est la recette ([ci-dessous](#declarer-ou-en-est-la-recette)) : la ligne part chez QaTrax et devient un défaut **à corriger** ;
3. l’équipe de développement le prend (**en cours de correction**), le répare, et livre une nouvelle version : **corrigé dans <version> — à rejouer** ;
4. le testeur **rejoue** la ligne : ok si c’est bon ; la déclaration suivante le dit à QaTrax, qui confirme la correction (**corrigé, confirmé en recette**) — ou rouvre le défaut si c’est encore ko.

Un testeur peut aussi envoyer lui-même son travail (**Envoyer ma recette partielle**, dans son feuillet) : l’envoi apparaît dans l’historique des déclarations, à son nom.

ValiTrax relit l’état des corrections chez QaTrax **après chaque déclaration**, et quand vous cliquez sur **⟳ Voir les corrections** (carte **Défauts relevés**). Les lignes corrigées apparaissent aussi en tête du feuillet du testeur, dans un encadré **À rejouer**.

![Après la correction : A2 « corrigé dans exemple-app 1.0.1 — à rejouer », avec le mot de l’équipe](/aide/images/campagne-defauts-corrige.png)

| ce que dit ValiTrax | ce que cela veut dire |
|---|---|
| pas encore envoyé à QaTrax | la ligne est en défaut ici, mais aucune déclaration ne l’a encore envoyée |
| à corriger | QaTrax l’a reçue : l’équipe doit la corriger |
| en cours de correction | l’équipe y travaille |
| corrigé dans <version> — à rejouer | la correction est livrée : faites rejouer la ligne |
| corrigé, confirmé en recette | la ligne a été rejouée ok : le défaut est clos |
| écarté par l’équipe | l’équipe ne le retient pas (elle en dit la raison dans QaTrax) |

Pour éprouver une correction, l’instance d’essai doit porter la version qui corrige : vérifiez-la avant de faire rejouer.

## Déclarer où en est la recette

La carte **Où en est la recette ?** a trois boutons ; chacun **envoie** à QaTrax, sans autre geste, ce que les testeurs ont relevé :

| bouton | quand | ce qui part | la suite |
|---|---|---|---|
| **Partiellement fini** | une partie des feuillets est jouée | un rapport d’étape signé : relevés, remarques, pièces, anomalies | QaTrax ouvre un bug par **ko**, **er** et anomalie ; la recette continue |
| **L’urgent est fini** | les lignes prioritaires sont jouées | le même rapport, marqué « urgent » | les corrections urgentes peuvent commencer |
| **Fini** | la recette est terminée | les feuillets encore ouverts sont rendus, le dossier est figé ; le rapport **et** le dossier partent | QaTrax prononce le PV |

Un mot pour l’équipe qui corrige peut accompagner l’envoi. Chaque envoi est consigné sous les boutons, avec la réponse de QaTrax (« ✓ reçu — 3 défaut(s) ouvert(s), 1 résolu(s) ») ou l’erreur ; un envoi échoué se refait.

**Corriger, puis rejouer** : après une correction, faites rejouer la ligne et déclarez de nouveau ; une ligne repassée **ok** **résout** son bug chez QaTrax.

## Le procès-verbal

Après « Fini », la carte **Procès-verbal** dit que le dossier est chez QaTrax. **⟳ Voir si le PV est arrivé** le redemande : dès qu’il est prononcé, il est **vérifié** (signature de QaTrax, empreinte du dossier) puis affiché — verdict, feu ou pas. S’il porte le feu, **🚦 Autoriser l’exploitation** devient possible ; sinon l’exploitation reste fermée, et une nouvelle campagne suivra les corrections.

## Revenir, abandonner

Voir [Le parcours d’une recette](/aide/parcours#revenir-en-arriere-abandonner).