Exportar, importar e clonar

Três operações movem um dashboard: duplicar dentro da conta, exportar para um ficheiro, e importar esse ficheiro noutra conta.

Duplicar

O menu de cada cartão na lista tem Duplicar. A cópia leva:

• o ecrã principal e todos os ecrãs auxiliares, com os identificadores internos remapeados;
• os widgets, as consultas e os eventos;
• os anexos.

As tabelas de dados não são duplicadas — pertencem à conta, e a cópia consulta as mesmas.

É a forma segura de experimentar uma reorganização grande: trabalha-se na cópia e, se resultar, apaga-se o original.

Exportar

Exportar, no mesmo menu, produz um ficheiro .dvdash. Ao contrário da duplicação, este ficheiro leva tudo, incluindo os dados:

No ficheiro	O que é
Manifesto	Nome, descrição, quem exportou e quando, conta de origem, categoria
Ecrã principal	O documento do ecrã
Ecrãs auxiliares	Um documento por ecrã de detalhe
Entidades	As entidades do modelo que o dashboard usa
Tabelas	As tabelas de dados, com a estrutura das colunas
Dados	Todas as linhas dessas tabelas
Ficheiros de origem	Os Excel originais, tal como foram importados
Anexos	Imagens e ficheiros do dashboard
Capa	A imagem do cartão, se existir

O ficheiro é um zip, e serve tanto para levar um dashboard para outra instalação como para guardar uma cópia completa.

Um .dvdash contém os dados todos

Não é só o desenho: leva as linhas das tabelas e os ficheiros Excel originais. Trate-o com o mesmo cuidado que trataria a folha de cálculo de onde veio.

Importar

Na lista de dashboards, o botão de importar aceita um .dvdash. É criado um dashboard novo, com as tabelas de dados recriadas e as linhas repostas.

O que acontece a seguir:

• as entidades são criadas ou reaproveitadas conforme já existam;
• os identificadores dos ecrãs auxiliares são remapeados, para não colidirem com os que já existem;
• as consultas continuam a apontar às entidades certas.

Se a versão do formato não for reconhecida, a importação é recusada com uma mensagem clara em vez de resultar num dashboard meio partido.

Segurança da importação

Um ficheiro importado nunca executa instruções vindas de dentro. As tabelas são recriadas a partir da lista estruturada de colunas do manifesto, com os identificadores validados e apenas três tipos permitidos.

Por outras palavras: um .dvdash manipulado não consegue criar nada que a aplicação não crie normalmente.

Qual usar

Objectivo	Operação
Experimentar sem risco	Duplicar
Fazer uma variante para outro público	Duplicar e ajustar
Levar para outra instalação	Exportar e importar
Guardar uma cópia completa	Exportar
Entregar um modelo a um cliente	Exportar

O que não viaja

Um .dvdash não leva utilizadores, papéis, categorias nem links públicos. São da conta, não do dashboard. Depois de importar, arrume-o numa categoria e publique-o de novo se precisar.