> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Wyniki laboratorium glebowego (CSV/Excel) - inteligentny import

GeoPard Agriculture to pierwsza platforma, która naprawdę „rozwiązuje” chaos formatów wyników laboratoriów glebowych - dzięki automatycznemu inteligentnemu importowi.

## Omówienie

Pliki z laboratoriów glebowych często korzystają z różnych szablonów, języków, nazw kolumn i jednostek. Funkcja Smart Import identyfikuje tabelę z wynikami i przyporządkowuje ją do punktów poboru próbek na potrzeby analizy.

<figure><img src="https://3832317038-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fq4l9jRvhxTwmgtYiLmLe%2Fsoil_lab_results_import.jpeg?alt=media&amp;token=836b5fde-4943-473d-b13a-321e5b9c1fd6" alt="Automated parsing of csv/excel soil lab results"><figcaption><p>Automatyczne odczytywanie wyników badań gleby z plików CSV i Excel</p></figcaption></figure>

## Obsługiwane pliki

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), w tym skoroszyty z wieloma arkuszami
* Wiele plików w jednym przesłaniu, do 40 MB na plik

### Szablony Excel z wynikami badań gleby

{% file src="/files/0c4750efbb1fcfe241d7a08ed54d49c76e75755c" %}

{% file src="/files/8e57b82a3861c50689af11b8b6c3877be9992836" %}

{% file src="/files/a5130c76926fe8b3ad1b958c1dd57941fe24c45b" %}

{% file src="/files/abe19632ec3493271a9b5148e6fdeb2594dd6ef3" %}

Użyj tych skoroszytów, aby przygotować **zbiorcze wyniki według stref zarządzania**. Każdy wiersz przedstawia wynik dla jednej strefy. Wartości mają charakter przykładowy i nie stanowią zaleceń dotyczących nawożenia.

* `geopard-lab-results-zones-plan-id-en.xlsx`: nagłówki w języku angielskim; dopasowuje strefy na podstawie **ID planu** i **ID strefy**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: nagłówki w języku ukraińskim; dopasowuje strefy na podstawie **ID плану** i **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: nagłówki w języku angielskim; dopasowuje strefy na podstawie **Nazwa pola** i **ID strefy**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: nagłówki w języku ukraińskim; dopasowuje strefy na podstawie **Назва поля** i **ID зони**.

#### Wybierz odpowiedni szablon

Użyj szablonu z **ID planu** w przypadku próbek pobranych w ramach planu próbkowania GeoPard. To najbardziej niezawodna opcja. Wpisz identyfikator planu oraz identyfikator strefy lub punktu dokładnie tak, jak podano je w planie.

Użyj szablonu z **Nazwą pola** w przypadku braku identyfikatora planu GeoPard. Wpisz nazwę pola dokładnie tak, jak widnieje w GeoPard. Identyfikatory stref muszą odpowiadać strefom przypisanym do tego pola.

Nie łącz dopasowywania według ID planu i nazwy pola w jednym pliku. Wyniki dla stref i punktów umieść w osobnych plikach. Nie zmieniaj wartości w kolumnach kluczowych po otrzymaniu próbek przez laboratorium.

#### Uzupełnij skoroszyt

1. Pozostaw pierwszy wiersz jako nagłówki kolumn. Nie łącz komórek w nagłówkach.
2. Dodaj jeden wiersz dla każdej pobranej próbki ze strefy lub punktu. Nie łącz kilku stref ani punktów w jednym wierszu.
3. Umieść **ID planu** + **ID strefy**, **ID planu** + **ID punktu**, lub **Nazwę pola** + **ID strefy**, w osobnych kolumnach.
4. Wpisz każdy wynik w osobnej kolumnie składnika pokarmowego lub właściwości gleby. Zachowaj podane jednostki w nagłówku kolumny.
5. Wartości pH, materii organicznej, azotu, fosforu, potasu, siarki, cynku i boru umieść w odpowiednich kolumnach. Pozostaw komórkę pustą, jeśli laboratorium nie podało wyniku.
6. Zachowaj bez zmian tabelę wyników w skoroszycie. Nie dodawaj do niej sum, komentarzy ani dodatkowych tabel.

Szablony zawierają wyłącznie przykładowe wartości. Przed wykorzystaniem zaimportowanych wyników do podjęcia decyzji agrotechnicznej potwierdź metodę laboratoryjną, głębokość pobierania próbek, badane parametry i jednostki.

#### Wyniki próbkowania punktowego

{% file src="/files/0015fd7b593475b602d01235252706fb67595647" %}

{% file src="/files/a6b191276907418a2998f48156fcdd322b863d0a" %}

Użyj tych skoroszytów dla **próbek rdzeniowych pobranych w ramach planu próbkowania GeoPard**. Każdy wiersz przedstawia jeden punkt poboru próbki.

* `geopard-lab-results-points-plan-id-en.xlsx`Nagłówki angielskie; dopasowuje punkty na podstawie pola **ID planu** i **ID punktu**.
* `geopard-lab-results-points-plan-id-ua.xlsx`Nagłówki ukraińskie; dopasowuje punkty na podstawie pól **ID плану** i **ID точки**.

Wpisz identyfikator punktu dokładnie tak, jak widnieje na etykiecie punktu. Przykład:

```csv
ID planu,ID punktu,pH KCl,Substancja organiczna (%),P2O5 (mg/kg),K2O (mg/kg)
Z7D2F58,1,6.5,3.4,183,148
Z7D2F58,2,6.2,3.4,195,77
Z7D2F58,3,6.4,2.4,149,112
```

W przypadku punktów pobranych bez planu GeoPard podaj kolumny `Lon` i `Lat` zamiast tego. GeoPard dopasowuje każdy punkt, jeśli znajduje się on w granicach pola. Przed przesłaniem sprawdź mapowanie współrzędnych.

{% hint style="warning" %}
Zaimportowane wyniki badań gleby to pomiary, a nie zalecenia dotyczące aplikacji. Sprawdź każdy atrybut i jednostkę w podglądzie importu.
{% endhint %}

## Co dzieje się automatycznie

* Wyszukuje tabelę z wynikami i jej nagłówki, także w niestandardowych układach.
* Rozpoznaje typowe nazwy atrybutów laboratoryjnych w różnych językach.
* Wykrywa makro- i mikroskładniki, a następnie tworzy edytowalny podgląd przyporządkowania.
* Wykrywa i normalizuje jednostki, a następnie oznacza nietypowe lub mieszane jednostki.
* Dopasowuje próbki na podstawie planu poboru próbek GeoPard lub danych przestrzennych w pliku.

## Przygotuj plik CSV lub Excel

Każdy wiersz powinien zawierać jeden wynik badania. Użyj wiersza nagłówka. Każdy pomiar umieść w osobnej kolumnie.

W skoroszycie Excel wyraźnie oddziel od siebie tabele z wynikami. GeoPard obsługuje skoroszyty z wieloma arkuszami. Przed przesłaniem sprawdź wykryte nagłówki, przyporządkowania i jednostki.

### Przykład: próbki zbiorcze ze stref

Użyj tej struktury, gdy laboratorium otrzyma plan utworzony w GeoPard. `Sampling Plan ID` i `Zone ID` zapewniają najpewniejsze dopasowanie.

```csv
Sampling Plan ID,Zone ID,pH,Organic Matter,P,K
Z4B7C21,1,6.4,3.1,18,142
Z4B7C21,2,6.1,2.7,12,118
```

Powyższe wartości i atrybuty są przykładowe. Zachowaj jednostki podane przez laboratorium. Sprawdź każdą przyporządkowaną jednostkę w podglądzie.

### Przykład: próbki rdzeniowe z planu GeoPard

Użyj tej struktury, gdy laboratorium otrzyma próbki rdzeniowe pobrane zgodnie z planem utworzonym w GeoPard. `Sampling Plan ID` i `Point ID` zapewniają najpewniejsze dopasowanie. Point ID to nazwa punktu wydrukowana na etykiecie próbki.

```csv
Sampling Plan ID,Point ID,pH,Organic Matter,P,K
Z7D2F58,1,6.5,3.4,24,148
Z7D2F58,2,6.2,3.4,27,77
Z7D2F58,3,6.4,2.4,19,112
```

Jeden wiersz na każdy pobrany punkt. Nie łącz kilku punktów w jednym wierszu.

### Przykład: próbki rdzeniowe ze współrzędnymi

W przypadku próbek rdzeniowych pobranych bez planu GeoPard użyj długości i szerokości geograficznej. GeoPard dopasuje każdy punkt, jeśli znajduje się on w granicach pola.

```csv
Sample ID,Lon,Lat,pH,Organic Matter
CORE-001,10.123456,50.123456,6.4,3.1
CORE-002,10.124010,50.123780,6.2,2.8
```

Nie zamieniaj miejscami `Lon` i `Lat`.

### Przykład: wyniki przypisane do pola

Użyj `Field Name` lub `Field ID` gdy plik laboratoryjny identyfikuje pole. Sprawdź, czy nazwa pola jest zgodna z nazwą pola w GeoPard.

```csv
Field Name,Sample ID,pH,Organic Matter
North Field,LAB-1001,6.3,3.0
North Field,LAB-1002,6.5,3.2
```

`Field ID` to UUID pola w GeoPard. Można go znaleźć w adresie URL strony pola.

## Jak GeoPard przypisuje wyniki laboratoryjne do pól

GeoPard może przypisać wyniki laboratoryjne do właściwego pola na cztery sposoby:

1. **ID planu pobierania próbek wraz z ID strefy lub ID punktu**\
   Użyj osobnych kolumn z unikalnym ID planu pobierania próbek oraz ID strefy (próbki zbiorcze) lub ID punktu (próbki z rdzeni glebowych). To najbardziej niezawodna opcja w przypadku każdego planu pobierania próbek utworzonego w GeoPard.
2. **Współrzędne punktu (`Lon` / `Lat`)**\
   Użyj dwóch kolumn z długością i szerokością geograficzną. GeoPard przypisuje punkt przestrzennie, jeśli znajduje się on w granicach pola. Użyj tej metody w przypadku próbek z rdzeni glebowych pobranych bez planu GeoPard.
3. **Geometria WKT**\
   Użyj jednej kolumny z geometrią WKT. GeoPard dopasuje geometrię przestrzennie do granic pola.
4. **Nazwa pola / ID pola**\
   Użyj kolumny tekstowej z nazwą pola lub jego ID. GeoPard porównuje nazwę pola z nazwą pola `Name`.\
   `Field ID` to UUID pola w GeoPard. Można go znaleźć w adresie URL strony pola.

## Importowanie pliku

1. Otwórz **Importuj dane** → **Prześlij pliki** → **Wyniki badań laboratoryjnych**.
2. Prześlij plik CSV, XLS lub XLSX.
3. Wybierz pole lub plan pobierania próbek, jeśli jest dostępny. Dodaj odpowiednie daty.
4. Sprawdź wykrytą tabelę, mapowanie atrybutów i jednostki.
5. Popraw mapowanie lub jednostkę, jeśli nie odpowiadają raportowi laboratoryjnemu.
6. Wybierz **Prześlij**.

{% hint style="warning" %}
Nie traktuj zaimportowanych wartości jako zaleceń dotyczących aplikacji. Przed podjęciem decyzji agronomicznej sprawdź zmapowane atrybuty, jednostki, głębokość pobierania próbek i metodę laboratoryjną.
{% endhint %}

## Połącz z planami pobierania próbek

W przypadku strefowych próbek zbiorczych utwórz plan w [Pobór prób glebowych - planowanie automatyczne](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/soil-sampling-automated-planning.md) i zachowaj w pliku laboratoryjnym identyfikatory planu i strefy. W przypadku próbek z rdzeni glebowych zachowaj identyfikatory planu i punktu albo uwzględnij współrzędne.

Dzięki temu zostanie zachowane powiązanie między wynikiem badania laboratoryjnego, lokalizacją na polu i przyszłą analizą trendów glebowych.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
