> 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/ar/jwlh-almntj-ttbyq-alwyb/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# نتائج مختبر التربة (CSV/Excel) - استيراد ذكي

تُعد GeoPard Agriculture أول منصة «تحل» فعليًا فوضى تنسيق نتائج مختبر التربة - باستيراد ذكي آلي.

## نظرة عامة

غالبًا ما تستخدم ملفات مختبرات التربة قوالب ولغات وأسماء أعمدة ووحدات مختلفة. يحدّد الاستيراد الذكي جدول النتائج ويربطه بنقاط أخذ العينات لتحليلها.

<figure><img src="https://2518643298-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>تحليل آلي لنتائج مختبرات التربة بصيغ CSV وExcel</p></figcaption></figure>

## الملفات المدعومة

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`)، بما في ذلك المصنفات متعددة الأوراق
* يمكن تحميل عدة ملفات، حتى 40 ميغابايت لكل ملف

### قوالب Excel لنتائج مختبرات التربة

{% file src="/files/1bd639fb7a24c27232226447ada1ebbf503305f4" %}

{% file src="/files/0045a54fc20ae73f368cee9ae8d0b2c23e57ed4f" %}

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

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

استخدم مصنفات العمل هذه لإعداد **النتائج المجمعة حسب منطقة الإدارة**. يمثّل كل صف نتيجة منطقة واحدة. القيم توضيحية وليست توصيات تسميد.

* `geopard-lab-results-zones-plan-id-en.xlsx`: عناوين أعمدة بالإنجليزية؛ يطابق المناطق باستخدام **معرّف الخطة** و **معرّف المنطقة**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: عناوين أعمدة بالأوكرانية؛ يطابق المناطق باستخدام **معرّف الخطة** و **معرّف المنطقة**.
* `geopard-lab-results-zones-field-name-en.xlsx`: عناوين أعمدة بالإنجليزية؛ يطابق المناطق باستخدام **اسم الحقل** و **معرّف المنطقة**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: عناوين أعمدة بالأوكرانية؛ يطابق المناطق باستخدام **اسم الحقل** و **معرّف المنطقة**.

#### اختر القالب المناسب

استخدم قالب **معرّف الخطة** عندما تكون العينات مأخوذة وفق خطة أخذ عينات في GeoPard. وهذا هو الخيار الأكثر موثوقية. أدخل معرّف الخطة ومعرّف المنطقة أو النقطة تمامًا كما يظهران في الخطة.

استخدم قالب **اسم الحقل** عندما لا يتوفر معرّف خطة GeoPard. أدخل اسم الحقل تمامًا كما يظهر في GeoPard. يجب أن تتطابق معرّفات المناطق مع المناطق التابعة لذلك الحقل.

لا تخلط بين المطابقة باستخدام معرّف الخطة والمطابقة باستخدام اسم الحقل في ملف واحد. احتفظ بنتائج المناطق ونتائج النقاط في ملفات منفصلة. لا تغيّر قيم أعمدة المفاتيح بعد أن يستلم المختبر العينات.

#### أكمل مصنف العمل

1. أبقِ الصف الأول لعناوين الأعمدة. لا تدمج خلايا العناوين.
2. أضف صفًا لكل منطقة أو نقطة مأخوذة منها عينة. لا تدمج عدة مناطق أو نقاط في صف واحد.
3. أبقِ **معرّف الخطة** + **معرّف المنطقة**, **معرّف الخطة** + **معرّف النقطة**، أو **اسم الحقل** + **معرّف المنطقة**، في أعمدة منفصلة.
4. أدخل كل نتيجة في عمود مستقل للمغذّيات أو خصائص التربة. أبقِ الوحدات المُبلّغ عنها في عنوان العمود.
5. أبقِ قيم الأس الهيدروجيني (pH) والمادة العضوية والنيتروجين والفوسفور والبوتاسيوم والكبريت والزنك والبورون في الأعمدة المناسبة. اترك النتيجة فارغة إذا لم يبلّغ عنها المختبر.
6. أبقِ جدول النتائج في مصنف العمل كما هو. لا تضف مجاميع أو تعليقات أو جداول إضافية داخله.

تتضمن القوالب قيمًا توضيحية فقط. تحقّق من طريقة المختبر وعمق أخذ العينات والسمات والوحدات قبل استخدام النتائج المستوردة لاتخاذ قرار زراعي.

#### نتائج أخذ عينات النقاط

{% file src="/files/252144974c8a3163cf228358dc749af10afae11f" %}

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

استخدم مصنفات العمل هذه لـ **عينات اللبّ المأخوذة وفق خطة أخذ عينات في GeoPard**. يمثّل كل صف نقطة واحدة أُخذت منها عينة.

* `geopard-lab-results-points-plan-id-en.xlsx`: عناوين الأعمدة بالإنجليزية؛ تتم مطابقة النقاط عبر **معرّف الخطة** و **معرّف النقطة**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: عناوين الأعمدة بالأوكرانية؛ تتم مطابقة النقاط عبر **ID плану** و **ID точки**.

أدخل معرّف النقطة كما هو مطبوع تمامًا على ملصقها. مثال:

```csv
Plan ID,Point ID,pH KCl,Organic matter (%),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
```

بالنسبة إلى النقاط التي أُخذت عيناتها من دون خطة GeoPard، أدرج عمودَي `Lon` و `Lat` بدلًا منهما. تطابق GeoPard كل نقطة تقع داخل حدود الحقل. راجع ربط الإحداثيات قبل التحميل.

{% hint style="warning" %}
نتائج تحليل التربة المستوردة هي قياسات، وليست توصيات للتطبيق. تحقّق من كل خاصية ووحدة قياس في معاينة الاستيراد.
{% endhint %}

## ما الذي يحدث تلقائيًا

* يعثر على جدول النتائج وعناوين أعمدته، بما في ذلك التنسيقات غير القياسية.
* يتعرّف على أسماء خصائص المختبر الشائعة بلغات مختلفة.
* يحدّد المغذيات الكبرى والصغرى، ثم ينشئ معاينة ربط قابلة للتحرير.
* يكتشف الوحدات ويوحّد تنسيقها، ثم ينبّه إلى الوحدات غير المعتادة أو المختلطة.
* يطابق العينات باستخدام خطة أخذ عينات من GeoPard أو البيانات المكانية الموجودة في الملف.

## إعداد ملف CSV أو Excel

اجعل لكل نتيجة مختبرية صفًا واحدًا. استخدم صفًا للعناوين، وضع كل قياس في عمود مستقل.

في مصنف Excel، اجعل جداول النتائج منفصلة بوضوح. يدعم GeoPard المصنفات متعددة الأوراق. راجع العناوين وعمليات الربط والوحدات التي اكتشفها النظام قبل التحميل.

### مثال: عينات مركبة حسب المناطق

استخدم هذا التنسيق عندما يتلقى المختبر خطة أُنشئت في GeoPard. `Sampling Plan ID` و `Zone ID` يوفّران أدق مطابقة.

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

القيم والخصائص أعلاه أمثلة. احتفظ بالوحدات التي يوردها المختبر. تحقّق من كل وحدة مرتبطة في المعاينة.

### مثال: عينات لُبيّة من خطة GeoPard

استخدم هذا التنسيق عندما يتلقى المختبر عينات لُبيّة من خطة أُنشئت في GeoPard. `Sampling Plan ID` و `Point ID` يوفّران أدق مطابقة. معرّف النقطة هو اسم النقطة المطبوع على ملصق العينة.

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

اجعل لكل نقطة مأخوذة منها عينة صفًا واحدًا. لا تدمج عدة نقاط في صف واحد.

### مثال: عينات لُبيّة بإحداثيات

استخدم خط الطول وخط العرض للعينات اللُبيّة المأخوذة دون خطة GeoPard. يطابق GeoPard كل نقطة إذا وقعت داخل حدود الحقل.

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

لا تبدّل `Lon` و `Lat`.

### مثال: نتائج مرتبطة بالحقل

استخدم `Field Name` أو `Field ID` عندما يحدد ملف المختبر الحقل. تأكد من تطابق اسم الحقل مع اسم الحقل في GeoPard.

```csv
اسم الحقل,معرّف العينة,الأس الهيدروجيني,المادة العضوية
الحقل الشمالي,LAB-1001,6.3,3.0
الحقل الشمالي,LAB-1002,6.5,3.2
```

`Field ID` هو المعرّف الفريد العام (UUID) لحقل GeoPard. يمكنك العثور عليه في عنوان URL لصفحة الحقل.

## كيف يطابق GeoPard نتائج المختبر بالحقول

يمكن لـ GeoPard مطابقة نتائج المختبر بالحقل الصحيح بأربع طرق:

1. **معرّف خطة أخذ العينات مع معرّف المنطقة أو معرّف النقطة**\
   استخدم عمودين منفصلين لمعرّف خطة أخذ العينات الفريد ومعرّف المنطقة (للعينات المركبة) أو معرّف النقطة (للعينات اللبّية). هذا هو الخيار الأكثر موثوقية لأي خطة أخذ عينات أُنشئت في GeoPard.
2. **إحداثيات النقطة (`Lon` / `Lat`)**\
   استخدم عمودين لخط الطول وخط العرض. يطابق GeoPard النقطة مكانيًا إذا وقعت داخل حدود الحقل. استخدم هذه الطريقة للعينات اللبّية المأخوذة من دون خطة GeoPard.
3. **هندسة WKT**\
   استخدم عمودًا واحدًا يتضمن هندسة WKT. يطابق GeoPard الهندسة مكانيًا مع حدود الحقل.
4. **اسم الحقل / معرّف الحقل**\
   استخدم عمودًا نصيًا يتضمن اسم الحقل أو معرّف الحقل. يقارن GeoPard اسم الحقل باسم الحقل `Name`.\
   `Field ID` هو المعرّف الفريد العام (UUID) لحقل GeoPard. يمكنك العثور عليه في عنوان URL لصفحة الحقل.

## استيراد الملف

1. افتح **استيراد البيانات** → **تحميل الملفات** → **نتائج المختبر**.
2. حمّل ملف CSV أو XLS أو XLSX.
3. حدد حقلًا أو خطة أخذ عينات، إن توفرت. أضف التواريخ ذات الصلة.
4. راجع الجدول الذي تم اكتشافه، وربط السمات، ووحدات القياس.
5. صحّح أي ربط أو وحدة قياس لا تتطابق مع تقرير المختبر.
6. حدّد **تحميل**.

{% hint style="warning" %}
لا تتعامل مع القيم المستوردة على أنها توصيات للتطبيق. راجع السمات المرتبطة ووحدات القياس وعمق أخذ العينات وطريقة المختبر قبل اتخاذ قرار زراعي.
{% endhint %}

## الربط بخطط أخذ العينات

بالنسبة إلى العينات المركبة حسب المناطق، أنشئ الخطة في [أخذ عينات التربة - التخطيط الآلي](https://docs.geopard.tech/geopard-tutorials/ar/jwlh-almntj-ttbyq-alwyb/soil-sampling-automated-planning.md) واحتفظ بمعرّفي الخطة والمنطقة في ملف المختبر. وبالنسبة إلى العينات اللبّية، احتفظ بمعرّفي الخطة والنقطة، أو أدرج الإحداثيات.

يحافظ ذلك على الارتباط بين نتيجة المختبر وموقعها في الحقل وتحليل اتجاهات التربة مستقبلًا.


---

# 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/ar/jwlh-almntj-ttbyq-alwyb/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.
