> 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/it/tour-del-prodotto-app-web/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Risultati di laboratorio del suolo (CSV/Excel) - Importazione intelligente

GeoPard Agriculture è la prima piattaforma a “risolvere” davvero il caos dei formati dei risultati di laboratorio del suolo, con importazione intelligente automatizzata.

## Panoramica

I file dei laboratori di analisi del suolo spesso utilizzano modelli, lingue, nomi di colonne e unità di misura diversi. Smart Import individua la tabella dei risultati e la associa ai punti di campionamento per l’analisi.

<figure><img src="https://1371939954-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>Analisi automatica dei risultati dei laboratori del suolo in CSV/Excel</p></figcaption></figure>

## File supportati

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), inclusi file Excel con più fogli
* Più file per caricamento, fino a 40 MB per file

### Modelli Excel per i risultati dei laboratori di analisi del suolo

{% file src="/files/82b7cc7f431837a4e2cb7299666afaea1bd0001b" %}

{% file src="/files/38b32c8e50d5b4711b028e804cf90328cd31b180" %}

{% file src="/files/3210f301f956342062dff634f8fbbc501f70a860" %}

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

Usa questi fogli di lavoro per preparare **i risultati aggregati per zona di gestione**. Ogni riga rappresenta il risultato di una zona. I valori sono puramente illustrativi e non costituiscono raccomandazioni di fertilizzazione.

* `geopard-lab-results-zones-plan-id-en.xlsx`: intestazioni in inglese; associa le zone tramite **ID piano** e **ID zona**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: intestazioni in ucraino; associa le zone tramite **ID плану** e **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: intestazioni in inglese; associa le zone tramite **Nome campo** e **ID zona**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: intestazioni in ucraino; associa le zone tramite **Назва поля** e **ID зони**.

#### Scegli il modello corretto

Usa un modello con **ID piano** se i campioni provengono da un piano di campionamento GeoPard. È l'opzione più affidabile. Inserisci l'identificativo del piano e l'identificativo della zona o del punto esattamente come sono indicati nel piano.

Usa un modello con **Nome campo** se non è disponibile un identificativo di piano GeoPard. Inserisci il nome del campo esattamente come appare in GeoPard. Gli identificativi delle zone devono corrispondere alle zone di quel campo.

Non combinare l'associazione tramite ID piano e Nome campo nello stesso file. Mantieni i risultati delle zone e quelli dei punti in file separati. Non modificare i valori delle colonne chiave dopo che il laboratorio ha ricevuto i campioni.

#### Compila il foglio di lavoro

1. Mantieni la prima riga come intestazione delle colonne. Non unire le celle dell'intestazione.
2. Aggiungi una riga per ogni zona o punto campionato. Non raggruppare più zone o punti in un'unica riga.
3. Mantieni **ID piano** + **ID zona**, **ID piano** + **ID punto**, oppure **Nome campo** + **ID zona**, in colonne separate.
4. Inserisci ogni risultato nella rispettiva colonna dei nutrienti o delle proprietà del suolo. Mantieni le unità riportate nell'intestazione della colonna.
5. Inserisci i valori di pH, sostanza organica, azoto, fosforo, potassio, zolfo, zinco e boro nelle colonne appropriate. Lascia vuoto il campo di un risultato se il laboratorio non lo ha riportato.
6. Mantieni intatta la tabella dei risultati del foglio di lavoro. Non aggiungere totali, commenti o altre tabelle al suo interno.

I modelli contengono solo valori di esempio. Prima di usare i risultati importati per una decisione agronomica, verifica il metodo di analisi del laboratorio, la profondità di campionamento, gli attributi e le unità.

#### Risultati del campionamento puntuale

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

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

Usa questi fogli di lavoro per **i campioni di suolo prelevati con sonda nell'ambito di un piano di campionamento GeoPard**. Ogni riga rappresenta un punto campionato.

* `geopard-lab-results-points-plan-id-en.xlsx`: intestazioni in inglese; associa i punti tramite **ID piano** e **ID punto**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: intestazioni in ucraino; associa i punti tramite **ID плану** e **ID точки**.

Inserisci l'ID punto esattamente come riportato sull'etichetta del punto. Esempio:

```csv
ID piano,ID punto,pH KCl,Matéria organica (%),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
```

Per i punti campionati senza un piano GeoPard, inserisci invece le colonne `Lon` e `Lat` . GeoPard associa ogni punto se ricade all'interno del confine del campo. Verifica la corrispondenza delle coordinate prima di caricare il file.

{% hint style="warning" %}
I risultati delle analisi del suolo importati sono misurazioni, non raccomandazioni per l'applicazione. Verifica ogni attributo e unità di misura nell'anteprima di importazione.
{% endhint %}

## Operazioni automatiche

* Individua la tabella dei risultati e le relative intestazioni, anche in layout non standard.
* Riconosce i nomi più comuni degli attributi di laboratorio in diverse lingue.
* Rileva i macro e microelementi, quindi crea un’anteprima modificabile della mappatura.
* Rileva e normalizza le unità di misura, segnalando quelle insolite o miste.
* Associa i campioni tramite un piano di campionamento GeoPard o i dati spaziali presenti nel file.

## Preparare un file CSV o Excel

Mantieni una riga per ogni risultato di laboratorio. Usa una riga di intestazione. Inserisci ogni misurazione in una colonna distinta.

In un file Excel, mantieni ben separate le tabelle dei risultati. GeoPard supporta i file con più fogli. Prima del caricamento, verifica le intestazioni, le mappature e le unità di misura rilevate.

### Esempio: campioni compositi zonali

Usa questa struttura quando un laboratorio riceve un piano creato in GeoPard. `Sampling Plan ID` e `Zone ID` consentono l’associazione più affidabile.

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

I valori e gli attributi sopra riportati sono esempi. Mantieni le unità di misura indicate dal laboratorio. Verifica ogni unità associata nell’anteprima.

### Esempio: campioni prelevati con sonda da un piano GeoPard

Usa questa struttura quando un laboratorio riceve campioni prelevati con sonda secondo un piano creato in GeoPard. `Sampling Plan ID` e `Point ID` consentono l’associazione più affidabile. Il Point ID è il nome del punto riportato sull’etichetta del campione.

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

Una riga per ogni punto campionato. Non combinare più punti in una sola riga.

### Esempio: campioni prelevati con sonda e coordinate

Per i campioni prelevati con sonda senza un piano GeoPard, usa longitudine e latitudine. GeoPard associa ogni punto se ricade all’interno del confine del campo.

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

Non scambiare `Lon` e `Lat`.

### Esempio: risultati associati al campo

Usa `Field Name` oppure `Field ID` quando il file del laboratorio identifica il campo. Verifica che il nome del campo corrisponda a quello in 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` è l'UUID del campo in GeoPard. Puoi trovarlo nell'URL della pagina del campo.

## Come GeoPard associa i risultati di laboratorio ai campi

GeoPard può associare i risultati di laboratorio al campo corretto in quattro modi:

1. **ID del piano di campionamento con ID della zona o ID del punto**\
   Usa colonne separate per l'ID univoco del piano di campionamento e per l'ID della zona (campioni compositi) o l'ID del punto (campioni puntuali). È l'opzione più affidabile per qualsiasi piano di campionamento generato in GeoPard.
2. **Coordinate del punto (`Lon` / `Lat`)**\
   Usa due colonne per longitudine e latitudine. GeoPard associa il punto in base alla sua posizione, se ricade entro il confine del campo. Usa questo metodo per i campioni puntuali prelevati senza un piano GeoPard.
3. **Geometria WKT**\
   Usa una colonna con la geometria WKT. GeoPard associa la geometria al confine del campo in base alla sua posizione.
4. **Nome campo / ID campo**\
   Usa una colonna di testo con il nome o l'ID del campo. GeoPard confronta il nome del campo con il campo `Name`.\
   `Field ID` è l'UUID del campo in GeoPard. Puoi trovarlo nell'URL della pagina del campo.

## Importare il file

1. Apri **Importa dati** → **Carica file** → **Risultati di laboratorio**.
2. Carica il file CSV, XLS o XLSX.
3. Seleziona un campo o un piano di campionamento, se disponibile. Aggiungi le date pertinenti.
4. Esamina la tabella rilevata, la mappatura degli attributi e le unità di misura.
5. Correggi eventuali mappature o unità di misura non corrispondenti al rapporto di laboratorio.
6. Seleziona **Carica**.

{% hint style="warning" %}
Non considerare i valori importati come raccomandazioni per l'applicazione. Prima di prendere decisioni agronomiche, verifica gli attributi mappati, le unità di misura, la profondità di campionamento e il metodo di analisi del laboratorio.
{% endhint %}

## Collegamento ai piani di campionamento

Per i campioni compositi per zona, crea il piano in [Campionamento del suolo - Pianificazione automatizzata](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/soil-sampling-automated-planning.md) e mantieni nel file di laboratorio gli identificativi del piano e della zona. Per i campioni puntuali, mantieni gli identificativi del piano e del punto oppure includi le coordinate.

In questo modo si mantiene il collegamento tra il risultato di laboratorio, la posizione nel campo e le future analisi dell'andamento del suolo.


---

# 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/it/tour-del-prodotto-app-web/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.
