Intégration des logiciels de gestion de l’irrigation : relier capteurs, unités et identifiants de parcelle
L’intégration d’un logiciel de gestion de l’irrigation réussit lorsque chaque valeur reçue conserve son sens : quelle grandeur a été mesurée, par quel capteur, où, dans quelle unité et à quel moment. Une connexion qui transmet correctement des nombres peut néanmoins affecter une mesure profonde à un canal superficiel ou rattacher les mesures de la saison précédente à une parcelle récemment divisée. Résolvez ces correspondances avant d’utiliser l’affichage commun pour orienter l’irrigation.
Des thermomètres infrarouges sans fil mesurent la température des plantes pour la programmation de l’irrigation. La photographie montre des instruments de terrain, pas des sondes d’humidité du sol ni une intégration logicielle démontrée. Photo : Plant Stress and Germplasm Development Unit, USDA Agricultural Research Service.
Ce guide présente un dictionnaire de données pratique, un exercice original de correspondance des enregistrements et un historique de remplacement de capteur. Les noms de champs et les données sont des exemples proposés, pas une spécification du logiciel IrriNex ni une affirmation selon laquelle une plateforme les appliquerait automatiquement.
1. Définir la mesure avant de choisir le champ correspondant
Commencez par un enregistrement réel de chaque source. Demandez à l’installateur ou au fournisseur du logiciel d’expliquer chaque champ utilisé par l’application destinataire. Une étiquette comme « humidité » ne suffit pas : la teneur en eau volumique, la tension de l’eau et l’indice relatif d’un fournisseur décrivent des grandeurs différentes. Changer l’intitulé d’une colonne ne permet pas de les combiner.
La norme OGC SensorThings API Part 1: Sensing, version 1.1 distingue la propriété observée, le capteur, les observations et l’entité observée. La description d’un flux de données comprend une unité explicite. C’est une référence utile pour séparer les significations ; elle ne prouve pas que les produits existants de l’exploitation prennent en charge cette norme.
Consignez le système source, le périmètre du compte, l’identifiant de l’appareil, le canal, la grandeur, l’unité, la position de mesure et les indicateurs de qualité disponibles. Conservez les identifiants sous forme de chaînes de caractères lorsque leur format compte. Un appareil nommé « 007 » ne doit pas devenir silencieusement un autre appareil nommé « 7 ». Aucun de ces identifiants n’est nécessairement unique entre des comptes clients distincts.
Déterminez si chaque valeur est un échantillon instantané, une moyenne sur un intervalle, une quantité sur un intervalle ou un compteur cumulatif. Conservez, si nécessaire, l’intervalle et la statistique de mesure. Le guide d’interprétation des impulsions de débitmètre traite du calcul en amont ; cette intégration en préserve le sens établi.
2. Séparer l’identité de la parcelle, le point de mesure et l’appareil physique
Attribuez à une parcelle gérée un identifiant stable, indépendant de son nom affiché. Conservez un identifiant distinct pour le point de mesure, qui décrit la position et la profondeur observées, puis associez le capteur physique installé et son canal à ce point pendant une période définie. Une adresse de passerelle ou un numéro de série ne doit pas devenir la seule description conservée du sol échantillonné.
| Groupe d’enregistrements | Champs à conserver | Sens à vérifier |
|---|---|---|
| Identité de la source | source_system, account_id, source_device_id, channel_id | Le canal source exact, avec le périmètre d’unicité de son identifiant |
| Identité de l’observation | source_record_id, source_revision | L’identité d’une mesure et toute correction documentée |
| Affectation à la parcelle | field_id, boundary_version, valid_from, valid_to | La zone gérée que l’affectation décrivait à cette date |
| Point de mesure | point_id, coordinates, coordinate_reference, depth | L’endroit auquel la mesure s’applique et la référence de profondeur utilisée |
| Capteur installé | sensor_instance_id, serial, installation_period, calibration_version | L’instrument physique et l’interprétation alors applicables |
| Grandeur et valeur | observed_property, raw_value, raw_unit, normalized_value, normalized_unit | La grandeur avant et après une conversion documentée |
| Temps et qualité | measured_at, result_generated_at, received_at, quality, mapping_version | La chronologie, l’aptitude à l’utilisation et l’historique de traitement de l’observation |
Une parcelle et une zone d’irrigation ont également des identités distinctes. Une vanne peut alimenter une partie de parcelle ou plusieurs secteurs, et ces relations peuvent changer. Gérez séparément la relation entre zone et parcelle, avec sa période d’effet, sans supposer que des noms identiques établissent des limites identiques.
Si une parcelle est divisée, conservez l’ancienne version des limites et créez les nouvelles identités ou les relations de succession documentées. Ne réaffectez pas les anciennes mesures au plan actuel sans préserver l’affectation d’origine. Les coordonnées nécessitent un système de référence et un ordre déclarés ; un point placé à un endroit plausible peut tout de même être mal localisé.
Confirmez la profondeur et la position avec l’équipe de terrain. Le guide de placement des capteurs d’humidité du sol explique leur influence sur l’interprétation. Une correspondance logicielle correcte ne rend pas une sonde représentative de toute une parcelle hétérogène.
3. Normaliser les unités sans perdre la valeur d’origine
Choisissez une unité de réception documentée pour chaque grandeur et conservez la valeur brute à côté. Précisez la formule de conversion et la version de correspondance. Une option de formatage du tableau de bord ne prouve pas que les valeurs stockées ou les calculs en aval ont changé de façon cohérente.
Dans un exemple inventé, supposons que la source A indique explicitement une teneur en eau volumique sous forme de fraction en m³/m³, tandis que la source B indique explicitement la même grandeur en pourcentage volumique. Alors 0.275 m³/m³ × 100 = 27.5 % en volume, et 27.5 ÷ 100 = 0.275 m³/m³. Ce sont des représentations équivalentes en unités différentes, pas une cible culturale ni une preuve d’accord entre instruments.
Appliquer deux fois le facteur transformerait 27.5 en 0.00275 m³/m³, soit une valeur 100 fois plus petite que la valeur normalisée correcte. Ce nombre reste dans une large plage de fractions non négatives ; un simple contrôle de plage manquerait donc l’erreur. Testez des couples entrée-sortie connus, en plus des limites plausibles.
N’appliquez pas cette conversion à une teneur en eau massique, à un potentiel matriciel ou à un indice en pourcentage non documenté. Passer d’une grandeur physique à une autre peut nécessiter d’autres informations ou un modèle. Consignez une unité inconnue comme non résolue au lieu d’emprunter le réglage d’un canal voisin.
Préservez également le sens du zéro. Une quantité de pluie nulle mais valide diffère d’une mesure absente ; une teneur en eau du sol nulle peut justifier une vérification, mais ne doit pas être fabriquée à partir d’une cellule vide. Appliquez une validation propre à la grandeur et conservez les informations de qualité du fournisseur.
4. Stocker l’heure de mesure séparément de l’heure d’arrivée
Précisez quelle horloge a créé chaque horodatage. L’heure de mesure décrit le moment auquel l’observation s’applique. L’heure de génération du résultat décrit quand celui-ci a été produit, éventuellement après traitement. L’heure de réception décrit l’arrivée au service d’intégration. Le champ resultTime de l’OGC n’est pas un synonyme général de l’heure de réception par le serveur.
Utilisez une représentation convenue, avec une référence UTC ou un décalage numérique explicite. La RFC 3339 de l’IETF, publiée en juillet 2002, définit un format d’horodatage Internet et explique les décalages numériques. Conservez l’horodatage et le décalage d’origine lors de la normalisation en UTC, et documentez le fuseau de l’exploitation utilisé pour l’affichage local et les rapports journaliers.
Pour les enregistrements fictifs ci-dessous, 2026-08-20T08:00:00-07:00 et 2026-08-20T10:00:00-05:00 représentent tous deux 2026-08-20T15:00:00Z. Des heures affichées différentes ne désignent pas nécessairement des instants différents. À l’inverse, une heure locale répétée lors d’un changement saisonnier nécessite un décalage sans ambiguïté ou une autre interprétation vérifiée.
N’ajoutez pas Z à un horodatage local dont le décalage est inconnu : cela déclare une heure UTC sans l’avoir établie. Conservez l’enregistrement ambigu en attente de résolution. Certaines interfaces attribuent l’heure du serveur lorsqu’aucune heure de mesure n’est fournie, notamment selon le comportement documenté de SensorThings. Un import réussi ne prouve donc pas qu’une véritable heure de mesure sur le terrain a été transmise.
Définissez les périodes de rapport avec des instants explicites de début inclus et de fin exclue. Pour une journée locale d’irrigation, déduisez ces bornes des règles du fuseau applicable ; ne supposez pas que tous les jours calendaires locaux comportent le même nombre d’heures écoulées. Il s’agit d’interpréter les enregistrements, pas de modifier le programme d’arrosage du contrôleur.
5. Tester les doublons, les valeurs absentes et les enregistrements contradictoires
Convenez de la clé d’observation avec le fournisseur source. Elle peut combiner système source, compte et identifiant d’enregistrement ; si les identifiants ne sont uniques qu’au sein d’un flux, incluez ce flux. L’horodatage et la valeur numérique seuls ne suffisent pas : des sondes différentes peuvent produire des valeurs identiques au même instant.
Les six lignes reçues suivantes sont des tests d’adaptateur inventés. Supposons que les identifiants soient uniques dans chaque compte source nommé, que A:901 appartienne au point P-A et B:901 à un autre point, P-B. La dernière ligne répète A:901 avec une valeur modifiée, sans révision corrective documentée. Aucun enregistrement de ce tableau ne représente une mesure réelle de terrain.
| Ligne reçue | Contenu source | Résultat attendu de l’intégration |
|---|---|---|
| A:901 | 0.275 m³/m³ à 08:00-07:00 à la date indiquée | Une observation acceptée en P-A, à 15:00Z, normalisée à 0.275 m³/m³ |
| A:901 répété à l’identique | Même identité d’observation et même contenu | Réception en double ; ne pas ajouter une nouvelle mesure |
| B:901 | 27.5 % en volume à 10:00-05:00 à la date indiquée | Une observation distincte en P-B, à 15:00Z, normalisée à 0.275 m³/m³ |
| A:902 | Résultat absent avec un indicateur de qualité invalide | Conserver l’enregistrement invalide ; ne pas lui substituer un zéro numérique |
| A:903 | 0.280 m³/m³ avec l’heure locale 08:30 sans décalage établi | Maintenir l’heure non résolue en attente ; ne pas deviner sa position UTC |
| Copie contradictoire de A:901 | 0.310 m³/m³ sous l’identité existante, sans révision | Préserver les deux contenus et signaler un conflit ; aucun écrasement silencieux |
Avant l’arrivée du conflit, l’exercice contient deux observations distinctes acceptées, une réception en double, un enregistrement invalide et un enregistrement à heure non résolue. La sixième ligne impose de marquer l’observation A:901 existante comme contestée et de l’exclure, jusqu’à résolution, des usages exigeant une valeur non contestée. Elle ne doit pas devenir une troisième mesure indépendante.
Un nouvel import du même lot inchangé doit laisser l’ensemble des mesures acceptées inchangé, tout en conservant les preuves de réception nécessaires. Testez les enregistrements corrigés selon une politique explicite de révision. Les enregistrements tardifs peuvent mettre à jour un affichage historique, mais le recalcul éventuel d’une recommandation passée doit être documenté séparément.
Cet exercice teste le sens et l’identité, pas la performance de transmission du réseau. Le comparatif de connectivité pour l’irrigation traite des voies de communication et des mesures d’arrivée. Une connexion réussie ne résout pas une observation ambiguë.
6. Remplacer les capteurs sans réécrire le passé
Ne conservez un point de mesure permanent que si sa signification reste appropriée. Remplacer une sonde défaillante à la même position et profondeur vérifiées peut poursuivre l’historique du point, mais le nouvel instrument physique nécessite sa propre identité, sa période d’installation et son dossier d’étalonnage. Déplacer la sonde dans un autre sol ou à une autre profondeur exige un nouveau point ou une modification explicite de la définition de mesure.
Pour un remplacement fictif distinct au point P-A le 2026-08-21, supposons que le capteur OLD soit affecté jusqu’à 14:00Z, borne exclue, et que NEW prenne effet à 15:00Z, borne incluse. Il s’agit de bornes d’installation documentées pour cet exemple, pas d’horaires d’entretien recommandés.
| Mesure ou période | Information d’arrivée | Affectation historique |
|---|---|---|
| Mesure de OLD à 13:45Z | Arrivée tardive à 15:20Z | Conserver OLD et son étalonnage applicable ; l’arrivée après remplacement ne modifie pas l’affectation |
| 14:00Z à 15:00Z | Aucun capteur installé n’est affecté dans cet exemple | Préserver l’interruption d’installation de 60 minutes ; ne pas fabriquer de continuité |
| Mesure de NEW à 15:00Z | Arrivée à 15:01Z | Conserver NEW et son étalonnage applicable sous le point P-A maintenu |
Vérifiez à la fois l’identité du capteur physique et l’affectation effective à l’heure de mesure. Un message retardé de OLD ne peut pas être transformé en observation de NEW simplement parce que le registre actuel des appareils a changé. Examinez les affectations qui se chevauchent ou les mesures hors de la période d’installation déclarée.
Montrez la limite de remplacement et d’étalonnage dans les analyses de tendance. Un saut de la série peut refléter des différences d’instrument ou d’installation plutôt qu’un changement brutal de l’eau du sol. Conservez les observations originales ; si une correction autorisée est justifiée, gardez sa méthode et sa révision au lieu d’écraser l’unique copie historique.
7. Approuver la correspondance à partir d’un petit jeu d’enregistrements contrôlé
Demandez au responsable de l’exploitation, à l’agronome et au spécialiste de l’intégration d’examiner ensemble un jeu d’essai. Incluez chaque grandeur et unité requise, plusieurs parcelles, une modification de limites, un remplacement et les cas exceptionnels ci-dessus. Suivez certains enregistrements sources à travers la normalisation jusqu’à l’affichage final, en vérifiant point, profondeur, heure, valeur et qualité.
Utilisez un environnement d’essai sans commande des équipements ou une copie historique autorisée. Consignez l’entrée, le résultat attendu, le résultat obtenu, la version de correspondance, le problème non résolu et le réviseur. Un changement de libellé de parcelle ne doit pas déplacer les anciennes mesures ; un canal inconnu doit rester non résolu plutôt que d’être affecté à une parcelle par défaut.
Approuvez la correspondance des observations avant d’autoriser les usages qui en dépendent. Si les données alimentent une alerte, vérifiez dans cette conception distincte le traitement des enregistrements invalides, contestés et non résolus. La fiche de conception des alarmes d’irrigation traite des seuils et des réponses ; cet exercice fournit des entrées correctement identifiées.
Retestez les cas concernés après une modification d’API, de micrologiciel, d’étalonnage ou d’affectation de parcelle. Conservez la version précédente de correspondance avec sa période d’effet. Le résultat utile est un parcours traçable de l’enregistrement source à la bonne observation de parcelle, avec une incertitude toujours visible.
8. Questions fréquentes
Puis-je joindre des enregistrements à partir du nom de la parcelle ?
Utilisez plutôt un identifiant stable et une affectation avec sa période d’effet. Les noms peuvent changer ou être réutilisés, et les limites actuelles peuvent différer de celles pertinentes pour les anciennes observations.
Toutes les valeurs d’humidité du sol doivent-elles avoir la même unité ?
Des grandeurs compatibles peuvent partager une unité normalisée documentée. Confirmez d’abord ce que chaque capteur mesure. Un indice en pourcentage ou une mesure de tension ne devient pas une teneur en eau volumique par un changement d’étiquette.
Le remplacement d’un capteur impose-t-il de supprimer l’ancien canal ?
Conservez l’ancien instrument et ses observations. Associez le remplaçant au point de mesure approprié pendant sa propre période d’effet, gardez les informations d’étalonnage et marquez explicitement toute interruption d’installation ou modification du sens de l’échantillonnage.
