استيراد بيانات حاسوب المناخ

صدّر فترة من حاسوب المناخ وارفعها في السجلات، استيراد المناخ. تفحص DeepLeaf Yield الملف، وتعرض ما قرأته، وتحفظ قيمة واحدة لكل ساعة، بما فيها القيم المضبوطة لدرجة الحرارة. لا حاجة إلى أي حساب لدى الشركة المصنّعة لحاسوب المناخ.

ما يُقرأ

• ملفات التصدير CSV وTSV والنصية، المفصولة بفواصل منقوطة أو علامات جدولة أو فواصل، مع نقطة عشرية أو فاصلة عشرية.
• مصنفات Excel (.xlsx). تُقرأ القيم المحفوظة فقط. ويُرفض المصنف الذي يحتوي صيغًا أو وحدات ماكرو، وكذلك ملفات .xls و.xlsb القديمة: احفظ الورقة بصيغة .xlsx أو CSV.
• النص بترميز UTF-8 أو UTF-16 أو Windows-1252، مع علامة ترتيب البايتات أو دونها.
• أسطر تفاصيل التصدير فوق سطر العناوين، وصف وحدات تحته، وعمود واحد للتاريخ والوقت أو عمودان منفصلان، والتواريخ التي يبدأ فيها اليوم أو الشهر، وتواريخ جداول البيانات الرقمية.
• أسماء الأعمدة بالإنجليزية أو الهولندية أو الإسبانية أو الفرنسية. وتقترح DeepLeaf Yield محتوى كل عمود: حرارة الهواء، والقيم المضبوطة للتدفئة والتهوية، والرطوبة النسبية، وثاني أكسيد الكربون، والإشعاع الضوئي النشط داخل الدفيئة، والإشعاع الخارجي، وحرارة الأنابيب، وموضع الستارة، وغيرها.
• وحدات مثل °F وhPa وµS/cm والإشعاع المجمّع في كل خطوة تسجيل، وتُحوَّل إلى الوحدات المحفوظة.

استيراد ملف

1. افتح استيراد المناخ في التطبيق واختر الدورة الزراعية.
2. أفلت ملف التصدير على الصفحة، أو اضغط اختر ملفًا. لا يُحفظ شيء بعد.
3. اقرأ ما سيُستورد: ترميز الملف وفواصله، والساعة التي يُقرأ بها، والقيم المضبوطة الموجودة، والساعات الأولى كما ستُحفظ.
4. تحت الأعمدة، تحقق مما يُقرأ به كل عمود. غيّر القياس أو الوحدة، أو اختر لا يُستورد لاستبعاد عمود. ويُفحص الملف من جديد بعد كل تغيير.
5. عالج ما يظهر تحت المشكلات، مثل ترتيب التواريخ أو تغيير الساعة. الملف الذي فيه مشكلات لا يُستورد أبدًا.
6. اترك تذكّر اختيارات الأعمدة هذه لهذه الدفيئة محددًا، ثم اضغط استيراد.

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

استوردت الملف الخطأ؟ تحت عمليات الاستيراد الأخيرة، في هذه الصفحة أو في المناخ ضمن السجلات، اضغط تراجع عن الاستيراد بجانبه ثم أكّد. تُحذف القراءات التي أضافها، وتستعيد القراءات التي غيّرها قيمها السابقة، وتبقى القراءات التي لم يغيّرها كما هي. وتظهر هناك أيضًا الملفات التي أرسلها برنامج نصي. وإذا غيّر استيراد لاحق بعض القراءات نفسها، تسألك DeepLeaf Yield أولًا: تراجع عن الاستيراد اللاحق، أو تراجع عن هذا على أي حال.

ساعة الملف

تُقرأ الأوقات التي لا فرق فيها بالمنطقة الزمنية للدفيئة المحددة في الإعداد. وتحت ساعة الملف يمكنك اختيار UTC، أو منطقة زمنية أخرى، أو فرق ثابت مثل UTC+01:00 لحاسوب مناخ يبقى على التوقيت الشتوي طوال العام.

• عند تأخير الساعة، تُقرأ الساعة المكررة بترتيب الصفوف: التوقيت الصيفي أولًا ثم الشتوي.
• عند تقديم الساعة، يظهر الوقت غير الموجود على تلك الساعة كمشكلة. اختر فرقًا ثابتًا إذا كان حاسوب المناخ لا يغيّر ساعته أبدًا.
• وتظهر كمشكلة أيضًا القراءة المقيسة في المستقبل، أو السابقة لأي تاريخ تصدير ممكن.

القيم المضبوطة

تُحفظ القيم المضبوطة للتدفئة أو التهوية أو لدرجة حرارة واحدة كقيم مستقلة، ولا تُحفظ أبدًا كحرارة هواء، فلا يمكن الخلط بين قيمة مضبوطة وقياس. وهي تتيح للتوقعات استخدام درجة الحرارة المخطط لها في الأسابيع القادمة بدلًا من افتراض ثابت. ويُقرأ بالطريقة نفسها أي تصدير لاحق يحتوي القيم المضبوطة المخطط لها.

الرفع التلقائي

يمكن لبرنامج نصي أو أتمتة خاصة بك إرسال التصدير نفسه بمفتاح المؤسسة. أنشئ مفتاحًا كما في المؤسسة والمفاتيح، وأبقه خارج المجلدات المشتركة. ويستخدم الرفع اختيارات الأعمدة المحفوظة للدفيئة، لذا استورد ملفًا واحدًا في التطبيق أولًا.

curl -H "X-API-Key: $ORG_KEY" -H "Content-Type: text/csv" \
  --data-binary @export.csv \
  "https://your-deepleaf-address/api/organizations/ORG/farms/FARM/greenhouses/HOUSE/rows/ROW/cycles/CYCLE/climate/ingest"

لمصنف Excel، أرسل Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. وأضف الساعة إلى العنوان إذا لم تكن المنطقة الزمنية للدفيئة:

.../climate/ingest?time_zone=UTC%2B01:00

يذكر الرد الساعات المحفوظة. ويُرفض الملف الذي فيه مشكلات بالرمز 400 مع المشكلات نفسها التي يعرضها التطبيق، والملف الذي يتجاوز الحد بالرمز 413، والرفع المتكرر بمفتاح واحد خلال ساعة بالرمز 429. ولا يُقبل في هذا العنوان إلا مفتاح مرسل في ترويسة، ولا يُقبل تسجيل الدخول في التطبيق أبدًا.

الحدود والأمان

• لكل ملف حد للحجم وحد لعدد الصفوف، يُذكران في الرسالة عندما يتجاوزهما الملف. صدّر حينها فترة أقصر.
• تُرفض الخلايا التي تبدأ صيغة جدول بيانات، مثل =SUM(A1:A2) أو @cmd، ولا تُحفظ ولا تُشغَّل أبدًا.
• يُفحص نوع الملف من محتواه، لا من اسمه فقط. وتُرفض الأسطر الطويلة جدًا، والمصنفات المضغوطة التي تتمدد أكثر من اللازم، والمصنفات التي تحتوي وحدات ماكرو.
• لا تقرأ كل مؤسسة ولا تكتب إلا في دفيئاتها.

ملف نموذجي

جرّب الصفحة باستخدام ملف التصدير النموذجي هذا. يحتوي يومًا مختلَقًا بخطوات من عشرين دقيقة، مع فواصل منقوطة، وفواصل عشرية، وسطرين من تفاصيل التصدير، وعمودين منفصلين للتاريخ والوقت، وقيم مضبوطة، وعمود للستارة.