Yaygın iş akışları
Son güncelleme: 14.10.2026Aşağıdaki örnekler en sık karşılaşılan kullanım durumlarını kapsar. Her biri aynı temel desene dayanır: bir QVW dosyası, bir çıktı klasörü ve bir Qlik Cloud bağlamı belirtin. Tüm örneklerde, --outputDir çıktı köküdür. QV2QS, QVW dosyası adında bir alt klasör otomatik olarak oluşturur (örneğin, ./output/Sales/). Tüm bu iş akışları, web tabanlı sihirbaz aracılığıyla da gerçekleştirilebilir. Rehberli yaklaşım için bkz. Sihirbaz adımları.
Verilerle Qlik Cloud'a dağıt
Standart taşıma iş akışı. QV2QS PRJ klasörünü oluşturur, kullanıcı arayüzünü dönüştürür, ikili veri yüklemesi için QVW'yi yükler, uygulamayı Qlik Cloud'da yeniden yükler ve bir Excel raporu üretir. Yüklenen QVW silinir ve orijinal komut dosyası yeniden yüklemeden sonra geri yüklenir.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Bir QVF dosyasını dışa aktar
QV2QS, Qlik Cloud motorunu kullanarak uygulamayı oluşturur, sonucu bir QVF dosyası olarak dışa aktarır, ardından bulut uygulamasını siler. Dışa aktarılan QVF, farklı bir Qlik Cloud kiracısına içe aktarılabilir.
QV2QS tarafından oluşturulan QVF dosyalarını Qlik Sense Enterprise Client-Managed'a içe aktarmak, tüm sürümlerde test edilmemiştir, resmi olarak desteklenmemektedir ve önerilmemektedir. Ayrıntılar için bkz. Qlik Sense Enterprise Client-Managed uyumluluğu.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Tüm bir QlikView ortamını toplu olarak taşıyın
Tüm QVW ve PRJ çiftleri için bir veya daha fazla klasörü tara, çiftleri paralel olarak dönüştür ve her birini Qlik Cloud'a dağıt. Eşzamanlılığı kontrol etmek için --batchWorkers kullanın.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
QlikView piksel düzenini koru
QlikView nesne konumlarını ve sayfa duvar kağıtlarını tam olarak korumak için sabit tuval modunu etkinleştirin. Ölçek faktörlerini, düzenin Qlik Sense ekran boyutlarına nasıl eşlendiğini kontrol etmek için ayarlayın.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Önceden dönüştürülmüş bir uygulamayı güncelle
Yeni bir tane oluşturmadan, mevcut bir Qlik Cloud uygulamasına dönüştürmeyi yeniden çalıştırın. QV2QS önceki çalıştırmadan uygulama kimliğini yeniden kullanır.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Bir uygulamayı, komut dosyasını koruyarak güncelleme
Mevcut bir uygulamanın kullanıcı arayüzü katmanını, komut dosyasının üzerine yazmadan güncellemek için dönüştürmeyi yeniden çalıştırın. Hedef uygulama mevcut veri bağlantılarını ve yeniden yükleme mantığını korur. Güncellemeden önce veri içermeyen bir yedekleme otomatik olarak dışa aktarılır. Mevcut komut dosyasını yürütmek ve verileri yenilemek için --reload ekleyin.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Bir uygulamayı değişkenlerini koruyarak güncelleme
Mevcut bir uygulamanın kullanıcı arayüzü katmanını ve komut dosyasını, değişkenlerin üzerine yazmadan güncellemek için dönüştürmeyi yeniden çalıştırın. --preserveTargetAppScript ile birleştirerek, hedef uygulamanın hem komut dosyasını hem de değişkenlerini bozulmadan tutun.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Qlik Cloud kimlik doğrulamasını kurun
Herhangi bir dönüştürme çalıştırmadan önce bir qlik-cli bağlamı yapılandırın. Etkileşimli kurulum, bir kiracı URL'si ve API anahtarı ister ve kimlik bilgilerini sonraki çalıştırmalar için depolar.
QV2QS.exe --setupQlikAuth
Programatik kullanım (CI/CD)
QV2QS, önceden oluşturulmuş qlik-cli bağlamları olmadan doğrudan kimlik doğrulamayı destekler. Kiracı URL'sini ve API anahtarını satır içi iletin. QV2QS kimlik bilgilerini doğrular ve her qlik-cli çağrısına kimlik doğrulama başlıklarını enjekte eder. Hiçbir bağlam dosyası oluşturulmaz veya değiştirilmez. Etkileşimli bir istem olmadan lisans sözleşmesini kabul etmek için --accept-eula ekleyin.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Bu mod, birden çok kiracı ve kullanıcı arasında eşzamanlı yürütme için güvenlidir. API anahtarı diske yazılmaz ve günlük dosyalarında görünmez.
Kimlik bilgileri ortam değişkenleri olarak da ayarlanabilir:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Qlik Cloud olmadan yerel derleme
Qlik Cloud'a bağlanmadan dönüştürülen çıktıyı ve dönüştürme raporunu diske oluşturun. Yalnızca yerel mod, geçiş değerlendirmesi, dağıtım öncesi inceleme ve çevrimdışı ortamlar için tasarlanmıştır. Yerel derleme çıktısı medya yüklemelerini, arka plan görüntüsü çözünürlüğünü, alternatif durum oluşturmayı veya sayfa yayımlamayı içermez. Tam bir dağıtım için, Qlik Cloud'a Derle veya QVF Dışa Aktar modunu kullanın. Yalnızca Yerel sınırlamaları ve kullanım senaryoları hakkında ayrıntılı bilgi için, bkz. Dönüşüm nasıl çalışır.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly