Glossário

A que confunde toda a gente

Um suplemento é o que crias. Um agent é o que o executa.

Crias um suplemento no painel: uma única coisa para instalar no Excel, um espaço de nomes de fórmulas, um painel de tarefas. Esse suplemento divide-se em ambientes, e cada ambiente é servido pelo seu próprio agent — o processo connxl-agent a correr na tua infraestrutura. Um agent por ambiente; um agent pode correr como várias réplicas atrás de um balanceador.

Ou seja: «suplemento» é algo que configuras, «agent» é algo que corre. Nunca são intermutáveis.

Termos

Suplemento (add-in) — a coisa de topo que crias. Uma entrada no centro de administração do Microsoft 365, um espaço de nomes de fórmulas, um painel de tarefas. Pertence a uma organização.

Agent — o binário connxl-agent a correr no teu próprio host. Serve ao Excel o painel de tarefas e as funções personalizadas do suplemento, e executa as funções contra as tuas fontes de dados. Um por ambiente.

Réplica — uma cópia em execução de um agent. Várias réplicas partilham o certificado e a configuração do ambiente, permitindo escalar ou fazer roll sem interrupções.

Organização — o teu tenant. Detém suplementos, membros, faturação e canais de notificação.

Ambiente — uma etapa com nome dentro de um suplemento (até cinco). Development, Staging, Production, ou o nome que quiseres.

Ambiente de origem — o ambiente mais baixo, onde a estrutura é criada e editada. O único sítio onde podes adicionar funções, ligações, botões de friso ou blocos do painel de tarefas.

Ambiente a jusante — todos os ambientes acima do de origem. A estrutura só lá chega por promoção; aí editas apenas valores próprios do ambiente (credenciais, hosts, cache).

Promover — copiar a estrutura do ambiente de origem para um ambiente a jusante, preservando as credenciais e os valores próprios desse ambiente.

Publicar — tornar a configuração guardada de um ambiente naquela que o seu agent realmente serve. Editar não é publicar: o painel mostra um marcador de «alterações por publicar» até o fazeres.

Ligação — um ponteiro para uma das tuas fontes de dados, com credenciais como referências secret:// que o teu agent resolve localmente. Os valores das credenciais nunca chegam ao ConnXL.

Função — a correspondência entre uma ligação e uma fórmula que os teus utilizadores escrevem, p. ex. =CONNXL.SALES.TOPCUSTOMERS("2026-Q1").

Espaço de nomes — o primeiro token de cada fórmula servida pelo suplemento. Por omissão CONNXL, escolhido por suplemento na criação e imutável depois disso.

Recurso — tudo o que um ambiente serve ao Excel para além de uma função simples: vistas de grelha, gráficos, intervalos nomeados, formatações condicionais, validações de dados, proteções, comentários, inserções de imagem, eventos, diálogos, botões de friso e o painel de tarefas.

Painel de tarefas — o painel lateral onde os teus utilizadores trabalham, desenhado bloco a bloco no painel de controlo em vez de programado.

Token de inscrição — um segredo de uso único que um agent troca no primeiro arranque pelo certificado de cliente mTLS que o autentica a partir daí. Limitado a um ambiente.

Snapshot — o pacote completo de configuração que um agent obtém do ConnXL e serve a partir da memória. Os agents voltam a obtê-lo quando a versão de configuração do seu ambiente muda.

Versão de configuração — o contador por ambiente que incrementa a cada alteração publicada. É assim que um agent sabe que está atrasado.

Licença (entitlement lease) — a prova assinada da tua subscrição, que viaja com o heartbeat do agent e é verificada offline, para que uma perda breve de conectividade nunca pare o Excel.