Dönüşüm nasıl çalışır

Son güncelleme: 14.10.2026

Dönüştürme İşlem hattı aşağıdaki aşamalara sahiptir:

• Ayıkla — Eğer --generatePrj etkinse, QV2QS, QVW dosyasını bir PRJ klasörüne ayıklamak için QlikView Desktop'ı başlatır. QV2QS, QlikView Desktop'ın bir sistem kurulumu algılanmadıkça, paketlenmiş taşınabilir motoru kullanır. Ayrıntılar için bkz. QlikView Desktop motoru.
• Ayrıştır — QV2QS, PRJ klasörünü okur ve her nesne tanımını, sayfa düzenini, komut dosyasını, değişkeni ve belge özelliğini ayrıştırır. QV2QS ayrıca QVW/QVF ikili dosyasını doğrudan okuyarak meta verileri, değişkenleri ve dosyaya gömülü gizli komut dosyasını çıkarır.
• Dönüştür — Her QlikView nesnesi, bir Qlik Sense görselleştirme türü ile eşlenir. Boyutlar, ölçümler, ifadeler, stil ve düzen konumları Qlik Sense JSON biçimine çevrilir.
• Yazma — QV2QS, dönüştürülmüş uygulama yapısını bir dizi JSON dosyası olarak çıktı klasörüne yazar.
• Dağıt (yalnızca bulut modları) — QV2QS, kiracıda uygulamayı oluşturur, medyayı yükler, uygulamayı inşa eder ve isteğe bağlı olarak uygulamayı verilerle yeniden yükler.
• Rapor — QV2QS, sonuçları, otomasyon puanlamasını ve manuel takip gerektiren tüm öğeleri özetleyen bir dönüşüm raporu oluşturur.

Dağıtım aşaması, Qlik Cloud'a Derleme ve QVF Dışa Aktarma modlarında çalışır. Yalnızca Yerel modda, QV2QS dönüştürülen çıktıyı Qlik Cloud'a bağlanmadan diske yazar. Rapor aşaması tüm modlarda çalışır.

Dönüştürme modları

QV2QS üç dönüştürme modunu destekler. Modu, sihirbazın Kurulum adımında veya ilgili CLI bayrağıyla seçin.

Qlik Cloud'a Derleme, geçiş için önerilen moddur. QVF Dışa Aktarma, paylaşmak veya farklı bir kiracıya içe aktarmak için taşınabilir bir dosya oluşturmada kullanışlıdır. Yalnızca yerel mod, değerlendirme ve inceleme için tasarlanmıştır. Yalnızca Yerel sınırlamaları hakkında ayrıntılar için aşağıdaki bölüme bakın.

Yalnızca yerel mod

Yalnızca yerel mod (--unbuildOnly) Ayrıştırma, Dönüştürme, Yazma ve Raporlama aşamalarını Qlik Cloud'a bağlanmadan gerçekleştirir. Kiracı veya API anahtarı gerekli değildir. QV2QS tam dönüşüm raporunu, yönetici özetini ve derleme çıktı klasörünü diske oluşturur.

Kullanım durumları

• Geçiş değerlendirmesi — Dönüşüm raporunu, yönetici özetini, otomasyon puanını ve ifade bulgularını Qlik Cloud erişimi gerektirmeden oluşturmak için Yalnızca Yerel modunu çalıştırın. Kiracı kimlik bilgilerini kurmadan önce, tüm bir QVW ortamındaki dönüşüm kalitesini değerlendirin.
• Dağıtım Öncesi İnceleme — Bir bulut dağıtımı gerçekleştirmeden önce oluşturulan çıktıyı (komut dosyası, nesne tanımları, değişkenler, boyutlar) inceleyin. Değişiklik kontrol süreçlerine sahip kuruluşlar, çıktıyı ara bir yapıt olarak inceleyebilir.
• Çevrimdışı veya kısıtlı ortamlar — QVW dosyalarını barındıran makine giden internet erişimine sahip olmadığında, dönüştürme raporunu yerel olarak oluşturmak için Yalnızca Yerel modunu çalıştırın. Dönüştürülen uygulamayı dağıtmak için, QVW dosyalarını Qlik Cloud erişimi olan bir makineye kopyalayın ve bağlı makineden QV2QS'i Qlik Cloud'a Oluşturma modunda çalıştırın.

Sınırlamalar

Dağıtım aşaması, qlik app build tek başına gerçekleştirmediği çeşitli operasyonları ele alır. Yalnızca Yerel modu çalıştırmak ve ardından build/ klasörünü bağımsız bir qlik-cli kurulumu ile manuel olarak dağıtmak aşağıdaki eksikliklere neden olur.

• Medya dosyaları yüklenmedi. Arka plan resimleri ve düğme resimleri images/ klasörüne çıkarılır ancak build/ klasörüne dahil edilmez. qlik app build komutu medya dosyalarını işlemez. Tüm arka plan görselleri ve düğme görselleri, dağıtılan uygulamadan eksik olacak.
• Sayfa ve nesne arka plan referansları çözümlenmedi. QV2QS, Dağıtım aşamasında bulut uygulama kimliğini kullanarak arka plan resmi URL'lerini sayfa ve nesne JSON dosyalarına enjekte eder. Yerel derleme çıktısı, arka plan resmi referansları içermiyor. Sayfalar ve nesneler dağıtılan uygulamada arka planları olmayacak.
• Düğme görseli URL'leri yer tutucu dizeler içerir. Yerel derleme çıktısındaki düğme görselleri, çözümlenmiş medya URL'leri yerine dahili yer tutucu değerleri kullanır. Qlik Sense motoru yer tutucu dizelerini yorumlayamaz. Düğme resimleri bozuk görünecektir.
• Alternatif durumlar oluşturulmaz. Alternatif durum adları, cloud/alternate_states.json build/ klasörünün dışına yazılır. qlik app build komutu alternatif durumları işlemez. Varsayılan olmayan durumları referans alan nesneler doğru görüntülenmeyebilir.
• Sayfalar yayınlanmadı. qlik app build komutu, yalnızca uygulama sahibine görünür kişisel nesneler olarak sayfalar oluşturur. QV2QS, Dağıtım aşamasında çalışma sayfalarını temel sayfalar olarak yayımlar. Paylaşılan bir alanda, sayfalar manuel olarak yayımlanana kadar diğer kullanıcılar hiçbir sayfayı göremez.

Kaynak dosya güvenliği

QV2QS kaynak QVW veya QVF dosyasının içeriğini değiştirmez. Ayıklama aşamasında, QV2QS kaynak belgeyi QlikView Desktop aracılığıyla açar ve geçici bir kopyasını bir sistem geçici klasörüne kaydeder. QV2QS ardından orijinali kapatır ve PRJ klasörünü geçici kopyadan oluşturur. PRJ oluşturma tamamlandıktan sonra, QV2QS, ortaya çıkan -prj klasörünü kaynak dosya ile aynı dizine geri kopyalar ve geçici kopyayı siler. Eğer kaynak dosyanın yanında zaten bir -prj klasörü varsa, QV2QS klasörü yeni oluşturulan sürümle değiştirir. Diğer tüm dönüştürme çıktıları, --outputDir tarafından belirtilen ayrı çıktı dizinine yazılır.

QlikView Desktop, geçici kopya oluşturulurken kaynak belge üzerinde bir dosya kilidi edinir. QlikView Desktop'ta etkin olarak açık olan veya QlikView Server tarafından sunulan bir dosyaya karşı QV2QS çalıştırmak, dosya kilitleme çakışmalarına veya başarısız PRJ oluşturmaya neden olabilir. Paylaşılan ağ sürücülerindeki dosyalar da aynı çakışmalara neden olabilir. Klasörü -prj bir ağ paylaşımına veya salt okunur bir dizine geri yazma işlemi de başarısız olabilir.

Üretim ortamlarında herhangi bir riski önlemek için, her zaman kaynak belgelerin kopyalarıyla çalışın. Aşağıdakileri yapın:

1. QVW veya QVF dosyalarını, QV2QS'nin çalıştığı makinedeki yerel bir çalışma klasörüne kopyalayın.
2. QV2QS'i kopyalanan dosyalara yönlendirin, orijinallere değil.
3. Dönüştürme işlemine başlamadan önce çalışan tüm QlikView Desktop örneklerini kapatın. QV2QS QlikView Desktop'a özel erişim gerektirir.

Tipik zamanlama

QV2QS hız için tasarlanmıştır. Tam İşlem hattı dakikalar içinde tamamlanır, saatler değil. Aşağıdaki tablo, tek uygulamalı bir dönüşüm için tipik süreleri göstermektedir.

Tek bir uygulama dönüştürme, bulut dağıtımı ve veri yeniden yüklemesi ile uçtan uca genellikle iki ila beş dakika içinde tamamlanır. Yalnızca yerel dönüşümler (--unbuildOnly) 30 saniyenin altında tamamlanır.

Toplu modda, QV2QS birden çok projeyi paralel olarak dönüştürür. Toplam toplu işlem süresi, proje sayısının çalışan sayısına bölünmesiyle ölçeklenir. 20 uygulamanın dört çalışanla işlenmesi için, yerel dönüştürme aşaması için tek uygulamanın süresinin yaklaşık beş katını, artı bulut dağıtım süresini bekleyin.

Çıktı klasör yapısı

--outputDir bağımsız değişkeni çıktı kökünü belirtir. QV2QS, çıktı kök dizininin içinde, QVW dosyası (veya PRJ klasörü) adını taşıyan bir alt klasör oluşturur. Projenin tüm dönüştürme çıktıları o alt klasöre yazılmaktadır. İki QVW dosyası aynı ada sahipse, QV2QS çakışmaları önlemek için _2, _3 ve sonraki sayıları ekler. Bu davranış, her projenin özel bir alt klasör aldığı toplu iş moduna uyar.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS, çıktı klasörünü, klasör zaten mevcut değilse oluşturur. Aynı QVW'nin önceki bir çalıştırmasından klasör mevcutsa, QV2QS klasörü yeniden kullanır. Klasördeki mevcut günlük dosyaları, Günlükleri Temizle etkinleştirilmediği sürece korunur. Çıkış dizini, herhangi bir kaynak diziniyle aynı veya onun üst dizini olmamalıdır. QV2QS dönüştürme başlamadan önce çıkış yolunu doğrular ve yollar çakışıyorsa bir hata bildirir. Proje alt klasörü aşağıdakileri içerir:

Dönüştürme işleminden sonra

Bir dönüştürme tamamlandıktan sonra, önceliğe göre gruplandırılmış aşağıdaki öğeleri gözden geçirin.

Yayınlamadan önce düzelt

1. Excel dönüştürme raporunu reports/ alt klasöründe açın ve Follow-up_Objects çalışma sayfasını inceleyin. Öncelikle Hata olarak işaretlenmiş tüm öğeleri (dönüştürülemeyen nesneler) düzeltin, ardından Yer Tutucu (yeniden oluşturulması gereken nesneler), ardından Ayarlama Gerekiyor (kısmen dönüştürülen nesneler).
2. Makro referansları, Bölüm Erişimi kullanımı ve manuel dikkat gerektirebilecek komut dosyası desenleri dahil olmak üzere, Analiz çalışma sayfasındaki analiz bulgularını inceleyin.
3. İfadelerin doğru şekilde değerlendirildiğini doğrulayın. QV2QS dönüştürme sırasında küme analizi alıntı sorunlarını otomatik olarak düzeltir. Hesaplanmış boyutları, koşullu renklendirmeyi ve el ile yeniden yazma gerektiren QlikView'e özgü işlevleri kullanan ifadeleri gözden geçirin (GetCurrentField(), MsgBox()).
4. Fazla boyutların veya ölçülerin alternatifler koleksiyonuna taşındığı nesneler için Overflow_Actions çalışma sayfasını kontrol edin.

Yayınlamadan önce doğrulayın

5. Dönüştürülen uygulamayı Qlik Sense'te açın ve sayfa düzenlerinin, nesne konumlarının ve arka plan görüntülerinin beklendiği gibi göründüğünü doğrulayın.
6. Sekme kapsayıcı gezinmesinin (düğme şeritleri veya sekmeli kapsayıcılar) içerik alanları arasında doğru şekilde geçiş yaptığını doğrulayın.
7. Boyut grupları kullanan grafiklerde detaya inme ve döngüsel grup döngü davranışını test edin.
8. Gösterim koşullarının nesneleri beklendiği gibi gizleyip gösterdiğini doğrulayın.
9. Liste kutularında ve tablolarda, özellikle tarih benzeri alanlar için sıralama düzenlerini kontrol edin.

Lehçe

10. Yazı tiplerini, renkleri veya nesne konumlandırmasını Qlik Sense uygulama düzenleyicisinde gerektiği gibi ayarlayın. Düzen konumlandırması hakkında rehberlik için, bakınız Dönüştürme düzeni ayarları.

Rapor içeriğinin eksiksiz açıklaması için, bkz. Dönüşüm raporu.

Daha fazla bilgi edinin

• Hızlı başlangıç
• Kullanıcı arayüzü
• Komut satırı arayüzü
• Dönüştürme düzen ayarları
• Dönüşüm sonuçları