Raportowanie wsadowe
Ostatnia aktualizacja: 14.10.2026QV2QS 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.
| 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 |