Fracttal Hub permet d'associer des actifs à des plans de maintenance de manière massive à partir de Google Sheets. Pour que le chargement soit valide, l'actif ne doit pas être lié à un autre plan, il doit s'agir d'un emplacement, d'un équipement ou d'un outil, et le plan ne peut pas inclure d'activateurs ni de sous-tâches avec des lectures de compteur.
Étape 1 : Accédez à la console Google Cloud
La communication entre Fracttal et Google Sheets est effectuée de manière sécurisée via un compte de service.
Accédez à la console Google Cloud.
- Dans le menu de navigation, allez à IAM et administrateur > Comptes de service.
- Cliquez sur + CRÉER UN COMPTE DE SERVICE.
Attribuez un nom au compte de service qui soit facile à identifier, par exemple :
associer-actif-plan-maintenance.- Cliquez sur TERMINER pour créer le compte sans configurer de permissions supplémentaires.
Étape 2 : Générer et télécharger la clé du compte de service
Pour que Fracttal puisse s'authentifier, il est nécessaire de générer une clé privée pour le compte de service.
Dans la liste des comptes de service, cliquez sur l'adresse e-mail du compte que vous venez de créer.
Allez à l'onglet CLÉS.
- Cliquez sur AJOUTER UNE CLÉ et sélectionnez Créer une nouvelle clé.
- Choisissez le type de clé JSON et cliquez sur CRÉER.
Un fichier
.jsonsera automatiquement téléchargé sur votre ordinateur. Conservez ce fichier dans un endroit sûr, car il contient les informations d'identification.
Étape 3 : Partager la feuille de calcul Google avec le compte de service
Vous devez maintenant accorder des permissions au compte de service pour accéder et modifier votre feuille de calcul.
Ouvrez le fichier
.jsonque vous avez téléchargé. Localisez et copiez la valeur du champ"client_email".Ouvrez votre feuille de calcul dans Google Sheets.
Cliquez sur le bouton Partager (en haut à droite).
Collez l'e-mail du compte de service dans le champ de partage.
Assurez-vous d'accorder la permission de Éditeur.
Cliquez sur Envoyer.
Étape 4 : Préparer la feuille de calcul Google Sheets
La première ligne de votre feuille doit contenir les en-têtes (paramètres) exacts que Fracttal s'attend à recevoir.
Accédez à la documentation de l'API Fracttal pour consulter les paramètres nécessaires.
Dans la première ligne, insérez les en-têtes suivants :
id_tasks_plan code_user item_code last_date_maintenance 284558 1928182192 HUB-001 2025-03-12T20:00:00-03 Remplissez les lignes suivantes avec les données correspondantes :
id_tasks_plan : ID du plan de tâches auquel vous souhaitez associer l'actif. Vous pouvez le trouver dans Fracttal.
code_user : Code de l'utilisateur responsable de la transaction. Trouvez-le dans Catalogues > Ressources Humaines.
item_code : Code de l'actif (équipement, emplacement, etc.) que vous souhaitez lier. Trouvez-le dans Catalogues > Actifs.
last_date_maintenance : Date de la dernière maintenance.
Important : Le format de la date
last_date_maintenancedoit êtreAAAA-MM-DDTHH:MM:SS-UTC.
Copiez le format depuis la documentation de l'API pour éviter les erreurs.
Étape 5 : Créer la connexion dans Fracttal One
Nous allons maintenant configurer la connexion dans Fracttal pour qu'il puisse utiliser les informations d'identification du compte de service.
- Dans Fracttal, naviguez jusqu'à Configuration > Catalogues Auxiliaires > Connexions.
- Cliquez sur l'icône + pour ajouter une nouvelle connexion.
- Remplissez les champs suivants :
Type : Sélectionnez Google Sheet (Compte de service).
- Description : Donnez un nom à la connexion :
Ouvrez le fichier
.jsontéléchargé et copiez/collez le contenu des champs suivants à leurs emplacements respectifs dans le formulaire Fracttal :
private_keyclient_emailclient_idclient_x509_cert_url
Cliquez sur l'icône ✓ pour enregistrer et ensuite sur Enregistrer.
Étape 6 : Configurer le flux dans Fracttal Hub
Avec la connexion prête, la dernière étape consiste à créer le flux d'automatisation.
- Naviguez jusqu'au module Fracttal Hub.
- Cliquez sur l'icône + pour créer un nouveau flux.
- Ajoutez une Description pour le flux :
Configuration de l'activateur :
Cliquez sur Activateur 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
0pour lire le premier onglet.Champs : Ajoutez les noms des colonnes : description, item_code, unit_code, is_counter.
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 Compteur.
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 :
Étape 7 : Exécuter et vérifier le flux
- Cliquez sur Enregistrer pour sauvegarder la configuration du flux.
- Activez l'interrupteur Activé.
- Cliquez à nouveau sur Enregistrer.
Cliquez sur le bouton Exécuter pour démarrer le processus.
Vous pouvez surveiller la progression 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.
Pour vérifier, allez à Tâches > Plan de Tâches, sélectionnez le plan correspondant et, dans l'onglet Actifs Liés, vous verrez l'actif qui a été associé via la feuille de calcul.
Remarques :
Cette méthode est compatible uniquement avec des plans de tâches basés sur fréquence (date). Elle n'est pas compatible avec des plans ayant des activateurs par lecture de compteur.
Vous pouvez ajouter plusieurs lignes dans votre feuille Google Sheets pour associer plusieurs actifs à un ou plusieurs plans à la fois.