Guía rápida

ConnXL tiene dos mitades. El panel (esta app) es donde defines conexiones y funciones. El agent — un único binario llamado connxl-agent — se ejecuta en tu infraestructura, sirve el complemento a Excel y ejecuta cada llamada de función contra tus fuentes de datos. ConnXL nunca ve los datos de tus celdas; el agent hace todo el trabajo dentro de tu red.

Inicia sesión y crea tu organización

Abre el panel e inicia sesión. ConnXL solo admite inicio de sesión federado — continúa con tu identidad de Microsoft (Entra); no hay contraseña que configurar, y tu cuenta se crea en el primer inicio de sesión.

Si el dominio de tu correo aún no forma parte de una organización, aterrizas en Create your organization — dale un nombre a tu espacio de trabajo y continúa. Una organización es tu tenant: contiene tus complementos, miembros y facturación. (Si un compañero ya creó la organización, acepta su invitación desde tu correo en su lugar y te saltarás este paso.)

Crea un complemento

En el panel, crea un complemento. Un complemento es lo que tus usuarios finales instalan: una entrada en el centro de administración de Microsoft 365, un espacio de nombres de fórmulas, un panel de tareas.

• Namespace — el prefijo de fórmula que escriben tus usuarios (=NAMESPACE.MODULE.FN(…)). Déjalo en blanco para el valor por defecto CONNXL, o elige el tuyo (p. ej. NORTHWIND). Es inmutable tras la creación, así que elígelo con cuidado.
• Entornos — siempre se crea un entorno de Development. Añade QA/Staging/Production ahora o más tarde.
• Facturación — añade una tarjeta de pago (gestionada por Paddle; ConnXL nunca la toca). Tu primer complemento es gratis durante un mes; la tarjeta solo se cobra cuando termina el mes gratuito.

Cada entorno ejecuta su propio agent, y se autentica ante ConnXL con su propio certificado de cliente mTLS. No lo configuras a mano — en el siguiente paso descargas un binario con la identidad de este entorno ya incrustada, y se inscribe para obtener su certificado en el primer arranque.

Ejecuta el agent en tu propio host

En la página del Agente del entorno, en el panel (pestaña Despliegue), haz clic en Descargar agent configurado y elige el sistema operativo/arquitectura de tu host (Windows x64, Linux x64, Linux arm64). El binario viene con la identidad de este entorno ya incrustada — la URL del backend, el complemento y el entorno, y un token de inscripción de un solo uso nuevo — así que no hay nada que configurar. Descomprímelo en tu host.

Mantén el directorio static/ de la descarga junto al binario — contiene el shell del panel de tareas y los logos neutros que sirve el agent (el agent busca ./static).

Los complementos de Office requieren HTTPS, y eliges cómo llega el agent con CONNXL_TLS_TERMINATION. Por defecto (edge) el agent sirve HTTP plano en :3000 y un balanceador que termina el TLS delante aporta el HTTPS — no va nada más en disco. Para que el agent termine el TLS él mismo (una sola VM sin balanceador, o pruebas locales), define CONNXL_TLS_TERMINATION=agent y coloca cert.pem + key.pem junto al binario (genéralos con mkcert en local, o usa un certificado de confianza pública — consulta Instalar).

# working directory holds: connxl-agent, static/  (+ cert.pem, key.pem only in agent mode)
./connxl-agent      # reads its embedded identity, enrolls, and serves on :3000 (HTTP behind your LB by default)

Añade una conexión y una función

De vuelta en el panel, apunta el agent a una fuente de datos creando una conexión (Postgres, una API REST, un archivo de S3 y una docena más), y luego construye una función encima de ella. Una función pertenece a un módulo y se corresponde con una fórmula que tus usuarios escribirán.

• El panel guarda solo metadatos y una referencia secret:// para cualquier credencial — nunca el valor del secreto en sí.
• El agent sondea la fuente desde dentro de tu red cuando haces clic en Test connection; el backend nunca marca a tus fuentes de datos. (La prueba se ejecuta en un agent en vivo, así que levanta el agent primero — o sáltate la prueba y valídala más tarde.)

Consulta Conexiones y Funciones para ver ejemplos prácticos contra una API REST y una base de datos.

Publica el entorno

Tus conexiones y funciones son borradores hasta que las publiques. En la página Versions del entorno, haz clic en Save version con "Make this version live" marcado. Solo entonces el agent recibe la configuración y empieza a servir tus funciones a Excel.

Descarga el manifiesto y haz sideload

Define el host del agent del entorno con la URL HTTPS pública donde tu agent es alcanzable (ajustes del entorno → Agent host), luego descarga el manifiesto de Office generado — un archivo XML o JSON unificado (no un binario; no hay paso por la Office Store). El manifiesto apunta Excel directamente a tu host del agent, así que el tráfico de celdas de tus usuarios solo llega a tu agent. Descárgalo desde el panel de instalación de Excel del entorno, luego haz sideload, o entrega la URL del manifiesto a tu administrador de Microsoft 365 para el despliegue centralizado.

Úsalo en Excel

Abre el panel de tareas desde la cinta de opciones para explorar tus funciones, o simplemente escribe la fórmula. Las funciones personalizadas viven bajo el espacio de nombres de tu complemento, con tu módulo y el nombre de la función:

=NORTHWIND.SALES.TOP_CUSTOMERS(10)

Excel envía la llamada a tu agent, el agent la ejecuta contra tu conexión y devuelve el resultado, y la celda se rellena. Una función que devuelve filas se desborda en un rango; una que devuelve un único valor aterriza en esa única celda.