Rapports
L'analyse a permis de déterminer si la variable Upgrade Compatibility Tool Vous pouvez exporter un rapport contenant une liste de problèmes pour chaque fichier spécifiant sa gravité, son code d’erreur et sa description des erreurs. La variable Upgrade Compatibility Tool exporte le rapport dans deux formats différents :
- A Fichier JSON.
- Un Rapport HTML.
Consultez l’exemple d’interface de ligne de commande suivant d’un rapport :
File: /app/code/Custom/CatalogExtension/Controller/Index/Index.php
------------------------------------------------------------------
* [WARNING][1131] Line 10: Extending from class 'Magento\Framework\App\Action\Action' that is @deprecated on version '2.4.4'
* [ERROR][1328] Line 10: Implemented interface 'Magento\Framework\App\Action\HttpGetActionInterface' that is non API on version '2.4.4'
Vérifiez les Référence des messages d’erreur rubrique pour plus d’informations sur les différentes erreurs que ce rapport peut générer.
Ce rapport contient également un résumé détaillé qui indique :
- Version actuelle: version actuellement installée.
- Version cible: version vers laquelle vous souhaitez effectuer la mise à niveau.
- Heure d’exécution: le temps nécessaire à l’analyse pour construire le rapport (mm:ss).
- Modules nécessitant une mise à jour: pourcentage de modules qui contiennent des problèmes de compatibilité et nécessitent une mise à jour.
- Fichiers nécessitant une mise à jour: pourcentage de fichiers contenant des problèmes de compatibilité et nécessitant une mise à jour.
- Nombre total d’erreurs critiques: nombre d’erreurs critiques détectées.
- Erreurs totales: nombre d’erreurs détectées.
- Avertissements totaux: nombre d’avertissements trouvés.
- Utilisation du pic mémoire: quantité maximale de mémoire de la variable Upgrade Compatibility Tool a atteint pendant l’exécution.
Voir l’exemple d’interface de ligne de commande suivant :
----------------------------- -----------------
Current version 2.4.1
Target version 2.4.4
Execution time 1m:8s
Modules that require update 71.67% (43/60)
Files that require update 18.05% (96/532)
Total critical issues 24
Total errors 159
Total warnings 53
Memory peak usage 902.00 MB
----------------------------- -----------------
Fichier JSON
Vous pouvez obtenir la sortie du fichier JSON lors de l’exécution de la variable Upgrade Compatibility Tool sur une interface de ligne de commande. La variable JSON
contient exactement les mêmes informations que celles affichées dans la variable Upgrade Compatibility Tool output :
- Liste des problèmes identifiés.
- Résumé de l’analyse.
Pour chaque problème rencontré, le rapport fournit des informations détaillées telles que la gravité et la description du problème.
Pour exporter ceci JSON
dans un autre dossier de sortie :
bin/uct upgrade:check <dir> --json-output-path[=JSON-OUTPUT-PATH]
Où les arguments sont les suivants :
<dir>
: répertoire d’installation Adobe Commerce.[=JSON-OUTPUT-PATH]
: répertoire de chemin d’accès pour l’exportationJSON
fichier de sortie.
var/output/[TIME]-results.json
.Rapport HTML
Vous pouvez obtenir le rapport HTML lors de l’exécution de l’outil sur une interface de ligne de commande ou via le Site-Wide Analysis Tool. Le rapport HTML contient également :
- Liste des problèmes identifiés.
- Résumé de l’analyse.
Vous pouvez facilement parcourir les problèmes identifiés au cours de la Upgrade Compatibility Tool analyse.
Vous pouvez filtrer les problèmes affichés sur le rapport en fonction du niveau de problème minimum (la valeur par défaut est WARNING
).
Une liste déroulante dans le coin supérieur droit permet de sélectionner un autre niveau. La liste des problèmes identifiés est filtrée en conséquence.
Le rapport HTML comprend également quatre graphiques différents :
- Modules par gravité des problèmes: affiche la répartition de la gravité par modules.
- Fichiers par gravité des problèmes: affiche la répartition de la gravité par fichiers.
- Modules classés par nombre total de problèmes: affiche les 10 modules les plus compromis en prenant en compte les avertissements, les erreurs et les erreurs critiques.
- Modules avec des tailles et des problèmes relatifs: plus un module contient de fichiers, plus son cercle est volumineux. Plus un module a de problèmes, plus son cercle rouge apparaît.
Ces graphiques vous permettent d’identifier les modules les plus compromis et ceux qui nécessitent davantage de travail pour effectuer une mise à niveau.
Les diagrammes des rapports de HTML sont également mis à jour en conséquence, à l’exception du Modules with relative sizes and issues
, qui est généré avec l’événement min-issue-level
qui a été initialement créé.
Si vous souhaitez afficher des résultats différents pour la variable Modules with relative sizes and issues
diagramme, vous devez exécuter à nouveau la commande en fournissant une autre valeur pour la variable --min-issue-level
.
Pour exporter ce rapport de HTML dans un dossier de sortie différent :
bin/uct upgrade:check <dir> --html-output-path[=HTML-OUTPUT-PATH]
Où les arguments sont les suivants :
<dir>
: répertoire d’installation Adobe Commerce.[=HTML-OUTPUT-PATH]
: répertoire de chemin d’accès pour l’exportation.html
fichier de sortie.
var/output/[TIME]-results.html
.