Glosario

La que siempre se confunde

Un complemento es lo que creas. Un agent es lo que lo ejecuta.

Creas un complemento en el panel: una sola cosa que instalar en Excel, un espacio de nombres de fórmulas, un panel de tareas. Ese complemento se divide en entornos, y cada entorno lo sirve su propio agent — el proceso connxl-agent que corre en tu infraestructura. Un agent por entorno; un agent puede ejecutarse como varias réplicas detrás de un balanceador.

Así que «complemento» es algo que configuras y «agent» es algo que se ejecuta. Nunca son intercambiables.

Términos

Complemento (add-in) — lo primero que creas. Una entrada en el centro de administración de Microsoft 365, un espacio de nombres de fórmulas, un panel de tareas. Pertenece a una organización.

Agent — el binario connxl-agent ejecutándose en tu propio host. Sirve a Excel el panel de tareas y las funciones personalizadas del complemento, y ejecuta las funciones contra tus fuentes de datos. Uno por entorno.

Réplica — una copia en ejecución de un agent. Varias réplicas comparten el certificado y la configuración del entorno, para escalar o desplegar sin cortes.

Organización — tu tenant. Posee complementos, miembros, facturación y canales de notificación.

Entorno — una etapa con nombre dentro de un complemento (hasta cinco). Development, Staging, Production, o como los llames.

Entorno de origen — el entorno más bajo, donde se crea y edita la estructura. El único sitio donde puedes añadir funciones, conexiones, botones de cinta o bloques del panel de tareas.

Entorno derivado — todos los entornos por encima del de origen. La estructura solo llega por promoción; allí editas valores propios del entorno (credenciales, hosts, caché) y nada más.

Promover — copiar la estructura del entorno de origen a un entorno derivado, conservando las credenciales y los valores propios de ese entorno.

Publicar — hacer que la configuración guardada de un entorno sea la que su agent sirve de verdad. Editar no es publicar: el panel muestra un indicador de «cambios sin publicar» hasta que lo haces.

Conexión — un puntero a una de tus fuentes de datos, con las credenciales como referencias secret:// que tu agent resuelve localmente. Los valores de las credenciales nunca llegan a ConnXL.

Función — la correspondencia entre una conexión y una fórmula que escriben tus usuarios, p. ej. =CONNXL.SALES.TOPCUSTOMERS("2026-Q1").

Espacio de nombres — el primer token de cada fórmula que sirve el complemento. Por defecto CONNXL, se elige por complemento al crearlo y luego es inmutable.

Recurso — todo lo que un entorno sirve a Excel más allá de una función simple: vistas de cuadrícula, gráficos, rangos con nombre, formatos condicionales, validaciones de datos, protecciones, comentarios, inserciones de imagen, eventos, diálogos, botones de cinta y el panel de tareas.

Panel de tareas — el panel lateral donde trabajan tus usuarios, diseñado bloque a bloque en el panel de control en vez de programado.

Token de enrolamiento — un secreto de un solo uso que un agent canjea en su primer arranque por el certificado de cliente mTLS que lo autentica a partir de entonces. Está limitado a un entorno.

Snapshot — el paquete completo de configuración que un agent descarga de ConnXL y sirve desde memoria. Los agents vuelven a descargarlo cuando cambia la versión de configuración de su entorno.

Versión de configuración — el contador por entorno que se incrementa con cada cambio publicado. Es así como un agent sabe que va atrasado.

Licencia (entitlement lease) — la prueba firmada de tu suscripción que viaja con el heartbeat del agent y se verifica sin conexión, para que una pérdida breve de conectividad nunca detenga Excel.