Sihirbaz ve başlangıç sorunları
Son güncelleme: 14.10.2026Bağlantı noktası zaten kullanımda
Olası neden:
QV2QS'in başka bir örneği veya başka bir uygulama aynı ağ bağlantı noktasını kullanıyor. Konsol görüntüler ERROR: Port [number] is already in use.
Önerilen eylem
Diğer uygulamayı kapatın veya --port ile farklı bir bağlantı noktası belirtin. Sistemin otomatik olarak uygun bir bağlantı noktası seçmesine izin vermek için --port 0 kullanın.
Sihirbaz Internet Explorer'da açılır veya doğru şekilde görüntülenmez
Olası neden:
Internet Explorer makinedeki varsayılan tarayıcıdır. QV2QS kullanıcı arayüzü modern bir tarayıcı gerektirir ve Internet Explorer'da çalışmaz.
Önerilen eylem
Google Chrome, Microsoft Edge veya Mozilla Firefox'u yükleyin. QV2QS, başlangıçta varsayılan tarayıcıyı algılar ve desteklenen bir tarayıcı mevcut olduğunda otomatik olarak açar. Desteklenen bir tarayıcı bulunamazsa, konsol indir bağlantılarını görüntüler.
Windows Server 2019'da, varsayılan olarak yüklü olan tek tarayıcı Internet Explorer'dır. QV2QS'i sihirbaz modunda çalıştırmadan önce desteklenen bir tarayıcı yükleyin. Alternatif olarak, tarayıcı gerektirmeyen komut satırı arayüzünü kullanın. CLI argümanlarının tam listesi için Argüman referansına bakın.
Dönüştürme başarısız olur veya sihirbazda beklenmedik sonuçlar üretir
Olası neden:
Sihirbaz özet bir hata görüntüler ancak kök nedeni belirlemek için gereken tam tanılama ayrıntısını açığa çıkarmaz.
Önerilen eylem
Aynı dönüştürmeyi komut satırından, hata ayıklama günlüğü etkinleştirilmiş halde tekrar çalıştırın. Aşağıdakileri yapın:
- Sihirbazda, İnceleme adımına gidin.
- Tam CLI komutunu panoya kopyalamak için Komutu kopyala'yı tıklayın.
- Bir terminal penceresi açın ve kopyalanan komutu yapıştırın.
- Komutun sonuna
--logLevel DEBUGekleyin ve Enter tuşuna basın.
Konsol, her dönüştürme kararını, bulut API çağrısını ve nesne işleme adımını kapsayan ayrıntılı çıktı görüntüler. Tam hata ayıklama günlüğü, çıktı dizinindeki logs/ alt klasörüne de yazılır.
Kopyalanan komut, sihirbazda yapılandırılan tüm ayarları içerir. --logLevel DEBUG eklemek, tam tanılama özelliğini etkinleştirmek için gereken tek değişikliktir.
Günlük dosyası biçimi ve konumu hakkında ayrıntılar için Günlük kaydı ve tanılama bölümüne bakın.
QV2QS durdu
modali tarayıcıda görünür
Olası neden:
QV2QS işlemi, sihirbaz tarayıcıda hala açıkken kapatıldı, çöktü veya sonlandırıldı. Kullanıcı arayüzü, arka uç hizmetini periyodik bir sistem durumu kontrolü ile izler ve hizmete ulaşılamaz hale geldiğinde kalıcı pencereyi görüntüler.
Önerilen eylem
Şunlardan birini yapın:
- Geçerli oturuma yeniden bağlan. Modalda görüntülenen komutu kopyalayın ve komutu bir terminalde çalıştırın. Komut, aynı bağlantı noktasında aynı tarayıcı sekmesine yeniden bağlanmak için
--portve--noBrowseriçerir. Sunucu başladıktan sonra, modalda Yeniden Bağlan'a tıklayın. Sihirbaz, daha önce girilen tüm ayarlar korunarak devam eder. - Tarayıcı sekmesini kapatın. Modalda Pencereyi kapat seçeneğine tıklayın. Mevcut sihirbaz oturumundaki kaydedilmemiş ayarlar kaybolur.
Örnek proje dosyası eksik veya bozuk
Olası neden:
Örnek QVW dosyası %TEMP%\QV2QS\examples\ QV2QS dışında silindi, taşındı veya değiştirildi.
Önerilen eylem
Etkilenen dosyayı şuradan silin %TEMP%\QV2QS\examples\ ve QV2QS'i yeniden başlatın. Yeni bir kopya başlatıldığında otomatik olarak çıkarılır. Örnek bir dosyanın kalıcı bir kopyasını saklamak için, değişiklik yapmadan önce dosyayı yerel bir çalışma klasörüne kopyalayın. Bkz. Örnek projeler.