Home › Échange de données

Échange de données

Comment le processus d’échange de données s’articule avec vos processus métier 

BEACON modélise numériquement les services d’eau en créant des entrées de base de données qui relient ou fournissent un compte, un emplacement et un point de service à la technologie de comptage qui y est installée, généralement un compteur et, le cas échéant, un terminal AMI ou AMR pour la collecte et la transmission des données d’utilisation et d’exploitation.

Pour réaliser cette modélisation, nous utilisons des fichiers CSV (valeurs séparées par des virgules) afin de transférer les informations issues de vos systèmes de facturation et autres systèmes d’information vers BEACON. Ces fichiers CSV sont des feuilles de calcul au format texte dans lesquelles chaque colonne identifie le type d’informations et chaque ligne contient les données correspondantes pour un dossier ou un service individuel.

Cette structure vous permet de configurer, mettre à jour et réviser des informations à grande échelle. Que vous ayez besoin de mettre à jour un seul service ou des dizaines de milliers de services, le processus d’échange de données prend en charge vos processus opérationnels quotidiens, de la facturation des clients aux emménagements et déménagements résidentiels et commerciaux, en passant par les changements de compteurs et de points de terminaison et le suivi de la consommation.

Spécifications relatives à l’échange de données 

Le terme « spécifications relatives à l’échange de données » désigne un ensemble de spécifications qui définissent précisément les noms des colonnes, les limites de caractères et les règles de formatage pour l’importation, la synchronisation et la mise à jour des données utilitaires dans BEACON. Une version téléchargeable de la spécification d’échange de données est disponible ici.

La spécification d’échange de données comprend des champs permettant de collecter et de conserver les informations suivantes :

Comptes – identifiant, nom et coordonnées du titulaire du compte, adresse de facturation, etc.

Emplacements – ID, adresse du point de raccordement, données de géolocalisation pour le compteur / point de raccordement et autres détails concernant l’emplacement tels que le nombre d’occupants, les valeurs d’évapotranspiration, la présence d’une piscine à l’emplacement, etc.

Points de raccordement – ID utilisé pour distinguer des raccordements multiples à un seul emplacement (par exemple, un endroit avec un compteur pour l’eau potable et un compteur différent pour l’irrigation), données de géolocalisation (utilisés pour une précision accrue lorsqu’il y a plus d’un point de raccordement à un seul emplacement), numéro de tracé, etc.

Compteurs – numéro de série, fabricant, modèle, taille, balise attendue de débit continu/intermittent, unité de mesure, résolution, date d’installation, date de retrait, etc.

Contrats de service – ID, dates de début et de fin de service.

Configurations de points de terminaison – numéro de série, type, date d’installation et date de retrait.

Relevés AMR et manuels – séquence de lecture, codes d’alerte et limites de lecture haute/basse pour les compteurs.

BEACON utilise différents types de fichiers d’échange de données, chacun ayant sa propre structure définie, et détecte automatiquement le type de fichier en fonction des colonnes présentes dans un fichier donné.

Comptes et fichiers de ressources – le type de fichier que vous utiliserez le plus souvent, ces fichiers servent à créer de nouveaux comptes, à fournir et échanger des compteurs et des points de terminaison, à transmettre des balises et d’autres données essentielles depuis vos systèmes de facturation et d’information vers BEACON. Consultez la Terminologie pour une ventilation complète des champs disponibles dans ce type de fichier d’échange de données.

Fichiers de mise à jour des identifiants – utilisez ce type de fichier lorsque vous changez de fournisseur de services de facturation et que vous souhaitez mettre à jour ou modifier votre compte, votre emplacement, votre point de service et vos identifiants de compteur. Les fichiers de mise à jour des identifiants effectuent une recherche globale et un remplacement des champs clés, évitant ainsi les services dits « orphelins » qui résultent d’une transmission incorrecte des nouveaux identifiants à BEACON sans modification des anciens identifiants. Consultez Mettre à jour les identifiants pour obtenir plus de détails. 

Relevés d’intervalles de compteur – ces fichiers vous permettent d’importer les intervalles de relevés recueillies à l’aide des solutions AMR et AMI de Badger Meter, ainsi que de tiers. Pour obtenir plus de détails, consultez Importation de relevés d’intervalles de compteur. 

Relevés du compteur de facturation – utilisez ce type de fichier pour importer les relevés de facturation actuels et historiques. Pour une meilleure compréhension, consultez « Importer les relevés de compteur de facturation. » 

Exportations de relevés de facturation – ces fichiers définissent la sortie de relevé de facturation de BEACON. Consultez la spécification d’exportation du relevé de facturation pour obtenir plus d’informations. REMARQUE : Nous recommandons vivement de travailler avec notre équipe des services logiciels lors de la configuration de vos fichiers d’exportation de relevé de facturation.

Fichiers d’exportation configurés – utilisés pour les systèmes de facturation qui ne prennent pas en charge les fichiers de facturation au format CSV, notre équipe des services logiciels vous aidera à configurer vos fichiers d’exportation au format C ou D afin qu’ils soient compatibles avec votre logiciel de facturation.


Avertissements et exceptions

Quel que soit le type de fichier, BEACON génère des erreurs et des avertissements lorsqu’il rencontre des problèmes lors de l’importation de fichiers. Pour assurer un échange de données précis, passez en revue le rapport d’exceptions créé pendant le processus d’importation pour dépanner et corriger les fichiers avant de passer à l’importation. Consultez les FAQ sur les erreurs d’échange de données et les avertissements d’échange de données pour obtenir des informations essentielles sur la gestion des exceptions. Gardez à l’esprit que les erreurs empêchent le traitement d’un fichier ou d’un enregistrement spécifique dans un fichier.

Considérez les avertissements comme des notifications qui vous informent d’une action imminente. Si c’est bien l’action que vous souhaitiez effectuer, vous pouvez procéder à l’importation en toute sécurité. Si l’action n’était pas celle que vous souhaitiez, vous pouvez apporter les modifications appropriées avant de continuer. 


Manipuler avec précaution 

Avant de manipuler votre premier fichier CSV, veuillez lire Fichiers CSV et Excel et suivre les instructions afin de préserver la fidélité de vos données. 

Informations essentielles

Taille minimale du fichier d’importation – Les fichiers d’importation peuvent comporter seulement deux lignes : une pour les noms de colonnes (également appelés en-têtes de colonnes) et une seconde pour les données associées à chaque colonne du fichier.

Taille maximale du fichier d’importation – 70 Mo. 

Taille maximale du fichier d’exportation – Un maximum de 1 048 576 enregistrements (1 024*1 024) peut être renvoyé lors d’une seule opération d’exportation.

Délimiteurs – BEACON prend en charge les délimiteurs suivants, par ordre de priorité : virgules, tabulations, points-virgules, deux-points, barres verticales, tildes. 

Les extensions de fichiers prises en charge – incluent : .csv, .txt, .dat et .a. D’autres formats qui ne transmettent pas d’informations sur la mise en forme du fichier devraient également fonctionner.

 

Champs minimums
Les champs minimums requis pour effectuer diverses opérations dans BEACON dépendent de s’il s’agit d’une configuration (également appelé approvisionnement) d’un service pour la première fois ou de la mise à jour à jour d’un service existant.  

Pour approvisionner un service, c’est-à-dire associer un compte, un emplacement et son ou ses points de service à un compteur et, le cas échéant, à un point de terminaison AMI ou AMR, vous devez importer au minimum les champs suivants lors de la première utilisation :

Account_ID, Location_ID, Meter_ID, Endpoint_SN et Endpoint_Point_Type, ainsi que Meter_Size, Register_Unit_of_Measure et Register_Resolution. Voir Terminologie pour une description détaillée de ces champs et de tous les autres champs de la spécification relative à l’échange de données dans les comptes et les ressources.

Si le service existe déjà ou si vous avez précédemment approvisionné un point de terminaison AMI ou AMR particulier, BEACON se souviendra son Endpoint_Type. De même, BEACON se souvient de Meter_Size, Register_Unit_of_Measure et Register_Resolution lorsque le compteur a déjà été approvisionné. 

Si possible, veuillez indiquer les dates dans vos fichiers. C’est-à-dire Service_Agreement_Start_Date, Meter_Install_Date, Endpoint_Install_Date et, le cas échéant, Service_Agreement_End_Date, Meter_Removal_Date et Endpoint_Removal_Date. Si votre système de facturation ne prend pas en charge la possibilité de fournir des dates, BEACON utilisera les dates par défaut. Pour plus de détails, consultez Terminologie.

Le nombre minimum de champs obligatoires varie en fonction des données que vous téléversez. Par exemple, les relevés de facturation, les relevés d’intervalles de compteur et les autres opérations. Vous trouverez les exigences relatives à chaque opération dans les pages d’aide correspondant à ces spécifications d’échange de données. 

Importation des meilleures pratiques
Les services publics proposant moins de 10 000 services peuvent téléverser en toute confiance les enregistrements de tous leurs services dans un seul fichier d’échange de données.

Le téléversement des deltas – Fichiers d’échange de données qui contiennent uniquement les enregistrements relatifs aux services ayant fait l’objet de modifications récentes (deltas), tels que les changements de compteurs et de points de terminaison, les modifications du statut des comptes, etc.) est recommandé pour les services publics de toutes tailles.

Certains services publics téléversent les deltas tout au long de la semaine et téléversent périodiquement les enregistrements pour tous leurs services, par exemple une fois par mois ou une fois par semaine. Cela permet de garantir que les comptes et services nouveaux ou modifiés qui ont été accidentellement omis lors de votre processus de mise à jour seront mis à jour. 

Lorsque vous changez de fournisseur de services de facturation, utilisez toujours les fichiers de mise à jour d’identifiants pour mettre à jour les identifiants de compte, les identifiants d’emplacement, les identifiants de point de service et les identifiants de compteur. Effectuer de telles modifications sans utiliser un fichier de mise à jour d’identifiants peut rompre, et rompt effectivement, le lien entre les adresses e-mail des clients et l’identifiant de compte qui permet à vos clients d’accéder au portail Web EyeOnWater et aux applications pour téléphone intelligent. 

Échange de données approfondi
Les sections suivantes du BEACON Integration Hub vous aideront à synchroniser vos systèmes CIS et de facturation avec BEACON à l’aide de fichiers d’échange de données. 

 

 

Knowledge Base

 

 

Knowledge Base Archive

User Guide
Follow via Email

Enter your email address to get new content notifications by email.