Vision DocumentaciónAdministración
DocumentaciónAdministración
Administración

Importar ZIP

Última modificación el 22/10/2024

Desde la consola de administración Vision permite exportar/importar dashboards y datasets a/desde ficheros json comprimidos como zips. En el caso de que ya exista una versión de un dashboard que se quiere importar, se presenta un escenario en el cual hay que decidir que hacer con los cambios o diferencias entre ambas versiones del dashboard y los datasets.

Para ello el menú de importación presenta varias opciones que el administrador decide como utilizar.

Opciones de importación

1. Propietario

El administrador debe de elegir explícitamente el propietario del dashboard y datasets entre los existentes en el tenant, ya que el propietario guardado en la app importada ni siquiera tiene por que existir en la instancia de Vision.

Además, en caso de que el propietario que exportó el zip sea el mismo que el que lo importa, se conserva la carpeta o ubicación en el árbol de directorios donde están situados dashboard y datasets. En caso contrario dashboard y datasets se sitúan en la carpeta raíz.

2. Aplicar la configuración de base de datos del tenant

Cada tenant tiene la opción de definir y guardar una opción principal de conexión a base de datos. En la importación se puede indicar que se asocie o no esta configuración a los datasets importados:

  • Si se habilita se ignora la configuración que vienen en el fichero importado y se establece la principal del tenant en todos los datasets.
  • Si no se habilita se conservan las configuraciones tal cual vienen en el fichero importado.
    Nota: tener en cuenta que el acceso a las bases de datos que vienen en el fichero importado puede no funcionar desde esta instancia de Vision.

3. Refrescar datos

El fichero de importación contiene datasets sin datos, por lo que si se habilita esta opción en caso de tener alguno una conexión a base de datos, o bien tener como origen de datos otro dataset, se lanza un refresco de datos para poblar los datasets correspondientes.

4. Combinar datasets

Cuando se importa un fichero zip es posible que ya existan el dashboard y los datasets que contiene. En ese caso hay que indicar que se hace con la información ya existente: se mantiene, se modifica, o se ""combina"".

1. Propiedades que siempre se mantienen

Hay algunas propiedades que, aunque relativas al dataset, están ligadas unívocamente al ámbito de la administración de la instancia donde se realiza la importación:

  • Permisos de acceso a dashboards y datasets. El permiso de acceso de usuarios no propietarios es una configuración relativa a cada instancia de Vision, que no tiene porque ser válida al cambiar de instancia (ni siquiera tienen porque existir los mismos usuarios). Por ello, en el caso de existir previamente a la importación, esta configuración se deja intacta.
  • Filtros de acceso a datos generales o seguridad horizontal (dataFilters). Estos filtros están ligados a información que se transmite a Vision a través del JWT token que va en la petición de acceso a un dashboard. Este acceso es particular de cada instancia, por lo que, en el caso de existir previamente a la importación, esta configuración se deja intacta.

2. Propiedades que siempre se modifican

Hay una serie de propiedades que siempre se configuran tal cual vienen en el fichero importado (se sobrescribe la información original), con independencia de como estén en el dataset existente.

  • Filtros de acceso a datos por campo del dataset (userFilters): siempre se guardan los que vienen en el zip.
  • Campos presentes en la importación que no estaban anteriormente en el dataset: siempre se añaden tal cual vienen en el zip.
  • Lenguajes: siempre se toma la configuración que viene en el zip importado.
  • Georreferencias: siempre se toma la configuración que viene en el zip importado. Hay una excepción ligada a las georreferencias: ocurre cuando un campo existente es de tipo georreferencia, pero en el zip viene como campo no georreferenciado (de tipo texto). En ese caso se conserva el tipo georreferencia y las georreferencias validadas en el dataset.
  • Origen de datos (parámetros de BBDD, consulta, planificación, etc.). En el caso de estar deshabilitada la opción ""Aplicar la configuración de base de datos del tenant"" siempre se toma la configuración que viene en el zip. Hay una excepción: el timeout de la consulta a base de datos. En este caso, se toma el timeout máximo entre el existente y el importado.

3. Combinar datasets
Al habilitar esta opción se hace una mezcla o combinación, en algunos casos se ignoran las propiedades específicas que vienen en el zip y se mantiene las existentes, y en otros se toman las del zip y se desechan las existentes. La regla establecida actualmente prioriza la información que se importa en el zip menos en los siguientes casos:

  • Filtros de acceso a datos por campo del dataset (userFilters): siempre se añaden los que vienen en el zip, pero además con esta opción también se conservan los campos originales (se hace una unión de ambas contribuciones).
  • Campos que están en el dataset existente, pero no en el zip importado: estos campos se dejan intactos, únicamente se modifica su situación en el dataset, pues se listan después de los campos presentes en el fichero importado. De esta forma se evita corromper otras aplicaciones que pueden usar esos campos que se han retirado del dataset que se importa.
  • Contenido de campos que ya existen en el dataset y que se importan: etiquetas, orden personalizado, precisión, unidad, formatos, etc., se dejan intactos.
Bookmark or share this article
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!
Artículos Relacionados
Importar ZIP