# Toplu raporlama

QV2QS, 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](https://help.qlik.com/tr-TR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

| 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ı |

## Daha fazla bilgi edinin

* [Çıktı yapısı ve uygulama adlandırması](https://help.qlik.com/tr-TR/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [Dönüşüm raporu](https://help.qlik.com/tr-TR/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [Yönetici özeti gösterge paneli](https://help.qlik.com/tr-TR/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)