# Raportowanie wsadowe

QV2QS generuje zarówno raporty dla poszczególnych projektów, jak i raporty zbiorcze po uruchomieniu wsadowym, zapewniając szczegółowe wyniki konwersji na każdym poziomie.

## Raporty dla poszczególnych projektów

Każdy projekt w partii otrzymuje indywidualny raport konwersji w formacie Excel oraz plik JSON z podsumowaniem zarządczym, identycznie jak w trybie pojedynczego projektu. Pliki te są zapisywane w podfolderze `reports/` w każdym katalogu wyjściowym projektu.

## Raporty zagregowane

QV2QS zapisuje następujące pliki zagregowane w głównym katalogu wyjściowym:

* `batch_summary.json` — Czytelne maszynowo podsumowanie z liczbą projektów, statusem powodzenia/niepowodzenia, czasem trwania i zagregowanymi wskaźnikami KPI (łączna liczba arkuszy, obiektów, procent automatyzacji).
* `batch_summary.html` — Autonomiczny raport HTML do szybkiego przeglądu.
* `batch_conversion_report_<timestamp>.xlsx` — Skonsolidowany skoroszyt programu Excel z arkuszem podsumowania, rozbiciem na poszczególne projekty oraz połączonymi szczegółami obiektów ze wszystkich projektów.

## Struktura pliku batch\_summary.json

Plik `batch_summary.json` zawiera następujące pola najwyższego poziomu na potrzeby integracji z CI/CD i parsowania programowego.

| Pole | Opis |
| --- | --- |
| `schema` | Wersja schematu (obecnie `1`). |
| `kind` | Zawsze `qv2qs_batch_summary`. |
| `version` | Ciąg znaków wersji QV2QS. |
| `timestamp_utc` | Znacznik czasu ISO 8601 uruchomienia wsadowego. |
| `batch.total_projects` | Łączna liczba wykrytych projektów. |
| `batch.succeeded` | Liczba projektów, które zakończyły się pomyślnie. |
| `batch.failed` | Liczba projektów, które zakończyły się niepowodzeniem. |
| `batch.wall_clock_sec` | Całkowity upłynięty czas w sekundach. |
| `batch.cumulative_sec` | Suma czasów trwania wszystkich poszczególnych projektów. |
| `aggregated_kpis` | Wartości łączne dla wszystkich projektów zakończonych sukcesem: `sheets`, `objects_in_scope`, `auto`, `follow_up`, `errors`, `images_unique`, `auto_pct`, `follow_up_pct`. |
| `projects` | Tablica wpisów dla poszczególnych projektów. Każdy wpis zawiera `name`, `ok` (wartość logiczna), `duration_sec` oraz `output_dir`. Projekty zakończone powodzeniem zawierają obiekt `summary` z liczbą arkuszy/obiektów. Nieudane projekty zawierają ciąg znaków `error`. |
| `exec_summaries` | Tablica pełnych obiektów podsumowania zarządczego dla wszystkich projektów zakończonych sukcesem. |

Plik `executive_summary.json` dla każdego pojedynczego projektu używa tego samego schematu (`kind: qv2qs_exec_summary`) i zawiera metadane `project`, `kpis` (arkusze, obiekty, wyniki automatyzacji, liczby przepełnień), `breakdowns` (wyniki dla poszczególnych typów, akcje przepełnienia) oraz `object_details` (symbole zastępcze, błędy, korekty pogrupowane według typu). W trybie pojedynczego projektu plik zawiera również sekcję `data_model` z liczbą pól i tabel, rozmiarami w bajtach oraz właściwościami aplikacji. Właściwości aplikacji obejmują czas ostatniego przeładowania, tytuł okna, stan sekcji dostępu oraz typy połączeń pochodzenia danych. Sekcja `data_model` nie jest uwzględniona w plikach dla poszczególnych projektów w trybie wsadowym.

Obiekt `kpis` zawiera następujące pola czasowe:

| Pole | Opis |
| --- | --- |
| `kpis.duration_sec` | Czas trwania lokalnej konwersji w sekundach (tylko parsowanie PRJ i generowanie JSON). |
| `kpis.app_build_sec` | Czas trwania kompilacji aplikacji w chmurze w sekundach (`qlik app build`). Widoczne tylko wtedy, gdy przeprowadzono wdrożenie w chmurze. |
| `kpis.app_build_included_reload` | Wartość logiczna. `true`, jeśli czas kompilacji aplikacji obejmuje przeładowanie, w przeciwnym razie `false`. Widoczne tylko wtedy, gdy przeprowadzono wdrożenie w chmurze. |
| `kpis.total_duration_sec` | Czas zegarowy od początku do końca w sekundach (konwersja + wdrożenie w chmurze). Widoczne tylko wtedy, gdy przeprowadzono wdrożenie w chmurze. W przypadku uruchomień wyłącznie lokalnych użyj `duration_sec`. |

## Dane wyjściowe konsoli

Po ukończeniu wszystkich projektów w konsoli wyświetlana jest tabela podsumowująca zawierająca łączną liczbę projektów, liczbę projektów zakończonych powodzeniem, liczbę projektów zakończonych niepowodzeniem, czas rzeczywisty oraz łączny czas przetwarzania. Projekty zakończone niepowodzeniem są wymienione pojedynczo wraz z komunikatami o błędach.

## Dokumentacja referencyjna interfejsu wiersza polecenia usługi Batch

Poniższe argumenty są specyficzne dla trybu wsadowego. Informacje o ogólnych argumentach konwersji, które mają zastosowanie również w trybie wsadowym, można znaleźć w sekcji [Dokumentacja argumentów](https://help.qlik.com/pl-PL/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

| Argument | Opis | Domyślny |
| --- | --- | --- |
| `--batchDir PATH` | Katalog główny (lub ścieżki rozdzielone średnikami) do przeskanowania pod kątem projektów QVW/QVF. | Wymagane pole |
| `--batchWorkers N` | Maksymalna liczba projektów konwertowanych jednocześnie (`0` = automatycznie: liczba rdzeni procesora minus 1). | `0` |
| `--batchFlatOutput` | Spłaszcz strukturę katalogów wyjściowych, zamiast odzwierciedlać hierarchię źródłową. | Wyłączone |
| `--generatePrj` | Automatycznie generuj foldery PRJ dla plików źródłowych, które go nie mają. | Wyłączone |
| `--qsAppName TEMPLATE` | Szablon nazewnictwa aplikacji dla wdrożenia Qlik Cloud. Obsługuje symbole zastępcze `{name}`, `{rel}` i `{index}`. | Nazwa projektu |

## Dowiedz się więcej

* [Struktura wyjściowa i nazewnictwo aplikacji](https://help.qlik.com/pl-PL/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [Raport konwersji](https://help.qlik.com/pl-PL/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [Pulpit podsumowania dla kadry zarządzającej](https://help.qlik.com/pl-PL/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)