Saltar a contenido

Despliegue del plugin mediante un archivo ZIP

Contexto

El directorio de instalación del plugin Isogeo de QGIS 
C:\Users\%userprofile%\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\isogeo_search_engine

/home/%userprofile%/.local/share/QGIS/QGIS3/profiles/default/python/plugins/isogeo_search_engine

Muchos de los ajustes para utilizar el plugin Isogeo se guardan en el directorio de instalación del plugin. Este es el caso, en particular, de los archivos :

El gestor de extensiones de QGIS también permite instalar un plugin desde un archivo .zip. De este modo, en el caso de una organización con un gran número de usuarios finales del plugin Isogeo, es posible evitar que tengan que realizar ellos mismos determinados ajustes, ya que son comunes para todos los usuarios.

Tomemos el siguiente ejemplo

Un usuario X es responsable de distribuir el plugin Isogeo de QGIS a una decena de usuarios de su organización:

  • el archivo de autenticación client_secrets.json es probablemente común a toda la organización
  • los datos a los que podrán acceder los usuarios finales a través del plugin de Isogeo se almacenan en la misma base de datos a la que tienen acceso todos los usuarios
  • algunos de estos datos pueden ser útiles para todos los usuarios

En este caso, el usuario X puede :

  • autenticar el plugin con el client_secrets.json común a toda la organización
  • configurar la conexión a la base de datos de la organización en el archivo db_connections.json
  • guardar búsquedas rápidas que incluyan metadatos relativos a datos útiles para todos los usuarios

Una vez realizada esta configuración por el usuario X, puede generar un archivo .zip a partir del directorio de instalación del plugin en su estación de trabajo y distribuirlo a la decena de usuarios finales que no tendrán que autenticarse, configurar la conexión a la base de datos o guardar ciertas búsquedas rápidas.

Procedimiento

  1. Instale el plugin y autentifíquese introduciendo la ubicación del archivo client_secrets.json proporcionado por el equipo de Isogeo. El archivo se copia en la carpeta _auth del directorio de instalación del plugin en la estación de trabajo del usuario.

  2. En la misma estación de trabajo, configure el archivo :

    1. guardando búsquedas rápidas
    2. estableciendo una búsqueda por defecto
    3. configurando las conexiones a la base de datos en el archivo _user/db_connections.json

  3. En el mismo ordenador, cree un archivo .zip a partir del directorio de instalación del plugin:

    Este archivo .zip contiene los archivos client_secrets.json, quicksearches.json y db_connections.json resultantes de las dos primeras etapas.

  4. Distribuye el archivo .zip resultante a otros usuarios, que podrán instalar el plugin Isogeo de QGIS directamente desde el archivo isogeo_search_engine.zip (menú"Instalar/Gestionar extensiones" > pestaña"Instalar desde ZIP").

    Para los usuarios que instalen el plugin de esta forma, la autenticación será automática (sin pasar por el formulario de autenticación) porque el archivo client_secrets.json ya estará presente en la carpeta _auth del plugin Isogeo.