Toplu raporlama
Son güncelleme: 14.10.2026QV2QS, toplu bir çalıştırmanın ardından hem proje bazlı hem de toplu raporlar oluşturarak her düzeyde ayrıntılı dönüştürme sonuçları sağlar.
Proje bazlı raporlar
Toplu işlemdeki her proje, tek proje modundakiyle aynı şekilde ayrı bir Excel dönüştürme raporu ve bir yönetici özeti JSON dosyası alır. Bu dosyalar, her proje çıktı dizini içindeki reports/ alt klasörüne yazılır.
Toplu raporlar
QV2QS, çıktı kök dizinine aşağıdaki toplu dosyaları yazar:
batch_summary.json— Proje sayıları, başarı/başarısızlık durumu, zamanlama ve toplu KPI'ları (toplam sayfalar, nesneler, otomasyon yüzdesi) içeren makine tarafından okunabilir özet.batch_summary.html— Hızlı inceleme için bağımsız HTML raporu.batch_conversion_report_<timestamp>.xlsx— Özet sayfası, proje başına döküm ve tüm projeler genelinde birleştirilmiş nesne ayrıntıları içeren konsolide Excel çalışma kitabı.
batch_summary.json yapısı
batch_summary.json dosyası, CI/CD entegrasyonu ve programatik ayrıştırma için aşağıdaki üst düzey alanları içerir.
| Alan | Açıklama |
|---|---|
schema
|
Şema sürümü (şu anda 1). |
kind
|
Her zaman qv2qs_batch_summary. |
version
|
QV2QS sürüm dizesi. |
timestamp_utc
|
Toplu çalıştırmanın ISO 8601 zaman damgası. |
batch.total_projects
|
Keşfedilen toplam proje sayısı. |
batch.succeeded
|
Başarıyla tamamlanan proje sayısı. |
batch.failed
|
Başarısız olan proje sayısı. |
batch.wall_clock_sec
|
Saniye cinsinden geçen toplam süre. |
batch.cumulative_sec
|
Tüm bireysel proje sürelerinin toplamı. |
aggregated_kpis
|
Tüm başarılı projelerdeki toplamlar: sheets, objects_in_scope, auto, follow_up, errors, images_unique, auto_pct, follow_up_pct. |
projects
|
Proje başına girdi dizisi. Her giriş name, ok (boolean), duration_sec ve output_dir içerir. Başarılı projeler, sayfa/nesne sayılarına sahip bir summary nesnesi içerir. Başarısız projeler bir error dizesi içerir. |
exec_summaries
|
Tüm başarılı projeler için tam yönetici özeti nesneleri dizisi. |
Her bir proje için executive_summary.json dosyası aynı şemayı (kind: qv2qs_exec_summary) kullanır ve project meta verilerini, kpis (sayfalar, nesneler, otomasyon puanları, taşma sayıları), breakdowns (tür başına sonuçlar, taşma eylemleri) ve object_details (türe göre gruplandırılmış yer tutucular, hatalar, ayarlamalar) içerir. Tek proje modunda dosya, alan ve tablo sayıları, bayt boyutları ve uygulama özelliklerini içeren bir data_model bölümü de içerir. Uygulama özellikleri arasında son yeniden yükleme zamanı, pencere başlığı, bölüm erişimi durumu ve veri kökeni Bağlantı türleri yer alır. data_model bölümü, toplu mod proje başına dosyalara dahil edilmez.
kpis nesnesi aşağıdaki zamanlama alanlarını içerir:
| Alan | Açıklama |
|---|---|
kpis.duration_sec
|
Saniye cinsinden yerel dönüştürme süresi (yalnızca PRJ ayrıştırma ve JSON oluşturma). |
kpis.app_build_sec
|
Saniye cinsinden bulut uygulaması derleme süresi (qlik app build). Yalnızca bulut dağıtımı gerçekleştirildiğinde mevcuttur. |
kpis.app_build_included_reload
|
Boolean. Uygulama derleme süresi bir yeniden yükleme içeriyorsa true, aksi takdirde false. Yalnızca bulut dağıtımı gerçekleştirildiğinde mevcuttur. |
kpis.total_duration_sec
|
Saniye cinsinden uçtan uca duvar saati süresi (dönüştürme + bulut dağıtımı). Yalnızca bulut dağıtımı gerçekleştirildiğinde mevcuttur. Yalnızca yerel çalıştırmalar için duration_sec kullanın. |
Konsol çıktısı
Tüm projeler tamamlandıktan sonra konsol; toplam proje sayısı, kaç tanesinin başarılı olduğu, kaç tanesinin başarısız olduğu, geçen gerçek süre ve kümülatif işlem süresini içeren bir özet tablosu görüntüler. Başarısız olan projeler, hata iletileriyle birlikte ayrı ayrı listelenir.
Batch CLI referansı
Aşağıdaki bağımsız değişkenler toplu iş moduna özgüdür. Toplu modda da geçerli olan genel dönüştürme bağımsız değişkenleri için bkz. Bağımsız değişken başvurusu.
| Bağımsız Değişken | Açıklama | Varsayılan |
|---|---|---|
--batchDir PATH
|
QVW/QVF projelerini taramak için kök dizin (veya noktalı virgülle ayrılmış yollar). | Gerekli |
--batchWorkers N
|
Eşzamanlı olarak dönüştürülecek maksimum proje sayısı (0 = otomatik: CPU çekirdekleri eksi 1). |
0
|
--batchFlatOutput
|
Kaynak hiyerarşisini yansıtmak yerine çıktı dizini yapısını düzleştirin. | Kapalı |
--generatePrj
|
PRJ klasörü bulunmayan kaynak dosyalar için otomatik olarak PRJ klasörleri oluşturun. | Kapalı |
--qsAppName TEMPLATE
|
Qlik Cloud dağıtımı için uygulama adlandırma şablonu. {name}, {rel} ve {index} yer tutucularını destekler. |
Proje adı |