Pular para conteúdo

Implementação do plug-in por meio de um ZIP

Contexto

O diretório de instalação do plug-in Isogeo do 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

Muitas das configurações para usar o plug-in Isogeo são salvas no diretório de instalação do plug-in. Esse é particularmente o caso do :

O gerenciador de extensões do QGIS também permite que você instale um plug-in a partir de um arquivo .zip. No caso de uma organização com um grande número de usuários finais do plug-in Isogeo, é possível evitar que eles mesmos tenham de fazer determinadas configurações, pois elas são comuns a todos os usuários.

Vejamos o exemplo a seguir

Um usuário X é responsável por distribuir o plug-in Isogeo do QGIS para cerca de dez usuários em sua organização:

  • o arquivo de autenticação client_secrets.json provavelmente é comum a toda a organização
  • os dados que os usuários finais poderão acessar por meio do plug-in Isogeo são armazenados no mesmo banco de dados ao qual todos os usuários têm acesso
  • é provável que alguns desses dados sejam úteis para todos os usuários

Nesse caso, o usuário X pode :

  • autenticar o plug-in com o client_secrets.json comum a toda a organização
  • configurar a conexão com o banco de dados da organização no arquivo db_connections.json
  • salvar pesquisas rápidas que englobam metadados relacionados a dados úteis para todos os usuários

Depois que o usuário X tiver feito essa configuração, ele poderá gerar um arquivo .zip a partir do diretório de instalação do plug-in em sua estação de trabalho e distribuí-lo aos cerca de dez usuários finais que não precisarão se autenticar, configurar a conexão com o banco de dados ou salvar determinadas pesquisas rápidas.

Procedimento

  1. Instale o plug-in e autentique-se inserindo o local do arquivo client_secrets.json fornecido pela equipe do Isogeo. O arquivo é copiado para a pasta _auth no diretório de instalação do plug-in na estação de trabalho do usuário.

  2. Na mesma estação de trabalho, configure o arquivo:

    1. salvando pesquisas rápidas
    2. definindo uma pesquisa padrão
    3. configurando as conexões de banco de dados no arquivo _user/db_connections.json

  3. No mesmo computador, crie um arquivo .zip no diretório de instalação do plug-in:

    Esse arquivo .zip contém os arquivos client_secrets.json, quicksearches.json e db_connections.json resultantes dos dois primeiros estágios.

  4. Distribua o arquivo .zip resultante para outros usuários, que poderão instalar o plug-in QGIS Isogeo diretamente do arquivo isogeo_search_engine.zip (menu"Install/Manage extensions" > guia"Install from ZIP").

    Para os usuários que instalarem o plug-in dessa forma, a autenticação será automática (sem passar pelo formulário de autenticação) porque o arquivo client_secrets.json já estará presente na pasta _auth do plug-in Isogeo.