Prérequis
Un cas de test comportant deux fichiers à comparer, par exemple un fichier téléchargé lors d’une étape précédente et référencé sous le nom
[DOWNLOADED_FILE_1].Les deux fichiers respectant les formats et les limites de taille indiqués dans Limites et fichiers pris en charge ci-dessous.
Comprendre l’étape de comparaison de fichiers
L'étape de comparaison de fichiers compare automatiquement un fichier à un autre et vous indique, en langage clair, si leurs contenus correspondent. Elle est optimisée par l'IA : au lieu d'une comparaison rigide octet par octet, elle comprend les documents et signale les différences qui intéresseraient réellement un réviseur.
C'est cette distinction qui fait la valeur de l'étape. Une comparaison octet par octet entre deux PDF générés à quelques secondes d'intervalle échoue sur l'horodatage du pied de page et ne vous apprend rien. Elle lit les deux documents et fait remonter ce qui compte vraiment : un total incohérent, une variable de remplacement jamais renseignée, une ligne disparue d'un export.
Limites : la comparaison porte uniquement sur le contenu. Elle ne signale pas les différences de polices, de couleurs, d’espacement ou de mise en page. Pour les vérifications visuelles, utilisez l’étape de comparaison visuelle.
Pourquoi utiliser l’étape « Comparaison de fichiers »
Les documents produits par l'application sont l'angle mort des tests de bout en bout. Le test clique sur Générer la facture, voit un fichier arriver dans le dossier de téléchargement, et réussit, sans que personne n'ait jamais vérifié ce qu'il contient.
Vérifier qu’une facture, un export ou un rapport téléchargé correspond bien au fichier de référence attendu.
Vérifier qu’un document généré a correctement rempli un modèle.
Détecter les valeurs modifiées, manquantes ou ajoutées d’un format à l’autre, même lorsque les deux fichiers sont de types différents.
Ajouter une étape « Comparaison de fichiers »
Ajoutez une nouvelle étape à votre scénario de test et sélectionnez « Comparaison de fichiers ». Définissez ensuite :
Fichier 1 : le premier fichier à comparer (souvent votre fichier attendu ou de référence).
Fichier 2 : le deuxième fichier (souvent le fichier réel ou généré).
Instructions (optionnel) : une brève instruction décrivant le lien entre les deux fichiers et ce que signifie « correct ».
Les trois champs acceptent les variables de test : un fichier produit plus tôt dans l'exécution s'insère directement sous la forme [DOWNLOADED_FILE_1], et les instructions peuvent référencer les valeurs générées par votre test, comme [CUSTOMER_NAME]. Vous pouvez aussi joindre un fichier directement dans Fichier 1 ou Fichier 2 au lieu de référencer une variable.
Astuce : les instructions constituent le principal facteur d’influence sur la précision. Une phrase claire expliquant le lien entre les fichiers améliore considérablement le résultat.
Rédiger de bonnes instructions
Les instructions remplissent deux rôles : elles indiquent le lien entre les deux fichiers et définissent ce qui doit être vérifié.
Choisir le mode de comparaison
Comparaison fidèle (par défaut) : les deux fichiers contiennent des valeurs concrètes. Chaque champ est comparé directement, et toute valeur du fichier 2 qui diffère de celle du fichier 1, qui y est absente ou qui la contredit est signalée comme une divergence. Utilisez cette option pour vérifier si « le fichier réel correspond au fichier attendu ».
Modèle à générer : un fichier est un modèle contenant des espaces réservés (tels que
[CUSTOMER_NAME]) et l’autre est le document généré à partir de celui-ci. Ici, un espace réservé correctement remplacé par une valeur réelle est attendu et considéré comme correct, et non comme une différence.
Le mode « modèle » est sélectionné automatiquement lorsque l'un des deux fichiers contient visiblement des variables de remplacement : vous n'avez donc pas à le nommer, mais l'indiquer explicitement reste la solution la plus fiable.
Définir ce qui est vérifié
Les instructions délimitent aussi la portée de la comparaison. Tout ce qu'elles demandent est vérifié et signalé ; une différence réelle sur laquelle elles ne portent pas est entièrement exclue des résultats.
Trois exécutions sur les deux mêmes catalogues produits montrent la différence :
Instructions : « Vérifiez que le fichier 2 correspond exactement au fichier 1. » → 3 non correspondants. Tous les champs sont comparés : le prix modifié, la ligne manquante et la ligne en trop sont tous signalés.
Instructions : « Vérifiez que le prix de SKU-114 est identique dans les deux fichiers. » → 1 non correspondant. Seul le prix est vérifié ; la ligne manquante et la ligne en trop sont hors périmètre.
Instructions : « Vérifiez que l'extension est identique. » → 1 correspondant, l'étape réussit. Les deux fichiers sont des CSV, ce qui est tout ce qui était demandé. La différence de prix est réelle, mais hors périmètre.
Si une différence qui vous importe est absente des résultats, élargissez vos instructions. Si les résultats sont trop bruyants, restreignez-les. Les instructions peuvent aussi nommer les champs à ignorer, comme une colonne d'horodatage ou un numéro de facture.
Exemples
Vérifier une facture générée par rapport à son bon de commande
Le scénario le plus courant : le test pilote l'application, télécharge le document produit, puis le compare à une référence. Comme les instructions peuvent porter une correspondance de champs, les deux documents ne sont pas tenus d'employer les mêmes libellés.
Ajoutez une étape de comparaison de fichiers avec Fichier 1 = expected_order.pdf, Fichier 2 = [DOWNLOADED_FILE_1], et ces instructions : « Le fichier 1 est un bon de commande et le fichier 2 est la facture générée à partir de celui-ci. Comparez les données du fichier 1 à celles du fichier 2 selon cette correspondance de champs : Client [CUSTOMER_NAME] vers Facturé à, Article [ITEM_NAME] vers Description, Quantité [QUANTITY] vers Unités, Prix unitaire [UNIT_PRICE] vers Tarif, Total attendu vers Montant dû. Ignorez le numéro de facture et les dates. Considérez les formats de devise comme équivalents. »
La valeur de cette étape tient à ce qu'elle détecte et qu'une assertion sur l'interface ne verra jamais : la facture s'affiche parfaitement, le téléchargement réussit, et le total est malgré tout erroné.
Détecter une variable de remplacement jamais renseignée
Définissez Fichier 1 = quote_template.docx, Fichier 2 = [DOWNLOADED_FILE_1], et les instructions « Le fichier 1 est un modèle contenant des champs à remplir ; le fichier 2 est le document généré à partir de ce modèle. Vérifiez que chaque champ a bien été remplacé par une valeur réelle. »
Résultat : un seul constat en échec, le numéro de devis affichant encore la variable de remplacement au lieu d'une valeur réelle.
Toutes les autres variables de remplacement ont été correctement substituées et sont signalées comme réussies : le seul champ défectueux est donc facile à repérer. Les modèles comportant des sections conditionnelles sont traités de la même manière : exactement une branche doit apparaître dans le document généré, et un bloc qui n'en affiche aucune, ou les deux, est signalé comme un échec.
Contrôler un export de données par rapport aux données de référence
Définissez Fichier 1 = products_reference.csv, Fichier 2 = [DOWNLOADED_FILE_1], et les instructions « Vérifiez que le fichier 2 correspond exactement au fichier 1. » Cela détecte les trois façons dont un export se dégrade, chacune sous forme de constat distinct : le prix modifié de SKU-114, la ligne SKU-117 absente, et la ligne SKU-999 en trop.
Comparer deux formats différents
Définissez Fichier 1 = transactions.json, Fichier 2 = transactions_export.csv, et les instructions « Le fichier 2 est un export CSV des transactions listées dans le fichier 1. Vérifiez que chaque transaction correspond. » Une comparaison textuelle ne peut tout simplement pas confronter un JSON à un CSV. L'étape de comparaison de fichiers extrait les transactions des deux et les met en regard.
Interprétation des résultats
Une fois l’étape exécutée, vous obtenez un résultat global et une analyse détaillée :
Une étape verte, avec un badge correspondant au-dessus de la comparaison : aucune différence significative n’a été détectée dans le périmètre défini par vos instructions.
Une étape rouge, avec un badge non correspondant : au moins une divergence a été détectée.
Le badge compte les vérifications : il indique 3 non correspondants lorsque trois constats sont en échec et 1 correspondant lorsque les fichiers concordent.
Ouvrez l’étape pour voir chaque résultat sous forme de sous-étape distincte, avec la valeur attendue, la valeur réelle et un court extrait de chaque fichier (y compris la page pour les fichiers PDF et DOCX).
Une étape réussie ne liste aucun constat.
En sélectionnant un constat, les deux documents s'ouvrent côte à côte, en Fichier 1 et Fichier 2, avec l'extrait mis en évidence dans chacun, ce qui vous montre la valeur divergente dans son contexte d'origine au lieu de vous fier au seul résumé.
Relancer une étape dont les fichiers et les instructions n'ont pas changé renvoie immédiatement le même résultat. Modifier l'un ou l'autre déclenche une nouvelle comparaison.
Limites et fichiers pris en charge
Formats pris en charge : PDF, DOCX, CSV, XML, JSON, TXT. Les deux fichiers ne doivent pas nécessairement être du même type ; vous pouvez donc comparer un fichier CSV à un fichier PDF.
Taille maximale : 20 Mo par fichier.
Longueur maximale : 100 pages par PDF.
Les fichiers PDF doivent contenir du texte sélectionnable. Les PDF numérisés ou constitués d'images ne sont pas pris en charge, car il n'y a pas d'OCR.
Les fichiers protégés par mot de passe ou corrompus ne peuvent pas être lus.
Les fichiers d'archive (tels que .zip) ne sont pas pris en charge ; extrayez-les ou convertissez-les d'abord.
Dépannage / FAQ
« Le fichier est dans un format non pris en charge. » Convertissez le fichier vers un format pris en charge, ou extrayez l'archive et comparez les fichiers qu'elle contient.
« Le fichier semble être constitué uniquement d'images. » Le PDF ne contient aucun texte extractible, généralement parce qu'il s'agit d'un scan. Comparez plutôt une version textuelle du document.
« Le fichier est protégé et ne peut pas être lu. » Fournissez une copie sans protection par mot de passe.
Le fichier dépasse la limite de 20 Mo ou de 100 pages. Comparez un extrait plus court, ou divisez le document et comparez la partie concernée.
Une valeur qui devrait correspondre est signalée comme différente. Vérifiez que le Fichier 1 et le Fichier 2 sont bien attribués conformément à vos instructions (Fichier 1 = valeur attendue ou modèle, Fichier 2 = valeur réelle ou générée).
Une variable de remplacement correctement renseignée est signalée comme une différence. Indiquez dans les instructions que le fichier 1 est un modèle et le fichier 2 le document généré à partir de celui-ci.
L'étape signale que les fichiers décrivent des enregistrements différents. Ils ne correspondent pas du tout : vérifiez quel fichier l'étape précédente a placé dans le Fichier 2.