Vision DocumentaçãoAdministração
DocumentaçãoAdministração
Administração

Importar ZIP

Última alteração a 22/10/2024

A partir da consola de administração do Vision, é possível exportar/importar dashboards e conjuntos de dados de/para arquivos json compactados como zips.

Caso já exista uma versão de um dashboard que pretenda importar, surge um cenário em que deverá decidir o que fazer com as alterações ou diferenças entre as versões do dashboard e os conjuntos de dados. Para isso, o menu de importação apresenta diversas opções que o administrador decide como utilizar.

Opções de Importação

1. Proprietário

O administrador deve escolher explicitamente o proprietário do dashboard e dos conjuntos de dados dentre aqueles existentes no tenant, uma vez que o proprietário salvo na aplicação importada nem precisa existir na instância do Vision.

Além disso, se o proprietário que exportou o zip for o mesmo que o importou, a pasta ou local na árvore de diretórios onde o dashboard e os conjuntos de dados estão localizados será preservado. Caso contrário, o dashboard e os conjuntos de dados serão colocados na pasta raiz.

2. Aplicar a configuração da base de dados do tenant

Cada tenant tem a opção de definir e guardar uma opção de ligação de base de dados primária. Durante a importação pode indicar se pretende ou não associar esta configuração aos conjuntos de dados importados: 

  • Se estiver ativado, a configuração do ficheiro importado será ignorada e a principal do tenant será definida em todos os conjuntos de dados.
  • Se não estiver ativado, as configurações serão mantidas como estão no ficheiro importado.
    Nota: ter em conta que o acesso às bases de dados do ficheiro importado pode não funcionar nesta instância do Vision.

3. Atualizar os dados

O ficheiro de importação contém conjuntos de dados sem dados, portanto, se esta opção estiver ativada, se algum tiver ligação a uma base de dados ou tiver outro conjunto de dados como fonte de dados, uma atualização de dados será iniciada para preencher os conjuntos de dados correspondentes. 

4. Combinar conjuntos de dados

Quando um ficheiro zip é importado, o dashboard e os conjuntos de dados que contém podem já existir. Nesse caso, deve-se indicar que isso é feito com a informação já existente: é mantida, modificada ou “combinada”.

1. Propriedades que são sempre mantidas

Existem algumas propriedades que, embora relativas ao conjunto de dados, estão unicamente ligadas ao âmbito de administração da instância onde é realizada a importação:

  • Permissões de acesso para dashboards e conjuntos de dados. A permissão de acesso para utilizadores não proprietários é uma configuração relativa a cada instância do Vision, que não precisa ser válida na troca de instâncias (nem é necessário que existam os mesmos usuários). Portanto, se existir antes da importação, esta configuração permanece intacta.
  • Filtros gerais de acesso a dados ou segurança horizontal (dataFilters). Esses filtros estão vinculados às informações que são transmitidas à Vision por meio do token JWT que vai na solicitação de acesso a um dashboard. Este acesso é específico de cada instância, portanto, caso exista antes da importação, esta configuração permanece intacta. Esta configuração permanece intacta.

2. Propriedades que são sempre modificadas

Há uma série de propriedades que sempre são configuradas como estão no arquivo importado (as informações originais são sobrescritas), independentemente de como estão no conjunto de dados existente.

  • Filtros de acesso aos dados por campo do dataset (userFilters): aqueles no zip são sempre guardados.
  • Campos presentes na importação que não estavam anteriormente no dataset: são sempre adicionados à medida que chegam ao zip.
  • Idiomas: sempre é levada a configuração que vem no zip importado.
  • Georreferências: sempre é utilizada a configuração no zip importado. Há uma exceção ligada às georreferencias: ocorre quando um campo existente é do tipo georreferenciado, mas no zip está como campo não georreferenciado (tipo texto). Neste caso, o tipo de georreferenciamento e os georreferenciamentos validados no conjunto de dados são preservados.
  • Fonte de dados (parâmetros da base de dados, consulta, planeamento, etc.). Se a opção "Aplicar configuração do banco de dados de tenant" estiver desativada, a configuração no zip será sempre considerada. Há uma exceção: o tempo limite de consulta da base de dados. Neste caso, é considerado o tempo limite máximo entre o existente e o importado.

3. Combinar conjuntos de dados

Ativar esta opção cria uma mistura ou combinação, em alguns casos as propriedades específicas no zip são ignoradas e as existentes são mantidas, e em outros os do zip são retirados e os existentes são descartados. A regra atualmente estabelecida prioriza as informações que são importadas no zip exceto nos seguintes casos: 

  • Filtros de acesso aos dados por campo do conjunto de dados (userFilters): sempre são adicionados aqueles que vêm no zip, mas com esta opção os campos originais também são preservados (é feita uma junção de ambas as contribuições).
  • Campos que estão no conjunto de dados existente, mas não no zip importado: esses campos ficam intactos, apenas sua localização no conjunto de dados é modificada, pois são listados após os campos presentes no arquivo importado. Dessa forma, evita corromper outras aplicações que podem usar os campos que foram removidos do conjunto de dados que está a ser importado.
  • Conteúdo dos campos que já existem no conjunto de dados e são importados: etiquetas, ordem personalizada, precisão, unidade, formatos, etc., permanecem intactos.
Adicionar aos favoritos ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.

login para deixar a sua opinião.

Obrigado pelo seu feedback. Iremos analisá-lo para continuarmos a melhorar!
Artigos Relacionados
Importar ZIP