Rapporti
In seguito all'analisi, Upgrade Compatibility Tool può esportare un report contenente un elenco di problemi per ogni file specificandone la gravità, il codice di errore e la descrizione. Upgrade Compatibility Tool esporta il report in due formati diversi:
Vedi il seguente esempio di interfaccia della riga di comando di un rapporto:
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'
Per ulteriori informazioni sui diversi errori che il report può generare, consultare l'argomento Riferimento messaggio di errore.
Questo rapporto include anche un riepilogo dettagliato che mostra:
- Versione corrente: versione attualmente installata.
- Versione di destinazione: la versione a cui si desidera eseguire l'aggiornamento.
- Tempo di esecuzione: tempo impiegato dall'analisi per generare il report (mm:ss).
- Moduli che richiedono aggiornamento: la percentuale di moduli che contengono problemi di compatibilità e richiedono l'aggiornamento.
- File che richiedono aggiornamento: la percentuale di file che contengono problemi di compatibilità e richiedono l'aggiornamento.
- Totale errori critici: numero di errori critici rilevati.
- Errori totali: numero di errori trovati.
- Totale avvisi: numero di avvisi trovati.
- Utilizzo massimo della memoria: la quantità massima di memoria raggiunta da Upgrade Compatibility Tool durante l'esecuzione.
Vedi il seguente esempio di interfaccia della riga di comando:
----------------------------- -----------------
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
----------------------------- -----------------
File JSON
È possibile ottenere l'output del file JSON durante l'esecuzione di Upgrade Compatibility Tool su un'interfaccia della riga di comando. Il file JSON contiene esattamente le stesse informazioni visualizzate nell'output Upgrade Compatibility Tool:
- Elenco dei problemi identificati.
- Riepilogo dell’analisi.
Per ogni problema riscontrato, il rapporto fornisce informazioni dettagliate come la gravità e la descrizione del problema.
Per esportare il file JSON in una cartella di output diversa:
bin/uct upgrade:check <dir> --json-output-path[=JSON-OUTPUT-PATH]
Dove gli argomenti sono i seguenti:
<dir>: directory di installazione di Adobe Commerce.[=JSON-OUTPUT-PATH]: directory del percorso per esportare il file di outputJSON.
var/output/[TIME]-results.json.Rapporto HTML
È possibile ottenere il report HTML durante l'esecuzione dello strumento su un'interfaccia della riga di comando o tramite Site-Wide Analysis Tool. La relazione HTML contiene inoltre:
- Elenco dei problemi identificati.
- Riepilogo dell’analisi.
Puoi navigare facilmente tra i problemi identificati durante l'analisi Upgrade Compatibility Tool.
È possibile filtrare i problemi visualizzati nel report in base al livello di problema minimo (il valore predefinito è WARNING).
Nell’angolo in alto a destra è presente un elenco a discesa che consente di selezionare un livello diverso. L’elenco dei problemi identificati viene filtrato di conseguenza.
Il rapporto HTML include anche quattro grafici diversi:
- Moduli per gravità problema: mostra la distribuzione della gravità per moduli.
- File in base alla gravità del problema: mostra la distribuzione della gravità in base ai file.
- Moduli ordinati in base al numero totale di problemi: mostra i 10 moduli più compromessi tenendo conto di avvisi, errori ed errori critici.
- Moduli con dimensioni e problemi relativi: più file contiene un modulo, più grande è il suo cerchio. Più problemi ha un modulo, più il suo cerchio appare rosso.
Questi grafici consentono di identificare i moduli più compromessi e quelli che richiedono più lavoro per eseguire un aggiornamento.
Anche i diagrammi di report di HTML vengono aggiornati di conseguenza, con l'unica eccezione di Modules with relative sizes and issues, generato con min-issue-level originariamente configurato.
Se si desidera visualizzare risultati diversi per il diagramma Modules with relative sizes and issues, è necessario rieseguire il comando specificando un altro valore per l'opzione --min-issue-level.
Per esportare il report HTML in una cartella di output diversa:
bin/uct upgrade:check <dir> --html-output-path[=HTML-OUTPUT-PATH]
Dove gli argomenti sono i seguenti:
<dir>: directory di installazione di Adobe Commerce.[=HTML-OUTPUT-PATH]: directory del percorso per esportare il file di output.html.
var/output/[TIME]-results.html.