Importer les données de votre ordinateur climatique

Exportez une période depuis votre ordinateur climatique et importez-la dans Relevés, Import climatique. DeepLeaf Yield vérifie le fichier, montre ce qu’il a lu et enregistre une valeur par heure, consignes de température comprises. Aucun compte chez le fabricant de l’ordinateur climatique n’est nécessaire.

Schéma : l’export de l’ordinateur climatique est vérifié, le producteur confirme les colonnes et l’import enregistre une valeur par heure. Un script à vous peut envoyer le même fichier avec une clé de l’organisation, et les choix de colonnes enregistrés sont utilisés. — Exporter, vérifier, choisir, importer. Un script à vous peut ensuite envoyer le même fichier.

Ce qui est lu

Les exports CSV, TSV et texte, séparés par des points-virgules, des tabulations ou des virgules, avec un point ou une virgule décimale.
Les classeurs Excel (.xlsx). Seules les valeurs enregistrées sont lues. Un classeur avec des formules ou des macros est refusé, de même que les anciens fichiers .xls et .xlsb : enregistrez la feuille en .xlsx ou en CSV.
Le texte en UTF-8, UTF-16 ou Windows-1252, avec ou sans marque d’ordre des octets.
Des lignes de détails d’export au-dessus de l’en-tête, une ligne d’unités dessous, une colonne date et heure ou des colonnes séparées, des dates jour d’abord ou mois d’abord, et les dates numériques des tableurs.
Des noms de colonnes en anglais, néerlandais, espagnol ou français. DeepLeaf Yield propose le contenu de chaque colonne : température de l’air, consignes de chauffage et d’aération, humidité relative, CO₂, PAR intérieur, rayonnement extérieur, température des tuyaux, position de l’écran, et d’autres.
Des unités comme les °F, les hPa, les µS/cm et le rayonnement cumulé par pas d’enregistrement, converties dans les unités stockées.

Importer un fichier

Ouvrez Import climatique dans l’application et choisissez le cycle de culture.
Déposez l’export sur la page, ou appuyez sur Choisir un fichier. Rien n’est encore enregistré.
Lisez Ce qui sera importé : l’encodage et les séparateurs du fichier, l’horloge de lecture, les consignes trouvées et les premières heures telles qu’elles seront enregistrées.
Sous Colonnes, vérifiez ce que chaque colonne contient. Changez la mesure ou l’unité, ou choisissez Non importée pour exclure une colonne. Le fichier est vérifié de nouveau après chaque changement.
Réglez ce qui figure sous Problèmes, comme un ordre des dates ou un changement d’heure. Un fichier qui a des problèmes n’est jamais importé.
Laissez cochée Mémoriser ces choix de colonnes pour cette serre, puis appuyez sur Importer.

Les valeurs sont moyennées par heure ; l’irrigation et le drainage sont additionnés. Réimportez la même période et rien n’est doublé : une heure déjà enregistrée garde sa place et prend la nouvelle valeur si elle a changé. Le résumé indique combien d’heures étaient nouvelles, mises à jour ou inchangées.

Mauvais fichier importé ? Sous Imports récents, sur cette page ou sur Climat dans Relevés, appuyez sur Annuler l’import à côté de lui et confirmez. Les relevés qu’il a ajoutés sont supprimés et les valeurs qu’il a modifiées retrouvent leur valeur précédente ; les relevés qu’il n’a pas changés restent tels quels. Les envois d’un script y figurent aussi. Si un import plus récent a modifié certains des mêmes relevés, DeepLeaf Yield demande d’abord : annulez l’import plus récent, ou annulez celui-ci quand même.

L’horloge du fichier

Les heures sans décalage sont lues dans le fuseau horaire de la serre défini dans Configuration. Sous Horloge du fichier, vous pouvez choisir UTC, un autre fuseau horaire ou un décalage fixe comme UTC+01:00 pour un ordinateur climatique qui reste à l’heure d’hiver toute l’année.

Au passage à l’heure d’hiver, l’heure répétée est lue dans l’ordre des lignes : d’abord l’heure d’été, puis l’heure d’hiver.
Au passage à l’heure d’été, une heure qui n’existe pas sur cette horloge est signalée comme un problème. Choisissez un décalage fixe si l’ordinateur climatique ne change jamais d’heure.
Un relevé mesuré dans le futur, ou antérieur à toute date d’export possible, est aussi signalé comme un problème.

Consignes

Les consignes de chauffage, d’aération ou de température unique sont enregistrées comme des valeurs à part, jamais comme température de l’air : une consigne ne peut donc pas être prise pour une mesure. Elles permettent à la prévision d’utiliser la température prévue pour les semaines à venir plutôt qu’une hypothèse fixe. Un export futur qui contient les consignes prévues est lu de la même façon.

Envoi automatique

Un script ou une automatisation à vous peut envoyer le même export avec une clé de l’organisation. Créez une clé comme indiqué dans Organisation et clés, et gardez-la hors des dossiers partagés. L’envoi utilise les choix de colonnes mémorisés pour la serre : importez donc d’abord un fichier dans l’application.

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"

Pour un classeur, envoyez Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. Ajoutez l’horloge à l’adresse quand ce n’est pas le fuseau horaire de la serre :

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

La réponse indique les heures enregistrées. Un fichier qui a des problèmes est refusé avec 400 et les mêmes problèmes que dans l’application, un fichier au-delà de la limite avec 413, et trop d’envois d’une même clé en une heure avec 429. Seule une clé envoyée dans un en-tête est acceptée à cette adresse, jamais la connexion de l’application.

Limites et sécurité

Chaque fichier a une limite de taille et une limite de lignes, indiquées dans le message quand un fichier les dépasse. Exportez alors une période plus courte.
Les cellules qui commencent une formule de tableur, comme =SUM(A1:A2) ou @cmd, sont refusées, jamais enregistrées ni exécutées.
Le type du fichier est vérifié d’après son contenu, pas seulement son nom. Les lignes beaucoup trop longues, les classeurs compressés qui se décompressent trop et les classeurs avec macros sont refusés.
Chaque organisation ne lit et n’écrit que ses propres serres.

Fichier d’exemple

Essayez la page avec cet export d’exemple. Il contient une journée inventée, pas de vingt minutes, avec des points-virgules, des virgules décimales, deux lignes de détails d’export, des colonnes de date et d’heure séparées, des consignes et une colonne d’écran.