Glossaire

Celle qui pose toujours problème

Un complément est ce que vous créez. Un agent est ce qui le fait tourner.

Vous créez un complément dans le tableau de bord : une seule chose à installer dans Excel, un espace de noms de formules, un volet Office. Ce complément est découpé en environnements, et chaque environnement est servi par son propre agent — le processus connxl-agent qui tourne sur votre infrastructure. Un agent par environnement ; un agent peut tourner en plusieurs réplicas derrière un répartiteur de charge.

Donc « complément » est une chose que vous configurez, et « agent » une chose qui s’exécute. Ils ne sont jamais interchangeables.

Termes

Complément (add-in) — la chose de plus haut niveau que vous créez. Une entrée dans le centre d’administration Microsoft 365, un espace de noms de formules, un volet Office. Appartient à une organisation.

Agent — le binaire connxl-agent qui tourne sur votre propre hôte. Sert à Excel le volet Office et les fonctions personnalisées du complément, et exécute les fonctions contre vos sources de données. Un par environnement.

Réplica — une copie en cours d’exécution d’un agent. Plusieurs réplicas partagent le certificat et la configuration de l’environnement, ce qui permet de monter en charge ou de déployer sans coupure.

Organisation — votre tenant. Possède les compléments, les membres, la facturation et les canaux de notification.

Environnement — une étape nommée à l’intérieur d’un complément (jusqu’à cinq). Development, Staging, Production, ou ce que vous voulez.

Environnement source — l’environnement le plus bas, où la structure est créée et modifiée. Le seul endroit où ajouter des fonctions, des connexions, des boutons de ruban ou des blocs de volet.

Environnement aval — tous les environnements au-dessus de la source. La structure n’y arrive que par promotion ; vous n’y modifiez que les valeurs propres à l’environnement (identifiants, hôtes, cache).

Promouvoir — copier la structure de l’environnement source dans un environnement aval, en préservant les identifiants et les valeurs propres à ce dernier.

Publier — faire de la configuration enregistrée d’un environnement celle que son agent sert réellement. Modifier n’est pas publier : le tableau de bord affiche un marqueur « modifications non publiées » tant que vous ne l’avez pas fait.

Connexion — un pointeur vers l’une de vos sources de données, avec des identifiants sous forme de références secret:// que votre agent résout localement. Les valeurs des identifiants n’atteignent jamais ConnXL.

Fonction — la correspondance entre une connexion et une formule saisie par vos utilisateurs, p. ex. =CONNXL.SALES.TOPCUSTOMERS("2026-Q1").

Espace de noms — le premier jeton de chaque formule servie par le complément. Vaut CONNXL par défaut, choisi par complément à sa création, puis immuable.

Ressource — tout ce qu’un environnement sert à Excel au-delà d’une simple fonction : vues de grille, graphiques, plages nommées, mises en forme conditionnelles, validations de données, protections, commentaires, insertions d’images, événements, boîtes de dialogue, boutons de ruban et le volet Office.

Volet Office (taskpane) — le panneau latéral dans lequel travaillent vos utilisateurs, conçu bloc par bloc dans le tableau de bord plutôt que codé.

Jeton d’enrôlement — un secret à usage unique qu’un agent échange à son premier démarrage contre le certificat client mTLS qui l’authentifie ensuite. Limité à un seul environnement.

Snapshot — le paquet de configuration complet qu’un agent récupère auprès de ConnXL et sert depuis sa mémoire. Les agents le récupèrent à nouveau lorsque la version de configuration de leur environnement change.

Version de configuration — le compteur par environnement incrémenté à chaque changement publié. C’est ainsi qu’un agent sait qu’il est en retard.

Bail de licence (entitlement lease) — la preuve signée de votre abonnement, transportée par le heartbeat de l’agent et vérifiée hors ligne, pour qu’une brève perte de connectivité n’arrête jamais Excel.