Assistant et problèmes de démarrage
Dernière mise à jour : 14/10/2026Le port est déjà utilisé
Cause possible
Une autre instance de QV2QS ou une autre application utilise le même port réseau. La console affiche ERROR: Port [number] is already in use.
Action proposée
Fermez l'autre application, ou spécifiez un port différent avec --port. Utilisez --port 0 pour permettre au système de sélectionner automatiquement un port disponible.
L'assistant s'ouvre dans Internet Explorer ou ne s'affiche pas correctement
Cause possible
Internet Explorer est le navigateur par défaut sur la machine. L'interface utilisateur QV2QS nécessite un navigateur moderne et ne fonctionne pas dans Internet Explorer.
Action proposée
Installez Google Chrome, Microsoft Edge ou Mozilla Firefox. QV2QS détecte le navigateur par défaut au démarrage et ouvre automatiquement un navigateur pris en charge lorsqu'il est disponible. Si aucun navigateur pris en charge n'est trouvé, la console affiche des liens de téléchargement.
Sur Windows Server 2019, Internet Explorer est le seul navigateur installé par défaut. Installez un navigateur pris en charge avant d'exécuter QV2QS en mode assistant. Alternativement, utilisez l'interface de ligne de commande, qui ne nécessite pas de navigateur. Voir Référence des arguments pour la liste complète des arguments de la CLI.
La conversion échoue ou produit des résultats inattendus dans l'assistant
Cause possible
L'assistant affiche une erreur récapitulative mais n'expose pas les détails diagnostiques complets nécessaires pour identifier la cause première.
Action proposée
Réexécuter la même conversion à partir de la ligne de commande avec la journalisation de débogage activée. Vous pouvez :
- Dans l'assistant, accédez à l'étape Révision.
- Cliquez sur Copier la commande pour copier la commande CLI complète dans le Presse-papiers.
- Ouvrez une fenêtre de terminal et collez la commande copiée.
- Ajoutez
--logLevel DEBUGà la fin de la commande et appuyez sur Entrée.
La console affiche une sortie détaillée couvrant chaque décision de conversion, appel d'API cloud, et étape de traitement d'objet. Le journal de débogage complet est également écrit dans le logs/ sous-dossier du répertoire de sortie.
La commande copiée inclut tous les paramètres configurés dans l'assistant. L'ajout de --logLevel DEBUG est le seul changement nécessaire pour activer les diagnostics complets.
Voir Journalisation et diagnostics pour plus de détails sur le format et l'emplacement des fichiers journaux.
La modale QV2QS a cessé de fonctionner
s'affiche dans le navigateur.
Cause possible
Le processus QV2QS a été fermé, a planté ou s'est terminé pendant que l'assistant était encore ouvert dans le navigateur. L'interface utilisateur surveille le service backend avec un contrôle de santé périodique et affiche la modale lorsque le service devient inaccessible.
Action proposée
Procédez de l'une des manières suivantes :
- Se reconnecter à la session actuelle. Copiez la commande affichée dans la modale et exécutez la commande dans un terminal. La commande inclut
--portet--noBrowserpour se rattacher au même onglet de navigateur sur le même port. Après le démarrage du serveur, cliquez sur Se reconnecter dans la modale. L'assistant reprend avec tous les paramètres précédemment saisis intacts. - Fermer l'onglet du navigateur. Cliquez sur Fermer la fenêtre dans la fenêtre modale. Tous les paramètres non enregistrés de la session de l'assistant actuelle sont perdus.
Le fichier de projet exemple est manquant ou corrompu
Cause possible
Le fichier QVW d'exemple dans %TEMP%\QV2QS\examples\ a été supprimé, déplacé ou modifié en dehors de QV2QS.
Action proposée
Supprimez le fichier affecté de %TEMP%\QV2QS\examples\ et redémarrez QV2QS. Une nouvelle copie est extraite automatiquement au lancement. Pour conserver une copie permanente d'un fichier d'exemple, copiez le fichier dans un dossier de travail local avant de le modifier. Voir Exemples de projets.