> For the complete documentation index, see [llms.txt](https://kaliostest-nouvelle-version.gitbook.io/manuel-utilisateur/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kaliostest-nouvelle-version.gitbook.io/manuel-utilisateur/chapitre-9-le-textengine-avec-kaliostest/percy/execution.md).

# Execution

L'exécution des tests se déroule via les fichiers bat généré par le TextEngine (cf. [Execution en ligne de commande](/manuel-utilisateur/chapitre-8-le-textengine/execution-en-ligne-de-commande.md)). Vous les trouverez dans le dossier Batfiles.

### Plan de test Kalios

Si vous exécutez un plan de test Kalios, il est important de passer la variable Percy à 1 dans le fichier Config.

<figure><img src="https://2653574120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGTMFS98BdqWHcneEgIq%2Fuploads%2FJ4laJQ5HUH7XcNDpDRjb%2Fimage.png?alt=media&amp;token=61805198-ef3c-464c-8b3b-5df20f7a1354" alt=""><figcaption></figcaption></figure>

Votre test doit contenir l'action [VisualTesting ](/manuel-utilisateur/chapitre-4-documentation-de-reference-des-actions/actions-sur-composant/visualtesting-percy.md)dont vous pouvez retrouver la documentation.

### Librairie Kalios

Si vous souhaitez faire un test visuel en utilisant uniquement la librairie Kalios, il suffit d'utiliser l'action  [VisualTesting](/manuel-utilisateur/chapitre-4-documentation-de-reference-des-actions/actions-sur-composant/visualtesting-percy.md) et d'appeler getPercyResult() à la fin de votre programme pour alerter Percy que le test est fini.

Exemple :&#x20;

```java
public static void main(String[] args) throws IOException, InterruptedException {
    TextEngine.initWeb("https://magento.softwaretestingboard.com/", "parcours_magento");
    TextEngine.hoverbytext("Women");
    TextEngine.hoverbytext("Tops");
    TextEngine.clickbytext("Jacket");
    TextEngine.visualtesting("", "Tops-Jackets");
    TextEngine.close("");
    TextEngine.getPercyResult();
}
```

## **Étapes d'exécution**

1. **Définir le Token Percy :**

   Dans l'invite de commandes (CMD), vous devez d'abord configurer le token Percy en tant que variable d'environnement pour l'authentification.

   Utilisez la commande suivante pour définir le token :

   ```bash
   set PERCY_TOKEN=<votre_token_de_projet>
   ```

   Remplacez `<votre_token_de_projet>` par le token que vous avez obtenu depuis l'interface Percy.
2. **Exécuter votre test avec Percy CLI :**

   Une fois le token défini, vous pouvez exécuter votre  test avec la commande suivante, en utilisant le fichier `.bat` contenant vos tests :

   ```bash
   npx percy exec -- <nom_du_fichier_test>.bat
   ```

   Remplacez `<nom_du_fichier_test>.bat` par le nom de votre fichier bat contenant les commandes pour exécuter vos tests. Par exemple, si votre fichier de test s'appelle `run-tests.bat`, la commande sera :

   ```bash
   npx percy exec -- run-tests.bat
   ```

   Cette commande permettra à Percy d'exécuter les tests dans le fichier batch et de capturer les instantanés visuels tout au long du processus.
3. **Vérification des résultats :**

   Une fois l'exécution des tests terminée, Percy enverra les captures d'écran à Percy.io pour analyse et comparaison visuelle. Vous pourrez consulter les résultats dans votre tableau de bord Percy.

**Exemple complet :**

Si votre token Percy est `abc123` et votre fichier de test bat s'appelle `test-suite.bat`, l'exécution se fera comme suit :

```bash
set PERCY_TOKEN=abc123
npx percy exec -- test-suite.bat
```

Cela définira le token d'authentification, puis exécutera vos tests tout en capturant les différences visuelles.