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

Contexto¶

O diretório de instalação do plug-in Isogeo do QGIS

WindowsUbuntu

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 arquivo client_secrets.json usado paraautenticação (na subpasta _auth)
pesquisas rápidas e a pesquisa padrão, que são gravadas em um arquivo quicksearches.json (na subpasta _user)
conexões com bancos de dados configurados no arquivo db_connections.json (na subpasta _user)

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¶

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.
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
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.
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.