Démarrage rapide

ConnXL comporte deux moitiés. Le tableau de bord (cette application) est l'endroit où vous définissez les connexions et les fonctions. L'agent — un binaire unique appelé connxl-agent — s'exécute sur votre infrastructure, sert le complément à Excel et exécute chaque appel de fonction sur vos sources de données. ConnXL ne voit jamais les données de vos cellules ; c'est l'agent qui réalise tout le travail à l'intérieur de votre réseau.

Connectez-vous et créez votre organisation

Ouvrez le tableau de bord et connectez-vous. ConnXL n'accepte que la connexion fédérée — continuez avec votre identité Microsoft (Entra) ; il n'y a pas de mot de passe à définir, et votre compte est créé lors de la première connexion.

Si le domaine de votre adresse e-mail ne fait pas encore partie d'une organisation, vous arrivez sur Create your organization — donnez un nom à votre espace de travail et continuez. Une organisation est votre tenant : elle contient vos compléments, vos membres et votre facturation. (Si un collègue a déjà créé l'organisation, acceptez plutôt son invitation depuis votre e-mail et vous sauterez cette étape.)

Créer un complément

Dans le tableau de bord, créez un complément. Un complément est ce que vos utilisateurs finaux installent — une entrée dans le centre d'administration Microsoft 365, un espace de noms de formules, un volet Office.

• Namespace — le préfixe de formule que vos utilisateurs saisissent (=NAMESPACE.MODULE.FN(…)). Laissez-le vide pour la valeur par défaut CONNXL, ou choisissez le vôtre (par ex. NORTHWIND). Il est immuable après la création, choisissez-le donc délibérément.
• Environnements — un environnement Development est toujours créé. Ajoutez QA/Staging/Production maintenant ou plus tard.
• Facturation — ajoutez une carte de paiement (gérée par Paddle ; ConnXL n'y touche jamais). Votre premier complément est gratuit pendant un mois ; la carte n'est débitée que lorsque le mois gratuit prend fin.

Chaque environnement exécute son propre agent, et il s'authentifie auprès de ConnXL avec son propre certificat client mTLS. Vous ne configurez pas cela à la main — à l'étape suivante, vous téléchargez un binaire avec l'identité de cet environnement déjà intégrée, et il s'enrôle pour obtenir son certificat au premier démarrage.

Exécuter l'agent sur votre propre hôte

Sur la page Agent de l'environnement, dans le tableau de bord (onglet Déploiement), cliquez sur Télécharger l'agent configuré et choisissez le système d'exploitation/l'architecture de votre hôte (Windows x64, Linux x64, Linux arm64). Le binaire est livré avec l'identité de cet environnement déjà intégrée — l'URL du backend, le complément et l'environnement, et un jeton d'enrôlement à usage unique neuf — il n'y a donc rien à configurer. Décompressez-le sur votre hôte.

Deux choses doivent se trouver à côté du binaire sur le disque :

• cert.pem + key.pem — les compléments Office exigent HTTPS, l'agent refuse donc de démarrer sans un certificat et une clé TLS (pour les tests locaux, générez-les avec mkcert ; pour un vrai hôte, utilisez un certificat de confiance publique — voir Installer).
• le répertoire static/ fourni dans le téléchargement — il contient le squelette du volet Office et les logos neutres que l'agent sert. Gardez-le à côté du binaire (l'agent cherche ./static).

# working directory holds: connxl-agent, cert.pem, key.pem, static/
./connxl-agent      # reads its embedded identity, enrolls, and listens on https://<host>:3000

Ajouter une connexion et une fonction

De retour dans le tableau de bord, dirigez l'agent vers une source de données en créant une connexion (Postgres, une API REST, un fichier S3, et une douzaine d'autres), puis construisez une fonction par-dessus. Une fonction appartient à un module et correspond à une formule que vos utilisateurs saisiront.

• Le tableau de bord ne stocke que des métadonnées et une référence secret:// pour chaque identifiant — jamais la valeur du secret elle-même.
• L'agent sonde la source depuis l'intérieur de votre réseau lorsque vous cliquez sur Tester la connexion ; le backend n'appelle jamais vos sources de données. (Le test s'exécute sur un agent actif, alors mettez d'abord l'agent en route — ou sautez le test et validez plus tard.)

Consultez Connexions et Fonctions pour des exemples concrets sur une API REST et une base de données.

Publier l'environnement

Vos connexions et fonctions sont des brouillons jusqu'à ce que vous les publiiez. Sur la page Versions de l'environnement, cliquez sur Save version avec "Make this version live" coché. Ce n'est qu'alors que l'agent reçoit la configuration et commence à servir vos fonctions à Excel.

Télécharger le manifeste et charger le complément

Définissez l'hôte d'agent de l'environnement sur l'URL HTTPS publique où votre agent est accessible (paramètres de l'environnement → Agent host), puis téléchargez le manifeste Office généré — un fichier XML ou JSON unifié (pas un binaire ; il n'y a pas d'étape via l'Office Store). Le manifeste dirige Excel directement vers votre hôte d'agent, de sorte que le trafic des cellules de vos utilisateurs n'atteint jamais que votre agent. Téléchargez-le depuis le panneau d'installation Excel de l'environnement, puis chargez-le indépendamment, ou transmettez l'URL du manifeste à votre administrateur Microsoft 365 pour un déploiement centralisé.

L'utiliser dans Excel

Ouvrez le volet Office depuis le ruban pour parcourir vos fonctions, ou tapez simplement la formule. Les fonctions personnalisées vivent sous l'espace de noms de votre complément, avec votre module et le nom de la fonction :

=NORTHWIND.SALES.TOP_CUSTOMERS(10)

Excel envoie l'appel à votre agent, l'agent l'exécute sur votre connexion et renvoie le résultat, et la cellule se remplit. Une fonction qui renvoie des lignes se répand dans une plage ; une fonction qui renvoie une valeur unique atterrit dans la seule cellule.