Versões

Cada ambiente mantém um histórico restaurável de configurações publicadas. Esta página cobre o modelo rascunho vs. ativo, guardar e publicar uma versão, comparar dois snapshots (incluindo o teu rascunho por publicar), restaurar, e promover uma versão entre ambientes.

O modelo rascunho vs. ativo

Cada ambiente tem duas coisas a acontecer ao mesmo tempo: um rascunho de trabalho (o aspeto atual das tuas ligações, funções, botões de friso e painel de tarefas no dashboard) e uma versão ativa (um snapshot guardado que está de facto a ser servido ao Excel).

Editar é sempre um rascunho. Adicionar uma função, mudar uma ligação, ajustar o painel de tarefas — nada disso cria uma versão, e nada disso chega ao Excel por si só.
Uma versão só é criada deliberadamente — através de Save version ou de Promote. Não há uma versão de "edição" automática; é por isso que uma função acabada de construir continua a devolver nada até publicares.
Ativo é um ponteiro, não uma cópia do rascunho. O ambiente aponta para uma versão guardada; o agent serve exatamente o snapshot dessa versão. Um ambiente sem versão ativa ainda serve nada — o seu agent mostra zero funções.

Porque é que uma função nova devolve em branco

Se acabaste de construir uma função e a célula não mostra nada (ou a configuração do agent parece vazia), quase de certeza ainda não publicaste. Vai à página Versions do ambiente e faz Save version com "Make this version live" marcado — essa é a única ação que envia o teu rascunho para o agent.

Guardar uma versão

Na página Versions do ambiente, Save version tira um snapshot do rascunho de trabalho atual com um nome à tua escolha. O seu modal tem um interruptor:

Make this version live (ativo por omissão) — publica o snapshot de imediato; o agent começa a servi-lo.
Desligado — guarda um ponto de controlo sem alterar o que está atualmente ativo. Útil para capturar um marco a meio de uma edição sem o lançar ainda.

Make live

Qualquer versão guardada no histórico pode voltar a ficar ativa com um clique — uma ação Make live que apenas move o ponteiro ativo para essa versão. Não toca no teu rascunho de trabalho nem cria uma versão nova; é um interruptor puro de publicação/reversão. Usa-a para reverter para uma versão que sabes que funciona depois de uma publicação falhada, ou para voltar a promover uma versão mais antiga sem repetir o Promote.

Compare

A ação Compare (ou marcar duas linhas no histórico) abre uma comparação em página inteira entre quaisquer duas versões. Os dois seletores são:

From — qualquer versão guardada.
To — qualquer versão guardada, ou uma opção especial Current state (com o distintivo Draft) que vai buscar o teu rascunho de trabalho em bruto, não versionado, diretamente às tabelas ativas do ambiente.

Comparar uma versão guardada com Current state é como vês exatamente o que a publicação mudaria antes de o fazeres — a mesma verificação que alimenta o banner de "alterações por publicar" na página Versions. Para comparar com a versão ativa do ambiente especificamente (não o rascunho), escolhe-a na lista de versões — a linha que o histórico marca como Live.

Current state não é o mesmo que a versão ativa

Mesmo quando nada parece diferente, "Current state" é sempre o teu rascunho de trabalho ativo relido de fresco — deliberadamente não é uma cópia em cache do que era o snapshot da versão ativa. Comparar com ele é a única forma de ver edições por publicar; comparar duas versões guardadas só mostra diferenças entre publicado e publicado.

A comparação classifica cada item alterado como adicionado, removido ou modificado, e para os itens modificados mostra exatamente que campos mudaram — incluindo um sinalizador para alterações que só tocam nos campos de valor de uma ligação (host, URL, referência de segredo) e não na sua estrutura.

Restore

Restore é a alternativa mais antiga e mais direta ao Make live: sobrepõe o rascunho de trabalho do ambiente com o conteúdo de uma versão guardada e regista uma entrada restore. As linhas de versão do dashboard usam o Make live para reversões do dia a dia (sem sobreposição, sem aviso destrutivo); o Restore continua disponível como ação de recurso quando queres especificamente substituir o próprio rascunho.

Promover entre ambientes

Promote traz a estrutura de um ambiente fonte para um ambiente a jusante e publica-a lá num único passo — é assim que as alterações estruturais (uma função nova, uma forma de ligação alterada) chegam a QA, Staging ou Production. O Promote:

Copia a estrutura do ambiente fonte (Development).
Nunca toca nos valores próprios do destino — as suas credenciais, o host do agent e as definições de cache mantêm-se exatamente como configuradas para esse ambiente.
Regista uma entrada promote no histórico de versões do destino, com um título como "Promote from Development" e os distintivos de comparação correspondentes.

Ler o histórico

O History timeline lista todas as versões da mais recente para a mais antiga, cada linha mostrando:

Um ícone de tipo — Saved (um Save version manual), Promote ou Restore.
O título da versão (o nome que lhe deste, ou um valor por omissão derivado do tipo).
Um distintivo azul Live e um destaque na versão que está atualmente a ser servida.
O ambiente de origem, quem fez a alteração, e quando.
Distintivos de comparação a resumir o que mudou face à versão anterior.

Por linha podes fazer Make live, Compare (contra outra linha), ou Delete (eliminação suave; a versão ativa não pode ser eliminada). Um banner âmbar no topo da página avisa-te quando o rascunho de trabalho tem alterações por publicar à espera de um Save version.

As versões também aparecem em Logs

Os eventos de Save / Promote / Make-live aparecem na consola Logs sob uma lente de "Alterações de configuração", limitada ao ambiente que estás a ver — útil quando queres um rasto de auditoria cronológico ao lado das análises de utilização em vez da página Versions dedicada. Consulta Logs e exportações.

Ambientes

O que é um ambiente, como renomear, e a cache de resultados.

Resolução de problemas

"A minha fórmula está em branco" e outras correções, a começar pela armadilha rascunho/ativo abaixo.