Connecteur Google Sheets™ avec l’API Helloasso.
Importez, synchronisez et structurez les données issues de l’API Helloasso avec des tableaux Google Sheets™.
Outil clé en main, après installation ouvrez un document Sheets™ allez dans le menu « Extensions » -> « Hellosheets » -> « Configurer la connexion à Helloasso » . L’addon vous demande le nom de votre organisation et vos identifiants pour accéder à l’API Helloasso et vous n’avez plus qu’à importer les données que vous souhaitez.
Sécurité et fiabilité du code
Important : Cet addon ne demande pas l’accès à tous vos documents mais ne sera utilisé sur un document que si vous l’autorisez explicitement en l’utilisant sur le document de votre choix. –> lire la suite
Le processus de validation et de vérification d’un addon chez Google™ est long et rigoureux, vous êtes ainsi assuré de ce que peut faire ou ne pas faire ce code dans votre compte. Il ne fait que des appels à l’API Helloasso, aucun POST donc aucun risque de compromettre vos données chez Helloasso. Le code est exécuté côté client et serveur Google™ donc vous êtes assuré de ne partager vos données avec personne à l’exception de Google™, pas même avec le développeur du module. Pour plus de détails sur les autorisations nécessaires pour faire fonctionner l’addon vous pouvez voir plus de détails en bas de page.
Si certains sont intéressés par cet outil mais ne veulent pas utiliser un service Cloud il serait possible de transformer le code pour en faire une application de bureau mais ce n’est pas à l’ordre du jour.
Développement actuel et en cours
Cet addon est au début de son développement et de nombreuses options sont envisagées, l’objectif à terme étant de pouvoir synchroniser et structurer les données de toutes les manières possibles.
Au stade actuel il permet d’importer et synchroniser/actualiser la totalité des champs possibles par campagne ou par période. L’interface récupère tous les champs disponibles et demande à l’utilisateur lesquels il souhaite importer, il y a une option qui permet de regrouper par blocs d’items vendus sur une campagne spécifique. Lors de son premier lancement l’addon crée une feuille « Champs » qui permet à l’utilisateur de renommer n’importe quel champ comme il le souhaite avant import et création du tableau.
Les développements à venir : –> lire la suite
L’autre partie du développement va constituer à créer des options de ventilation des données récoltées afin de créer des tableaux structurés en fonction du besoin de l’utilisateur. Une partie de code est presque prête pour créer un tableau d’adhérents structuré avec répartition par groupes sur différentes feuilles, calcul des sous totaux et totaux (nombre d’inscrits et recettes), génération de feuilles d’appel, documents récapitulatif concernant les fiches sanitaires, etc, tout en gardant la possibilité d’autoriser des saisies libres. Mais il reste du travail avant de pouvoir le rendre générique et utilisable par tous, tout comme il est important d’avoir traité la partie synchronisation en amont sans quoi cette option sera moins intéressante puisque le but est de pouvoir actualiser le document au fil des inscriptions.
Installation et utilisation
Pour installer cet addon vous pouvez soit l’installer directement en suivant de lien soit aller dans un tableau Sheets™ ouvrir le menu « extensions » -> « Modules complémentaires » -> « Télécharger des modules complémentaires » puis indiquer « Hellosheets » dans la barre de recherche du store, sélectionner l’addon et l’installer.
Il vous sera demandé d’accepter les autorisations nécessaires au bon fonctionnement (voir en bas de la page si vous souhaitez des explications sur l’utilisation de ces autorisations).
Une fois installé vous trouverez un menu « Hellosheets » dans le menu « extensions ». –> lire la suite des instructions
Il est impératif de saisir vos identifiants pour la connexion à l’API Helloasso en cliquant sur le menu « Configurer la connexion à Helloasso ».
Une fois cette étape validée vous pouvez utiliser le menu « Importer par campagne » qui permet d’importer toutes les données d’une campagne. En cochant la case « Classer les items par blocs » vous pouvez classer les lignes par items dans le tableau final.
Vous pouvez aussi utiliser le menu « Importer par période » qui importera la totalité des commandes et paiements sur une période.
Ces deux imports vous mèneront à une fenêtre de dialogue pour vous demander quels champs vous souhaitez importer.
Il est possible de renommer les champs avec des intitulés personnalisés à utiliser dans la fenêtre de dialogue et dans l’import final. Une feuille « Champs » est créée au premier import, il vous suffit de renseigner en colonne B l’intitulé que vous souhaitez utiliser au lieu de l’intitulé générique indiqué en colonne A.
Désinstallation : Pour désinstaller l’addon, cliquez sur le menu « aide » de Hellosheets, cliquer sur « voir sur le store » et cliquer « Désinstaller » dans la nouvelle fenêtre. Vous pouvez aussi passer par « Extensions » -> « Gérer les modules complémentaires et cliquer sur helloasso. »
Détails sur les autorisations nécessaires pour l’addon
L’addon Hellosheets utilise l’API Google™ et est conforme à la politique relative aux données utilisateur des services API Google™ , y compris les exigences d’utilisation limitée. Les scopes utilisés ont été limités au minimum requis pour pouvoir faire fonctionner l’addon : –> lire la suite
« oauthScopes »:
« https://www.googleapis.com/auth/spreadsheets.currentonly », (donne les droits d’accès et d’écriture uniquement sur la feuille en cours où l’addon est utilisé, vos autre documents sur votre compte Google™ ne sont pas accessibles)
« https://www.googleapis.com/auth/script.container.ui », (nécessaire pour l’addon puisse communiquer avec votre interface utilisateur en ouvrant des fenêtres de dialogue et d’information)
« https://www.googleapis.com/auth/script.external_request » (nécessaire pour pouvoir envoyer des requêtes et recevoir des réponses de l’API Helloasso)
« https://www.googleapis.com/auth/userinfo.email » (Affiche l’adresse e-mail principale associée à votre compte Google™)
« https://www.googleapis.com/auth/script.storage » (accède aux propriétés du script pour le document en cours, nécessaire pour y enregistrer vos identifiants de connexion à l’API Helloasso sans qu’elles s’affichent dans le doc si vous êtes amené à vouloir le partager, solution bien plus sécurisée dans tous les cas)
Faire un don
N’hésitez pas à faire un don à l’association qui a permis de libérer du temps à quelqu’un pour développer ces applications et permettre de continuer à les faire évoluer.
Google Sheets™ est une marque déposée de Google LLC.