Procedura guidata e problemi di avvio
Ultimo aggiornamento: 14/10/2026La porta è già in uso
Possibile causa
Un'altra istanza di QV2QS o un'altra applicazione sta utilizzando la stessa porta di rete. La console visualizza ERROR: Port [number] is already in use.
Azione proposta
Chiudi l'altra applicazione, o specifica una porta diversa con --port. Utilizzare --port 0 per consentire al sistema di selezionare automaticamente una porta disponibile.
La procedura guidata si apre in Internet Explorer o non viene visualizzata correttamente
Possibile causa
Internet Explorer è il browser predefinito sulla macchina. L'interfaccia utente QV2QS richiede un browser moderno e non funziona in Internet Explorer.
Azione proposta
Installa Google Chrome, Microsoft Edge o Mozilla Firefox. QV2QS rileva il browser predefinito all'avvio e apre automaticamente un browser supportato quando disponibile. Se non viene trovato alcun browser supportato, la console visualizza collegamenti download.
Su Windows Server 2019, Internet Explorer è l'unico browser installato per impostazione predefinita. Installa un browser supportato prima di eseguire QV2QS in modalità guidata. In alternativa, usa l'interfaccia a riga di comando, che non richiede un browser. Consulta Riferimento argomenti per l'elenco completo degli argomenti della CLI.
La conversione fallisce o produce risultati imprevisti nella procedura guidata
Possibile causa
La procedura guidata visualizza un errore riepilogativo ma non espone i dettagli diagnostici completi necessari per identificare la causa principale.
Azione proposta
Riesegui la stessa conversione dalla riga di comando con la registrazione di debug abilitata. Procedere come segue:
- Nella procedura guidata, passare al passaggio Riepilogo.
- Fare clic su Copia comando per copiare l'intero comando CLI negli Appunti.
- Apri una finestra del terminale e incolla il comando copiato.
- Accoda
--logLevel DEBUGalla fine del comando e premi Invio.
La console visualizza un output dettagliato che copre ogni decisione di conversione, chiamata API cloud e fase di elaborazione dell'oggetto. Il log di debug completo viene anche scritto nella sottocartella logs/ nella directory di output.
Il comando copiato include tutte le impostazioni configurate nella procedura guidata. Aggiungere --logLevel DEBUG è l'unica modifica necessaria per abilitare la diagnostica completa.
Consulta Registrazione e diagnostica per i dettagli sul formato e la posizione del file di log.
Il modale QV2QS si è arrestato
appare nel browser
Possibile causa
Il processo QV2QS è stato chiuso, si è bloccato o è stato terminato mentre la procedura guidata era ancora aperta nel browser. L'interfaccia utente monitora il servizio di backend con un controllo di integrità periodico e visualizza la modale quando il servizio diventa irraggiungibile.
Azione proposta
Effettuare una delle seguenti operazioni:
- Riconnettiti alla sessione corrente. Copia il comando visualizzato nella modale ed eseguilo in un terminale. Il comando include
--porte--noBrowserper ricollegarsi alla stessa scheda del browser sulla stessa porta. Dopo l'avvio del server, fare clic su Riconnetti nella modale. La procedura guidata riprende con tutte le impostazioni inserite in precedenza intatte. - Chiudi la scheda del browser. Fai clic su Chiudi finestra nella finestra modale. Eventuali impostazioni non salvate nella sessione corrente della procedura guidata andranno perse.
Il file di progetto di esempio è mancante o danneggiato
Possibile causa
Il file QVW di esempio in %TEMP%\QV2QS\examples\ è stato eliminato, spostato o modificato al di fuori di QV2QS.
Azione proposta
Elimina il file interessato da %TEMP%\QV2QS\examples\ e riavvia QV2QS. Una nuova copia viene estratta automaticamente all'avvio. Per conservare una copia permanente di un file di esempio, copiare il file in una cartella di lavoro locale prima di modificarlo. Vedi Progetti di esempio.