Comment créer une équipe en utilisant Fracttal Hub ?

L'intégration avec Fracttal Hub facilite l'incorporation contrôlée de nouveaux équipements sur la plateforme, garantissant que les données suivent une structure standardisée. Ce guide explique comment configurer un flux sécurisé pour créer des équipes dans Fracttal One en utilisant une feuille de calcul comme source de données.

La connexion sera établie en utilisant un Compte de Service (Service Account) de Google Cloud Platform, qui est la méthode recommandée pour les intégrations serveur à serveur, garantissant sécurité et autonomie.

Étape 1 : Configuration dans Google Cloud Platform (GCP)

La première étape consiste à créer les identifiants nécessaires sur la plateforme Google pour permettre à Fracttal One d'accéder à votre feuille de manière sécurisée.

1.1. Accéder au compte de service

• Accédez à la Console de Google Cloud Platform.

• Dans le menu de navigation, allez à APIs et services > Identifiants.

• Cliquez sur + CRÉER DES IDENTIFIANTS et sélectionnez l'option Compte de service.

• Remplissez les champs suivants :
  • Nom du compte de service : Donnez un nom descriptif.
  • ID du compte de service : Généralement généré automatiquement à partir du nom.

• Cliquez sur "Terminé" pour finaliser la création de l'identifiant.

1.2. Générer la Clé d'Accès (JSON)

• Sur l'écran des Identifiants, localisez le compte de service nouvellement créé et cliquez sur son adresse e-mail.
• Allez à l'onglet CLÉS.
• Cliquez sur AJOUTER UNE CLÉ et sélectionnez Créer une nouvelle clé.

• Choisissez le type JSON (recommandé) et cliquez sur CRÉER.

• Un fichier .json sera automatiquement téléchargé sur votre ordinateur. Conservez-le dans un endroit sûr, car il contient les identifiants d'accès et sera nécessaire à l'Étape 3.

Étape 2 : Préparation de la feuille de Google Sheets

Nous allons maintenant préparer la feuille qui servira de source de données.

• Ouvrez votre feuille de Google Sheets.

Structure des en-têtes:
Dans la première ligne, assurez-vous que les noms des colonnes correspondent exactement aux paramètres requis par l'API de Fracttal pour la création d'actifs. Les champs obligatoires sont :

• code : Code unique de l'actif.
• id_type_item : ID numérique du type d'actif (par exemple : 2 pour Équipements, selon la documentation de l'API).
• field_1 : Correspond au Nom de l'actif.

Partager la feuille:
Il est crucial d'accorder l'autorisation d'accès au Compte de Service que nous avons créé.

• Dans GCP, copiez l'e-mail de votre compte de service.

• Retournez à la feuille de calcul, cliquez sur Partager.
• Collez l'e-mail dans le champ de partage.
• Attribuez l'autorisation de Éditeur.

• Cliquez sur Envoyer/Partager.

  

Étape 3 : Configuration de la connexion dans Fracttal One

Avec les identifiants et la feuille prêts, nous allons configurer le pont de communication dans Fracttal One.

• Dans Fracttal One, naviguez vers Configuration > Catalogues Auxiliaires.

• Dans le sélecteur de catalogues, choisissez Connexions.
• Cliquez sur l'icône + pour ajouter une nouvelle connexion.

Configurez les champs suivants :

• Type : Sélectionnez Google Sheet (Compte de Service).
• Description : Entrez un nom clair pour cette connexion, par exemple, CRÉER ÉQUIPES.

Complétez les identifiants :

Ouvrez le fichier .json téléchargé à l'Étape 1.2 et copiez-collez le contenu de chaque champ dans le formulaire de Fracttal One :

• private_key
• client_email
• client_id
• client_x509_cert_url
• ...et les autres champs requis.

Cliquez sur Enregistrer.

Étape 4 : Créer le flux dans l'Automatisateur (Fracttal Hub)

Enfin, nous allons créer le flux d'automatisation qui lira les données et créera les actifs.

• Allez au menu principal et sélectionnez Automatisateur > Fracttal Hub.

• Cliquez sur l'icône + pour créer un nouveau flux.

• Donnez un nom au flux.

4.1. Configurer la Source (Source)

• Déclencheur

 Pour cet exemple, sélectionnez Manuel. Cela vous permet d'exécuter le flux quand vous le souhaitez.

• Source :

• Module : Sélectionnez GoogleSheet.
• Connexion : Sélectionnez la connexion créée à l'Étape 3 (CRÉER ÉQUIPES).
• Action : Sélectionnez Lire.
• spreadsheet_id : Collez l'ID de votre feuille. Vous pouvez le trouver dans l'URL (le code long entre /d/ et /edit).
• sheet : Entrez 0 pour lire le premier onglet (la numérotation commence à 0).
• Champs : Ajoutez les noms des en-têtes de votre feuille (code, id_type_item, field_1).

4.2. Configurer la Destination (Destination)

• Connexion :

• Module : Sélectionnez Fracttal.
• Connexion : Sélectionnez FRACTTAL HUB.
• Action : Sélectionnez Mettre à jour ou créer un actif.

• Configuration

• Cliquez sur l'icône d'engrenage (Configuration).
• Mappez les champs source (Google Sheet) avec ceux de destination (API de Fracttal), en vous assurant qu'ils correspondent :

• Cliquez pour enregistrer le mappage puis sur Enregistrer dans le coin supérieur droit pour enregistrer tout le flux.