Comment créer et mettre à jour des relevés de compteurs dans Fracttal HUB ?

Avec l'option d'automatisation dans Fracttal Hub, il est possible de gérer la création et la mise à jour des compteurs de manière efficace et sans intervention manuelle, notamment dans des contextes de volume de données élevé. Cette fonctionnalité permet aux utilisateurs d'accélérer les processus opérationnels et de minimiser les erreurs humaines dans la gestion des relevés de compteurs.

Vous trouverez ci-dessous un guide étape par étape sur la façon de configurer cette fonctionnalité dans la plateforme Fracttal Hub.

Étape 1 : Accédez à la Console Google Cloud

Accédez à Google Cloud Console.

• Allez à la section API et services > Identifiants.

• Cliquez sur Créer des identifiants > Compte de service.

  

   

• Nommez le compte de service "créer_compteurs" et suivez le processus jusqu'à la fin.

Étape 2 : Générer la clé JSON

1. Une fois le compte de service créé, sélectionnez-le dans la liste.

   

2. Accédez à la section Clés. Cliquez sur Ajouter une clé > Créer une nouvelle clé.

   

3. Sélectionnez le format JSON.

   

4. Enregistrez le fichier généré dans un emplacement sûr ; ce fichier sera nécessaire pour configurer l'intégration dans Fracttal Hub.

Étape 3 : Préparer la feuille de calcul (Google Sheets)

Maintenant, nous allons préparer la feuille de calcul qui servira de source de données pour la création des compteurs.

1. Créez une nouvelle feuille de calcul dans Google Sheets.
2. Donnez-lui un nom descriptif, comme CRÉER COMPTEUR.
3. Dans la première ligne, définissez les en-têtes des colonnes. Celles-ci doivent correspondre aux paramètres requis par l'API de Fractal. Pour cet exemple, nous utiliserons les champs obligatoires suivants et un champ optionnel :
   • Colonne A : description (Description du compteur, ex : "Compteur de KM").
   • Colonne B : item_code (Code de l'actif auquel le compteur sera associé, ex : "HUB-004").
   • Colonne C : unit_code (Code de l'unité du compteur, ex : "KM". Ce code doit exister au préalable dans Configuration > Catalogues Auxiliaires > Unité).
   • Colonne D : is_counter (Optionnel, mais recommandé. Indique si le compteur est un accumulateur. Écrivez TRUE si c'est le cas, ou FALSE si ce n'est pas le cas).
4. Remplissez les lignes avec les informations des compteurs que vous souhaitez créer.
5. Partager la feuille de calcul : C'est une étape cruciale.
   • Copiez l'adresse e-mail du compte de service que vous avez créé à l'Étape 1 (vous la trouverez dans le fichier .json dans le champ client_email).
   • Cliquez sur le bouton Partager dans votre feuille de calcul.
   • Collez l'e-mail du compte de service et attribuez-lui des permissions de Éditeur.

• Cliquez sur Envoyer.

Étape 4 : Créer la connexion dans Fracttal One

Nous allons maintenant configurer la connexion dans Fracttal afin que vous puissiez utiliser les identifiants du compte de service.

1. Dans Fracttal, naviguez jusqu'à Configuration > Catalogues Auxiliaires > Connexions.
2. Cliquez sur l'icône + pour ajouter une nouvelle connexion.
3. Remplissez les champs suivants :

• Type : Sélectionnez Google Sheet (Compte de service).

• Description : Attribuez un nom à la connexion :

4. Ouvrez le fichier .json téléchargé et copiez/collez le contenu des champs suivants dans leurs emplacements respectifs du formulaire Fracttal :

• private_key

• client_email

• client_id

• client_x509_cert_url

5. Cliquez sur l'icône ✓ pour enregistrer puis sur Enregistrer.

Étape 5 : Configurer le flux dans Fracttal Hub

Avec la connexion prête, la dernière étape consiste à créer le flux d'automatisation.

1. Naviguez jusqu'au module Fracttal Hub.
2. Cliquez sur l'icône + pour créer un nouveau flux.
3. Ajoutez une Description pour le flux :

Configuration du déclencheur :

• Cliquez sur Déclencheur et sélectionnez le type Manuel. Cela permet d'exécuter le flux quand vous le souhaitez.

Configuration de la Source :

• Cliquez sur Source.

• Module : Sélectionnez GoogleSheet.

• Connexion : Sélectionnez la connexion créée à l'étape précédente.

• Action : Sélectionnez Lire.

• spreadsheet_id : Copiez l'ID de votre feuille de calcul (vous le trouvez dans l'URL, entre /d/ et /edit/).

• sheet : Écrivez 0 pour lire le premier onglet.

• Champs : Ajoutez les noms des colonnes : 

Configuration de la Destination :

• Cliquez sur Connexion dans la section de destination.

• Module : Sélectionnez Fracttal.

• Connexion : Choisissez FRACTTAL HUB.

• Action : Sélectionnez Créer Compteurs.

Configuration des champs (mappage) :

• Cliquez sur Configuration dans la section de destination.

• Mappez les champs de la feuille (Source) avec ceux du système (Destination), en vous assurant qu'ils correspondent :

description ⟵ description

item_code ⟵ item_code

unit code ⟵ unit_code

is_counter ⟵ is_counter
 

Cliquez sur Enregistrer pour sauvegarder la configuration du flux.

Étape 7 : Exécuter et vérifier le flux

1. Activez l'interrupteur Activé.

2. Cliquez à nouveau sur Enregistrer.

3. Cliquez sur le bouton Exécuter pour démarrer le processus.

Vous pouvez suivre l'avancement dans les onglets File d'attente des événements et Historique des Exécutions. Un processus réussi affichera "Processus Réalisé" et marquera comme complètes les étapes d'Extraction, de Transformation et de Chargement.