Rapports

NOTE
La variable Upgrade Compatibility Tool est disponible uniquement pour les instances Adobe Commerce.

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 :

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’exportation JSON fichier de sortie.
NOTE
Le chemin par défaut du dossier de sortie est 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.

Rapport HTML - Résumé

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.

Rapport de HTML - Utilisation de la liste déroulante

NOTE
Les problèmes avec un niveau de problème plus faible sont supprimés, mais vous recevez une notification pour que vous soyez toujours conscient des problèmes identifiés par module.

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.

Rapport HTML - Diagrammes

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 .

Rapport de HTML - Diagramme de graphique à bulles

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.
NOTE
Le chemin par défaut du dossier de sortie est var/output/[TIME]-results.html.
recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea