Prise en main
Concepts fondamentaux
ConnXL est un petit ensemble d'objets qui s'imbriquent proprement : une organisation possède des compléments, chaque complément est servi par un agent et divisé en environnements, et chaque environnement contient des connexions et des fonctions. Comprendre cette hiérarchie rend tout le reste évident.
6 min de lecture
Organisation
Votre locataire. Les utilisateurs, les webhooks de notification et les membres vivent au niveau de l'organisation. Une organisation contient de nombreux compléments.
Complément
Un complément est ce que vous livrez à vos utilisateurs finaux : une entrée dans le centre d'administration Microsoft 365, un espace de noms de formules, un volet Office. Vous le servez en exécutant le binaire connxl-agent sur votre propre hôte — un agent par environnement (voir ci-dessous). Dans le tableau de bord, le complément est l'élément de premier niveau que vous créez, nommez et entre lesquels vous basculez.
Environnement
Un complément possède un ensemble ordonné d'environnements nommés — jusqu'à cinq, configurés depuis le tableau de bord. Un nouveau complément démarre avec un unique environnement Development.
-
Chaque environnement exécute son propre agent — son propre processus
connxl-agent, authentifié via un jeton d'inscription à usage unique échangé contre un certificat client mTLS limité à cet environnement. C'est le certificat qui décide quel environnement un agent sert. Un complément avec les environnements Development et Production est servi par deux agents, actifs en parallèle, et un même agent peut se démultiplier en plusieurs réplicas qui partagent le certificat et la configuration de l'environnement. -
L'environnement le plus bas (Development) est la source — le seul endroit où la structure (fonctions, définitions de connexion, boutons de ruban, volet Office) est créée ou modifiée.
-
Tout autre environnement est une cible de promotion : vous n'y modifiez que des valeurs spécifiques à l'environnement — identifiants, hôtes, cache. Les modifications structurelles sont rejetées (le backend l'applique, pas seulement l'interface).
-
Promouvoir copie la structure de la source dans un environnement en aval tout en préservant les propres valeurs de cet environnement, de sorte que vous pouvez faire passer une modification en QA ou en production sans toucher à ses identifiants.
Connexion
Un pointeur vers l'une de vos sources de données — une base de données, une API HTTP, une fonction cloud, un fichier distant ou un cache. Les connexions sont définies dans le tableau de bord (identifiants par référence secret://) et résolues par l'agent au moment de l'exécution. Voir Connexions pour le catalogue complet.
Fonction
Une fonction fait correspondre une connexion à une formule que vos utilisateurs saisissent, par exemple =CONNXL.SALES.TOP_CUSTOMERS(10). Les fonctions varient selon deux axes :
- Forme de sortie — à quoi ressemble le résultat dans la grille : une valeur unique, une ligne, une table (se répand dans une plage) ou une entité (un type de données lié avec des accesseurs de champ comme
=A2.Price). - Modèle d'exécution — sync (calculé localement), async (par défaut ; s'exécute sur l'agent) ou streaming (mise à jour en direct).
La séparation tableau de bord / agent
Le tableau de bord est la configuration de référence — il stocke ce que font vos compléments et pousse les modifications vers vos agents via un canal de streaming. L'agent est le plan d'exécution — il sert le complément à Excel et exécute chaque appel de fonction sur vos données. Le tableau de bord ne parle qu'à ce backend ; il ne parle jamais directement à votre agent, et il ne touche jamais à vos sources de données.
L'invariant du produit
Les données client ne traversent jamais notre backend. Vos identifiants et les données de vos cellules restent à l'intérieur de votre réseau — le seul moyen d'utiliser ConnXL est d'exécuter un agent. Le tableau de bord ne voit que des métadonnées : latence, statut, résultat de cache et adresses e-mail des utilisateurs hachées en SHA-256.
Démarrage rapide
Mettez en place un complément Excel fonctionnel qui exécute vos propres fonctions sur vos propres données — sans qu'aucune donnée de vos feuilles de calcul ne quitte jamais votre réseau. Ce guide parcourt tout le chemin, de l'inscription à la saisie de votre première formule =NAMESPACE.MODULE.FN(…) dans une cellule.
Glossaire
Tous les termes de ConnXL au même endroit, avec la distinction la plus souvent ratée : un complément est ce que vous créez, un agent est ce qui le fait tourner.