37. Raport zbiorczy i zestawienia
Składanie wszystkich kart zlecenia w jeden PDF ze stroną tytułową, spisem treści i numeracją załączników („Raport zbiorczy”) oraz zestawienia XLSX, kontrola poprawności danych i importy zbiorcze – szablon otworów, pliki CSV/XLSX, GeoStar („Zestawienia”).
W aplikacji: Raport zbiorczy; Zestawienia
Wstęp
Ten rozdział opisuje dwa moduły, które zbierają dane całego zlecenia:
- „Raport zbiorczy” – składa jeden plik PDF z kart wszystkich modułów: strona tytułowa, spis treści z numerami stron, rozdziały z kartami badań i obliczeń, numery załączników w postaci „rozdział.kolejny” (np. „Zał. 3.2”). To odpowiednik „rapport factuel” z programu SoilCloud i wydruku całej dokumentacji z GIMSGEO.
- „Zestawienia” – tabelaryczne raporty do arkusza kalkulacyjnego (XLSX), statystyka liczby i długości badań, kontrola poprawności danych oraz narzędzia importu zbiorczego: zwrotne wczytanie uzupełnionego zestawienia, otwory z szablonu XLSX, import otworów z dowolnego pliku CSV/XLSX, import z programu GeoStar, uzupełnianie i przekodowanie wartości w warstwach. Odpowiada częściom „Generowanie raportów” oraz „Import i zamiana danych” GIMSGEO.
Oba moduły nie mają własnych danych – czytają otwory, sondowania, próbki i rekordy obliczeń zlecenia. Raport zbiorczy używa tych samych kart (szablonów, skal, opcji) co generatory w poszczególnych modułach; ustawienia kart zmieniasz w modułach (patrz Generator kart).
Raport zbiorczy
Układ ekranu

- „Tytuł” – tytuł na stronie tytułowej. Domyślnie „Dokumentacja badań podłoża gruntowego” (w języku angielskim „Ground investigation report”). Jeśli zostawisz tytuł domyślny, zmieni się sam po zmianie języka raportu; tytuł własny pozostaje bez zmian.
- „Podtytuł” – druga linia strony tytułowej (np. nazwa obiektu). Podpowiedź w pustym polu to nazwa projektu zlecenia, ale pusty podtytuł nie jest drukowany.
- „Opracował” – autor dokumentacji; na stronie tytułowej w wierszu „Opracował” („Prepared by”).
- „Miejscowość” – domyślnie miejscowość z danych zlecenia; drukowana u dołu strony tytułowej.
- „Data” – domyślnie dzisiejsza; drukowana obok miejscowości („Warszawa, 2026-11-17”).
- „Język raportu” – „Polski” albo „English”. Domyślnie język dokumentacji zlecenia. Język dotyczy kart, strony tytułowej, spisu treści i tytułów rozdziałów. Sprawozdania laboratoryjne i przekroje pozostają po polsku.
- „Uwagi na stronie tytułowej” – dowolny tekst (z podziałami wierszy) drukowany pod tabelą strony tytułowej.
- Licznik – „44 kart w 21 rozdziałach”: liczba kart i rozdziałów, które trafią do raportu.
Pola tekstowe są zapisywane po opuszczeniu pola (kliknięciu poza nim). Ustawienia raportu – pola, kolejność i wyłączone rozdziały – są zapisywane w zleceniu, więc widzą je wszyscy członkowie zespołu.
Rozdziały

- Pole wyboru rozdziału – włącza lub wyłącza rozdział w raporcie.
- Numer rozdziału – numer w raporcie; nadawany tylko rozdziałom włączonym i niepustym, kolejno bez luk.
- Tytuł rozdziału – tytuł karty modułu (w raporcie angielskim – tytuł angielski).
- Liczba kart – liczba pozycji w rozdziale.
- „W górę” – przesuwa rozdział o jedno miejsce wyżej.
- „W dół” – przesuwa rozdział o jedno miejsce niżej.
- Rozdział pusty – rozdział bez kart (liczba 0) ma nieaktywne, odznaczone pole wyboru i szary tytuł; nie trafia do raportu.
Domyślna kolejność rozdziałów:
| Lp. | Rozdział (tytuł PL) | Tytuł EN | Co zawiera | Moduł |
|---|---|---|---|---|
| 1 | „Karty otworów” | Borehole logs | karty wszystkich otworów | Otwory |
| 2 | „Sondowania dynamiczne (DP)” | Dynamic probing (DP) | karty sondowań DP z wynikami (bez pustych) | Sondowania DP |
| 3 | „Karta CPT” | CPT log | Sondowania CPT | |
| 4 | „Karta DMT” | DMT log | Sondowania DMT | |
| 5 | „Wyniki FVT” | FVT results | Sondowania FVT | |
| 6 | „Wyniki VSS” | Static plate load test (VSS) results | Badania płytowe | |
| 7 | „Wyniki LPD” | Light dynamic plate test (LPD) results | Badania płytowe | |
| 8 | „Krzywa uziarnienia” | Particle size distribution curve | Krzywa uziarnienia | |
| 9 | „Karta badania – badania podstawowe” | Laboratory test sheet – basic properties | Badania podstawowe | |
| 10 | „Karta badania – granice Atterberga” | … – Atterberg limits | Granice Atterberga | |
| 11 | „Karta badania – badanie makroskopowe” | … – macroscopic examination | Badanie makroskopowe | |
| 12 | „Karta badania – badanie trójosiowe” | … – triaxial test | Badanie trójosiowe | |
| 13 | „Przekrój geotechniczny” | Geotechnical cross-section | Przekroje geotechniczne | |
| 14 | „Przekrój geodezyjny” | Survey cross-section | Przekroje geodezyjne | |
| 15 | „Rysunek punktów” | Test location plan | rysunki mapy | Punkty na mapę |
| 16 | „Profile parametrów” | Parameter profiles | Profile parametrów | |
| 17 | „Statystyka” | Statistics | Statystyka | |
| 18 | „Nośność fundamentu” | Foundation bearing capacity | Nośność fundamentu | |
| 19 | „Nośność pala” | Pile bearing capacity | Pale LCPC | |
| 20 | „Próbne pompowanie” | Pumping test | Próbne pompowania | |
| 21 | „Migracja zanieczyszczeń” | Contaminant migration | Migracja zanieczyszczeń | |
| 22 | „Monitoring geodezyjny” | Survey monitoring | Monitoring geodezyjny | |
| 23 | „Inklinometr” | Inclinometer | Inklinometry |
W rozdziale pozycje są sortowane po nazwie w porządku naturalnym (P-2 przed P-10). Rekordy, dla których moduł nie może jeszcze wygenerować karty (np. obliczenie bez wyników), są pomijane.
Generowanie PDF

- „Generuj raport zbiorczy (PDF)” – składa i pobiera raport. Przycisk jest nieaktywny, gdy żaden rozdział nie ma kart.
Generowanie przebiega w dwóch fazach (napis na przycisku zmienia się):
- „Układanie stron…” – aplikacja rysuje w tle wszystkie karty i liczy, ile stron ma każda z nich. Karty, które nie dały żadnej strony (np. brak danych do karty), oraz rozdziały bez stron są pomijane – numeracja rozdziałów i załączników jest nadawana od nowa, bez luk.
- „Generowanie PDF…” – rysuje stronę tytułową, spis treści i karty z ostatecznymi numerami załączników, czeka na wczytanie obrazów (np. podkładów map WMS) i zapisuje PDF.
Plik ma nazwę raport_zbiorczy_<nazwa zlecenia>_<data>.pdf. Po zakończeniu pojawia się komunikat „Raport zbiorczy: N stron”, a przy błędzie – „Nie udało się wygenerować raportu”.
Zawartość raportu:
| Część | Zawartość |
|---|---|
| Strona tytułowa (A4) | tytuł, podtytuł, tabela: „Obiekt / zlecenie” (nazwa projektu), „Inwestor”, „Zleceniodawca” (z danych zlecenia), „Opracował”; uwagi; u dołu miejscowość i data. Wiersze bez wartości są pomijane. |
| Spis treści (A4, 42 wiersze na stronę) | dla każdego rozdziału: numer, tytuł i strona początkowa (pogrubione); pod nim pozycje: „Zał. 3.1”, nazwa badania, numer strony. W języku angielskim „Contents” i „App.”. |
| Rozdziały | karty w kolejności rozdziałów; każda karta ma numer załącznika „rozdział.kolejny” (w miejscu numeru załącznika na karcie) |
Numeracja stron: strona tytułowa ma numer 1, potem strony spisu treści; pierwsza karta zaczyna się od strony 2 + liczba stron spisu treści. Karta wielostronicowa (np. długi otwór) zajmuje kolejne strony; w spisie podawana jest strona jej początku.
Uwaga. PDF jest składany w przeglądarce ze zrzutów stron (obraz o wysokiej rozdzielczości, przy ponad 6 stronach rozdzielczość jest nieco obniżana). Tekstu w pliku nie da się zaznaczać ani przeszukiwać. Raport z kilkudziesięcioma kartami może się generować kilka minut – nie zamykaj karty przeglądarki.
Zestawienia
Układ ekranu

- „Statystyki projektu” – tabela liczby i łącznej długości badań: kolumny „Zakres”, „Otwory”, „DP”, „CPT”, „DMT” (w formacie „4 szt. · 15.6 m”) i „Próbki gruntu / wody”. Wiersz „Całe zlecenie” oraz po jednym wierszu „Grupa: …” dla każdej grupy danych zlecenia.
- „Zestawienia XLSX” – karta pobierania zestawień (patrz niżej).
Niżej na stronie są kolejno karty: „Poprawność danych”, „Uzupełnianie danych z zestawienia”, „Otwory z szablonu XLSX”, „Import otworów z pliku (CSV, XLSX)”, „Import z GeoStara (CSV)”, „Uzupełnij warstwy z pliku” i „Przekoduj wartości w warstwach”.
Długość badania w statystyce: otwór – głębokość spągu ostatniej warstwy, DP – głębokość z liczby przedziałów, CPT/DMT – największa głębokość pomiaru.
Zestawienia XLSX

- Kafelek zestawienia – kliknięcie pobiera jeden arkusz XLSX (opis pod tytułem mówi, co zawiera).
- „Zestawienie z bieżącego filtrowania:” – lista „Wszystkie badania” albo „Grupa: …” (grupy danych zlecenia).
- „Pobierz” – pobiera zestawienie BH+DP+CPT+DMT ograniczone do wybranej grupy (arkusz „Filtrowanie”, plik
zestawienie_filtr_…xlsx). - „Wszystkie w jednym pliku” – jeden plik
zestawienia_wszystkie_…xlsxz wszystkimi jedenastoma arkuszami.
Pliki mają nazwy <prefiks>_<nazwa projektu>_<data>.xlsx. Rodzaje zestawień:
| Kafelek | Arkusz | Kolumny | Plik |
|---|---|---|---|
| „Zestawienie otworów wiertniczych” | „Otwory” | „Nr otworu”, „Data”, „Rzędna”, „X”, „Y”, „Kilometraż”, „Operator”, „Nadzór”, „System wiercenia”, „Typ wiertnicy”, „Gmina”, „Powiat”, „Województwo”, „Uwagi”, „Głębokość [m]”, „Liczba warstw”, „Próbki gruntu”, „Próbki wody” | zestawienie_otworow |
| „Zestawienie próbek gruntu” | „Próbki gruntu” | „Otwór”, „Data”, „Rodzaj próbki”, „Głębokość od [m]”, „Głębokość do [m]” (z danych próbek zapisanych w otworach) | zestawienie_probek_gruntu |
| „Zestawienie próbek wody” | „Próbki wody” | „Próbka”, „Otwór”, „Głębokość [m]”, „Data”, „Opis”, „Wyniki analiz” – próbki z rejestru „Próbki wody” i z otworów | zestawienie_probek_wody |
| „Zestawienie sondowań DP” | „Sondowania DP” | „Nr badania”, „Rodzaj”, „Data”, „Rzędna”, „X”, „Y”, „Kilometraż”, „Operator”, „Nadzór”, „Typ sondy / systemu”, „Gmina”, „Powiat”, „Województwo”, „Uwagi”, „Głębokość [m]” | zestawienie_DP |
| „Zestawienie sondowań CPT” | „Sondowania CPT” | jak DP | zestawienie_CPT |
| „Zestawienie sondowań DMT” | „Sondowania DMT” | jak DP | zestawienie_DMT |
| „Zestawienie BH+DP+CPT+DMT” | „BH+DP+CPT+DMT” | „Nr badania”, „Rodzaj” (Otwór, DP (typ sondy), CPT, DMT), „Data”, „Rzędna”, „X”, „Y”, „Kilometraż”, „Głębokość [m]” | zestawienie_badan |
| „Zestawienie otworów – pełne” | „Otwory – pełne” | „Otwór”, „Data”, „Rzędna”, „X”, „Y”, „Strop [m]”, „Spąg [m]”, „Symbol”, „Rodzaj gruntu”, „Barwa”, „Wilgotność”, „Stan”, „Warstwa”, „Zwierciadło wody” – jeden wiersz na warstwę | zestawienie_otworow_pelne |
| „Warstwy geotechniczne” | „Warstwy geotechniczne” | „Warstwa”, „Grunty”, „Stany”, „Od [m]”, „Do [m]” i kolumna dla każdego parametru z jednostką | warstwy_geotechniczne |
| „Statystyki projektu” | „Statystyki” | „Zakres”, „Otwory [szt.]”, „Otwory [m]”, „DP [szt.]”, „DP [m]”, „CPT [szt.]”, „CPT [m]”, „DMT [szt.]”, „DMT [m]”, „Próbki gruntu”, „Próbki wody” | statystyki_projektu |
| „Poprawność danych” | „Poprawność danych” | „Badanie”, „Rodzaj”, „Element”, „Status”, „Opis” | poprawnosc_danych |
Głębokości są zaokrąglane do 0,01 m. Otwór wirtualny ma w zestawieniu otworów dopisek jak na karcie.
Poprawność danych

- Licznik – „N błędów · N ostrzeżeń” (czerwony, gdy są błędy).
- „Pokaż wszystkie sprawdzenia” – przełącznik: wyłączony pokazuje tylko błędy i ostrzeżenia („błąd”, „opis”), włączony – wszystkie sprawdzenia, także „ok” i „-”.
- Tabela – kolumny: badanie, rodzaj, element, status, opis. Gdy nie ma problemów: „Nie znaleziono problemów.”.
Statusy: „-” – brak danych, „ok” – poprawne, „opis” – możliwy błąd (ostrzeżenie), „błąd” – do poprawy. Sprawdzenia (z src/lib/reports.ts):
| Rodzaj | Element | Status | Opis w tabeli |
|---|---|---|---|
| Otwór | „Rzędna”, „X”, „Y” | „-” | „brak” (puste albo 0) |
| Otwór | „Rzędna”, „X”, „Y” | „błąd” | „przecinek zamiast kropki” |
| Otwór | „Warstwy” | „błąd” | „brak warstw z symbolem gruntu” |
| Otwór | „Koniec otworu” | „opis” | „brak wiersza z głębokością końca otworu” |
| Otwór | „Głębokości warstw” | „błąd” | „N wierszy z głębokością mniejszą niż poprzednia” |
| Otwór | „Symbol „…”” | „opis” | „symbol spoza słownika – brak szrafury” |
| Otwór | pola tekstu GIMSGEO: waterSamples, soilSamples, stratigraphy, rqd, spt, piezometer, construction, weathering, rockMass | „błąd” / „ok” | treść błędu składni pola |
| Otwór | „Zwierciadło” | „opis” | „zwierciadło N m poniżej dna otworu” |
| DP | „Rzędna” | „-” | „brak” |
| DP | „Wartości N” | „błąd” | „brak pomiarów” / „wartości ujemne lub niepoprawne” |
| DP | „Wartości N” | „opis” | „N > 100 – sprawdź zapis” |
| CPT, DMT, FVT | „Pomiary” | „błąd” | „brak pomiarów” |
| CPT, DMT, FVT | „Głębokości” | „błąd” | „głębokości nie rosną” |
| CPT | „qc” | „opis” | „qc > 100 MPa – czy wpisano kPa?” |
| CPT, DMT, FVT | „Rzędna” | „-” | „brak” |
Pełniejsza kontrola kompletności (z przejściem do edycji) jest w module „Weryfikacja danych” – patrz Legenda i weryfikacja.
Uzupełnianie danych z zestawienia
Zwrotny import zestawienia: pobierasz „Zestawienie otworów wiertniczych” (albo DP, CPT, DMT, BH+DP+CPT+DMT), uzupełniasz w Excelu brakujące rzędne, daty, operatorów itd. i wczytujesz plik z powrotem.

- „Tylko puste (nie nadpisuj istniejących wartości)” – domyślnie zaznaczone: wpisuje wartości tylko w puste pola (pole z wartością 0 też jest traktowane jako puste). Odznaczone – nadpisuje wartości, także pustymi komórkami.
- „Wczytaj XLSX” – wybór pliku
.xlsx.
Zasady wczytywania:
- pierwszy wiersz arkusza to nagłówki; kolumna z nazwą musi mieć nagłówek „Nr otworu” albo „Nr badania”;
- badania są dopasowywane po nazwie (bez rozróżniania wielkości liter) – wśród otworów, sondowań DP, CPT i DMT; nieznane nazwy są pomijane i wymienione w komunikacie;
- wczytywane są kolumny: „Data” (rrrr-mm-dd, dd.mm.rrrr albo data Excela), „Rzędna”, „X”, „Y” (liczby z kropką lub przecinkiem), „Kilometraż”, „Operator”, „Nadzór”, „System wiercenia”, „Typ wiertnicy”, „Typ sondy / systemu”, „Gmina”, „Powiat”, „Województwo”, „Uwagi”; pozostałe kolumny (np. „Głębokość [m]”, „Liczba warstw”) są ignorowane.
Komunikat: „Zaktualizowano N badań; pominięto nieznane: …”. Przy błędzie pliku: „Nie udało się wczytać pliku”.
Otwory z szablonu XLSX
Masowe wprowadzanie otworów z warstwami przygotowanymi w arkuszu (odpowiednik „Materiały → Pliki do pobrania” w GIMSGEO).

- „Pobierz szablon” – plik
szablon_otworow.xlsxz arkuszem „Otwory” i przykładowym otworem P-10. - „Wczytaj wypełniony szablon” – wczytuje plik
.xlsxi tworzy otwory.
Kolumny szablonu: „Otwór”, „Data (rrrr-mm-dd)”, „Rzędna”, „X”, „Y”, „Od [m]”, „Symbol”, „Barwa”, „Wilgotność”, „Stan”, „Warstwa”. Zasady:
- jeden wiersz = jedna warstwa, opisana głębokością stropu „Od [m]”;
- wiersze z tą samą nazwą otworu tworzą jeden otwór; datę, rzędną i współrzędne bierze się z pierwszego wiersza, w którym są wypełnione;
- wiersz z samą głębokością (bez symbolu) kończy otwór – to głębokość dna;
- otwory o nazwach już istniejących w zleceniu są pomijane;
- kolumny są rozpoznawane po początku nagłówka (np. „Data” pasuje do „Data (rrrr-mm-dd)”); wymagane są „Otwór” i „Od [m]”.
Przykład z szablonu:
| Otwór | Data (rrrr-mm-dd) | Rzędna | X | Y | Od [m] | Symbol | Barwa | Wilgotność | Stan | Warstwa |
|---|---|---|---|---|---|---|---|---|---|---|
| P-10 | 2026-11-04 | 98.5 | 52.1935 | 21.0125 | 0 | h | cz | w | I | |
| P-10 | 0.3 | p+z | z | mw | szg | II | ||||
| P-10 | 2.1 | gp | br | w | tpl | III | ||||
| P-10 | 4.0 |
Komunikaty: „Utworzono N otworów (pominięto M istniejących)”; ostrzeżenia o wierszach bez głębokości („Wiersz N: brak głębokości „Od””, do 3 naraz); „Brak kolumn „Otwór” i „Od [m]” – użyj szablonu”; „Nie udało się wczytać szablonu”.
Import otworów z pliku (CSV, XLSX)
Import otworów z dowolnego pliku – z innego programu, od wiertacza, z arkusza – z ręcznym przypisaniem kolumn. Karta ma przycisk „Wczytaj plik” (pliki .csv, .txt, .xlsx); po wybraniu pliku otwiera się okno „Import otworów z pliku”.

- „Pomiń wierszy od góry” – liczba wierszy pomijanych przed nagłówkiem (np. tytuł arkusza).
- „Kodowanie” (tylko CSV) – „Automatycznie”, „UTF-8”, „Windows-1250 (CP1250)”, „Windows-1252 (CP1252)”. W trybie automatycznym obok widać „Wykryto: UTF-8” albo „Wykryto: Windows-1250”. Zmień, gdy polskie znaki są zniekształcone.
- Przypisanie kolumn – tabela „Kolumna pliku”, „Przykład” (pierwsza wartość), „Pole”. Aplikacja proponuje przypisanie po nazwie nagłówka; zmień je listą „Pole dla kolumny …”.
- Lista otworów – „Otwory w pliku: N”, przyciski „Wszystkie” / „Nic”; przy każdym otworze liczba warstw i współrzędne. Otwory istniejące w zleceniu są wyszarzone z dopiskiem „istnieje – pominięty”. Ostrzeżenia otworu są wypisane pod nim na pomarańczowo.
- „Importuj zaznaczone (N)” – tworzy zaznaczone otwory.
Pola, do których można przypisać kolumnę: „— pomiń —”, „Otwór (nazwa)”, „Strop [m]”, „Grubość [m]”, „Spąg [m]”, „Symbol”, „Barwa”, „Wilgotność”, „Stan”, „Warstwa”, „Parametry dodatkowe”, „Data otworu”, „Rzędna otworu”, „X”, „Y”, pola opisu szczegółowego warstwy (np. geneza, stratygrafia – jak w oknie warstwy otworu) oraz „Kolumna własna”. Wymagane: nazwa otworu i strop, a do tego grubość albo spąg.
Gdy plik zawiera stare kody genezy lub stratygrafii, są one przekodowywane na słowniki zlecenia – liczba przekodowań jest pokazana jako „Przekodowano wartości genezy/stratygrafii: N”. Wiersze z problemami są wymienione w sekcji „Wiersze z uwagami (N)” („Wiersz N (P-1): …”, do 50 pozycji).
Komunikaty: „Utworzono N otworów”, „Import przerwany po N otworach: …”.
Import z GeoStara (CSV)
Import otworów z programu GeoStar: pliki CSV z „Eksportów specjalnych” GeoStara, tabel:
| Tabela | Zawartość | Wymagana |
|---|---|---|
| GS_OTWORY | metryka otworu: IDNAZW, NAZW, TEMAT, współrzędne, rzędna H, data, archiwalność, zarurowanie, głębokość | tak |
| GS_LIT | litologia: STROP, GRUB/SPAG, SYMBOL, opis, geneza, stratygrafia, zwierciadła (HOR, HORU, HORSACZ), parametry G_* | nie |
| GS_PROBY | próby laboratoryjne: STROP, SPAG, wilgotność, granice, gęstości, parametry wytrzymałościowe, frakcje | nie |
| GS_OPISOTW | opis wykonania: miejscowość, gmina, powiat, województwo, inwestor, wykonawca, nadzór, sposób wiercenia, wiertnica, data | nie |
Tabele są łączone po polu IDNAZW (i TEMAT, jeśli jest). Gdy brak IDNAZW – po nazwie NAZW (z notatką „…: brak kolumny IDNAZW – połączono po NAZW”). Obowiązuje zasada „mapuj znane, resztę raportuj”: kolumny bez odpowiednika w aplikacji są wypisane w sekcji „Pominięte kolumny”.
Karta ma przycisk „Wczytaj pliki” – wybierz naraz wszystkie pliki (.csv lub .txt). Otworzy się okno „Import z GeoStara”.

- Lista plików – nazwa, liczba wierszy, wykryte kodowanie i lista „Tabela pliku …”: rodzaj tabeli GeoStara albo „— pomiń —”. Tabela jest rozpoznawana z nazwy pliku (token GS_OTWORY, GS_LIT, GS_PROBY, GS_OPISOTW), a gdy go brak – z nagłówków kolumn.
- „Kodowanie” – „Automatycznie”, „UTF-8”, „Windows-1250 (CP1250)”, „Windows-1252 (CP1252)”. GeoStar zapisuje zwykle w Windows-1250.
- „Temat” – gdy GS_OTWORY ma kolumnę TEMAT: wybór tematu (z liczbą otworów, np. „Hala (3 otwory)”, pusty temat – „bez tematu”) albo „Wszystkie tematy”.
- „Współrzędne” – para kolumn współrzędnych, gdy plik ma kilka: „X / Y”, „X_1992 / Y_1992”, „X_2000 / Y_2000”, „X_1965 / Y_1965”, „X_1942 / Y_1942”, „X_WPROW / Y_WPROW”.
- „Zamień X i Y” – zamienia współrzędne przy imporcie.
- Lista otworów – „Otwory: N”, „Wszystkie” / „Nic”; przy każdym: nazwa, liczba warstw, próbek i zwierciadeł, współrzędne; „istnieje – pominięty” lub „powtórzony – pominięty”; ostrzeżenia na pomarańczowo (np. „brak współrzędnych X/Y”, „brak NAZW – nazwa = IDNAZW”, „głębokość otworu GLUB N m różni się od spągu ostatniej warstwy N m”).
- „Wiersze z uwagami (N)” – problemy w wierszach: tabela, numer wiersza, otwór, opis (np. „brak otworu IDNAZW „104” w GS_OTWORY – wiersz pominięty”, „nieprawidłowa wartość „…” w kolumnie …”, „nieprawidłowa data „…””, „nieznane województwo „…” – pominięte”).
- „Importuj zaznaczone (N)” – tworzy otwory i próbki gruntu (z kolejnymi numerami laboratoryjnymi). Nieaktywny przy błędach plików.
Błędy blokujące import (wypisane na czerwono): „Wczytaj plik tabeli GS_OTWORY”, „Tabela …: wybrano N plików – zostaw jeden”, „…: brak kolumny IDNAZW i NAZW”, „Obsługiwane są pliki .csv i .txt (…)”.
Wybrane odwzorowania pól GeoStara (pełna lista w src/lib/geostarImport.ts):
| Pole GeoStar | Pole w aplikacji |
|---|---|
| NAZW (lub IDNAZW) | nazwa otworu |
| X, Y (lub wybrana para) | współrzędne |
| H | rzędna |
| DATA | data otworu |
| NOWY_ARCHIWALNY = „A” | status „Archiwalne” |
| NAZWARCH, NAZWEXT | nazwa archiwalna, druga nazwa |
| KILOMETR_WYLICZONY | kilometraż |
| GLEBZ, SREDZ | zarurowanie (głębokość, średnica) |
| OPIS, ROK, ZRODLO | uwagi otworu („Rok wykonania: …”, „Źródło: …”) |
| STROP, GRUB, SPAG, SYMBOL | warstwa (strop, miąższość lub spąg, symbol) |
| GENEZA / GENEZA_ID, ISTRA | geneza, stratygrafia (przekodowane na słownik zlecenia) |
| HOR, HORU, HORSACZ | zwierciadło nawiercone, ustabilizowane, sączenie |
| G_ID, G_IL, G_IC, G_FI, G_SPOJNOSC, G_SU, G_MO, G_EOED, G_OCR, G_KO, G_QC, G_FS, G_U2… | parametry dodatkowe warstwy (ID, IL, IC, φ′, c′, su, M0, Eoed, OCR, K0, qc, fs, u2…) |
| G_WLGTNAT, G_GPLYN, G_GPLAST, G_WSKPLAST, G_STPLAST, G_COBJ, G_CWLAS… | parametry próbki (wn, wL, wP, Ip, IL, ρ, ρs…) |
| G_FZWIR, G_FPIASEK, G_FPYL, G_FIL | frakcje próbki (żwirowa, piaskowa, pyłowa, iłowa) |
| MIEJSCOWOSC, GMINA, POWIAT, WOJEWODZTWO, INWESTOR, WYKONAWCA, DOZOR… (GS_OPISOTW) | dane lokalizacji i wykonania otworu |
Warstwa bez SYMBOL, ale z kodem szrafury SG1, dostaje ostrzeżenie „… brak SYMBOL, kod szrafury SG1 = … – uzupełnij symbol”.
Komunikaty: „Utworzono N otworów i M próbek”, „Import przerwany po N otworach i M próbkach: …”.
Uzupełnij warstwy z pliku
Dopisuje dane do istniejących warstw otworów – np. genezę i stratygrafię opracowane później w arkuszu. Przycisk „Wczytaj plik (CSV, XLSX)” wczytuje tabelę (akceptuje też plik .json).

- „Kolumna z nazwą otworu” – kolumna pliku z nazwą otworu.
- „Kolumna ze stropem” – kolumna z głębokością stropu warstwy.
- Para „Kolumna pliku → Pole docelowe” – która kolumna pliku trafia do którego pola warstwy (pola tabeli warstw i opisu szczegółowego). Kosz („Usuń pole”) usuwa parę.
- „Dodaj pole” – dodaje kolejną parę.
- „Pozostaw istniejące” / „Zastąp istniejące” – czy nadpisywać pola już wypełnione.
- „Podgląd” – otwiera okno „Podgląd uzupełnienia warstw”.
Kluczem jest nazwa otworu i strop warstwy z tolerancją 0,05 m. Puste komórki nie czyszczą pól. Okno podglądu pokazuje tabelę „Otwór”, „Strop”, „Pole”, „Było → Będzie” oraz sekcję „Wiersze bez dopasowania” z przyczyną: „brak nazwy otworu”, „nie ma takiego otworu w zleceniu”, „strop pusty lub nieprawidłowy”, „brak warstwy w tolerancji 0,05 m”, „dwie warstwy jednakowo blisko”. „Zastosuj” zapisuje zmiany (komunikat „Uzupełniono N warstw w M otworach”); bez zmian – „Brak zmian do zastosowania.”.
Przekoduj wartości w warstwach
Zamiana wartości wybranego pola warstwy według tablicy „jest → ma być” – np. migracja starych zapisów genezy lub stratygrafii na słownik zlecenia albo ujednolicenie symboli.

- „Pole warstwy” – pole do przekodowania: pola tabeli warstw (np. „Symbol”, „Barwa”, „Stan”), pola opisu szczegółowego (np. „Geneza”, „Stratygrafia”) i kolumny własne otworów.
- „Zakres” – „Całe zlecenie” albo „Wybrane otwory” (pojawia się lista otworów z polami wyboru).
- „Wygeneruj tablicę” – tworzy tablicę ze wszystkich wartości pola występujących w zakresie (z liczbą wystąpień).
- „Wczytaj CSV” – wczytuje tablicę z pliku
.csv/.txt(„Wczytano N wierszy tablicy”). - „Zapisz CSV” – zapisuje bieżącą tablicę do CSV (do edycji poza aplikacją).
- „Znajdź” / „Zamień na” – zamiana tekstu w kolumnie „Ma być” całej tablicy; opcja „Czuły na wielkość liter”, przycisk „Zamień”.
- Tablica – kolumny „Jest”, „Ma być” (pole do edycji), „Wystąpień”, „Uwagi” i przycisk „Usuń wiersz”. Przycisk „Usuń wiersze bez zmian” usuwa wiersze, w których „Ma być” = „Jest”.
- „Jeśli wartości nie ma w tablicy” – „Pozostaw istniejącą” albo „Wyczyść” (dla pola „Symbol” wyłączone: „Symbol nie może być pusty (pusty symbol = koniec otworu)”). Dla pola „Geneza” jest dodatkowo opcja „Uzupełnij pustą stratygrafię ze starej genezy (np. fQh → holocen)”.
- „Podgląd” – okno „Podgląd przekodowania” z liczbą warstw ze zmianami, zmian i wyczyszczonych wartości oraz tabelą „Otwór”, „Strop”, „Pole”, „Było → Będzie”. „Zastosuj” zapisuje zmiany (wymaga prawa edycji). Gdy tablica ma błędy – „Popraw tablicę przed zapisem”.
- Gotowe tablice – „Stara stratygrafia → trzystopniowa (PIG)” i „Stare genezy → słownik z kodami”: przełączają pole i wypełniają tablicę propozycjami dla wartości występujących w zakresie.
Puste wartości nie są zmieniane. Komunikat po zapisie: „Przekodowano N warstw w M otworach”.
Typowe problemy
| Komunikat / objaw | Przyczyna | Co zrobić |
|---|---|---|
| Przycisk „Generuj raport zbiorczy (PDF)” nieaktywny | wszystkie rozdziały wyłączone albo puste | włącz rozdziały z kartami |
| „Nie udało się wygenerować raportu” | błąd rysowania którejś karty albo brak pamięci przeglądarki | wyłącz część rozdziałów i generuj raport w częściach; sprawdź karty w modułach („Podgląd PDF”) |
| W raporcie brakuje karty, choć badanie jest na liście | karta nie dała żadnej strony (brak danych) | uzupełnij dane w module; sprawdź „Weryfikację danych” |
| Mapy w raporcie bez podkładu | podkład WMS nie wczytał się w czasie | wygeneruj ponownie przy dobrym połączeniu |
| „Nie udało się wczytać pliku” (uzupełnianie z zestawienia) | plik nie jest prawidłowym XLSX | zapisz plik w Excelu jako .xlsx |
| „Zaktualizowano 0 badań” | brak kolumny „Nr otworu” / „Nr badania” albo nazwy się nie zgadzają | użyj pliku pobranego z „Zestawień”, nie zmieniaj nagłówków |
| „Brak kolumn „Otwór” i „Od [m]” – użyj szablonu” | nagłówki szablonu zmienione | pobierz szablon ponownie |
| „Utworzono 0 otworów (pominięto N istniejących)” | otwory o tych nazwach już są w zleceniu | zmień nazwy w pliku albo usuń stare otwory |
| Zniekształcone polskie litery w imporcie CSV | złe kodowanie | wybierz „Windows-1250 (CP1250)” w polu „Kodowanie” |
| „Wczytaj plik tabeli GS_OTWORY” | nie wczytano albo nie przypisano tabeli metryki | dodaj plik GS_OTWORY albo przypisz tabelę w liście pliku |
| „Tabela …: wybrano 2 pliki – zostaw jeden” | dwa pliki przypisane do tej samej tabeli | ustaw w jednym z nich „— pomiń —” |
| „brak otworu IDNAZW „…” w GS_OTWORY – wiersz pominięty” | litologia lub próba bez otworu w metryce (inny temat lub brak w GS_OTWORY) | wybierz „Wszystkie tematy” albo uzupełnij GS_OTWORY |
| „Popraw tablicę przed zapisem” | tablica przekodowania ma błędy (np. pusty symbol) | popraw wiersze wskazane w podglądzie |