Plugin QGIS: LizPack Publisher

O LizPack Publisher é uma extensão do QGIS Desktop que liga o QGIS às suas instâncias. Sem sair do QGIS, pode percorrer os ficheiros de uma instância, abrir um projeto que nela se encontre, publicar o projeto aberto no seu portal e trabalhar na base de dados PostgreSQL/PostGIS da instância.

A sua janela tem cinco separadores.

Na parte inferior da janela, o Journal regista cada operação. Abre-se com um clique no seu título e, automaticamente, em caso de erro. O seu botão Copiar coloca todo o registo na área de transferência: é isso que deve anexar a um pedido ao suporte.

O LizPack Publisher está publicado no repositório oficial de extensões do QGIS. Instala-se e atualiza-se a partir do QGIS, como qualquer outra extensão.

1. No QGIS, abra o menu Módulos e, em seguida, Gerir e instalar módulos.
2. No separador Todos, procure LizPack.
3. Selecione LizPack Publisher e inicie a instalação.
4. Abra o plugin através do seu ícone na barra de ferramentas Web, ou através do menu Web, submenu LizPack.

É necessário, no mínimo, o QGIS 3.16. O plugin não acrescenta nenhuma biblioteca à sua instalação do QGIS.

A página Plugins QGIS do Marketplace apresenta o plugin, mas o seu botão indica Disponível em breve: não há nenhum ficheiro para transferir. Utilize o QGIS.

O plugin utiliza as credenciais da sua área de cliente: o seu endereço de e-mail e a sua palavra-passe. O início de sessão faz-se em dois passos, no separador Iniciar sessão.

1. Introduza o seu e-mail e a sua palavra-passe e clique em Iniciar sessão. Marque Se souvenir de mes identifiants para não ter de as introduzir novamente: a palavra-passe fica guardada no gestor de autenticação do QGIS, que a cifra.
2. Escolha uma instância na lista. Cada uma apresenta o seu estado, por exemplo Em curso ou Parada.
3. Clique em Connecter à l'instance. A indicação Instance connectée confirma a ligação, e o separador Projetos apresenta os ficheiros da instância.

Só uma instância iniciada aceita a ligação: uma instância Parada deve primeiro ser iniciada a partir de Instâncias; uma instância suspensa por causa da subscrição é desbloqueada com a renovação da subscrição. Uma instância Suspendue (quota) continua acessível para libertar espaço na sua base de dados, mas a publicação, o envio de ficheiros e as importações são recusados.

Depois de iniciar sessão, e se o seu plano der acesso à base de dados, o plugin acrescenta ao QGIS uma ligação PostgreSQL com o nome LizPack seguido do nome da instância. Aparece no navegador do QGIS depois de clicar com o botão direito em PostgreSQL e, em seguida, em Atualizar. Déconnexion remove-a.

As credenciais da base de dados, a quota e as suas permissões são lidas no início de sessão. Após uma alteração feita na área de cliente, o botão Rafraichir volta a lê-las sem terminar a sessão.

As instâncias de uma equipa

Se for membro de uma equipa, aparece uma lista Espace por cima das instâncias: A minha conta e, em seguida, cada proprietário que o convidou, com a sua função. Trabalha aí com os direitos que esse proprietário lhe atribuiu. Sem o direito Gerir os ficheiros, o separador Projetos não apresenta nenhum ficheiro e o separador Upload fica desativado; o separador PostGIS continua disponível.

O separador Projetos abre no Gestionnaire de fichiers: a árvore da instância, a mesma do seu gestor de ficheiros na área de cliente. Um duplo clique entra numa pasta, ← Retour sobe um nível.

Por baixo da lista, há ícones que atuam na pasta apresentada; o seu nome aparece ao passar o rato: Nova pasta, Uploader des fichiers ici, Uploader un dossier ici, Supprimer la sélection, Mudar o nome. O clique com o botão direito propõe as mesmas operações, mais Copiar e Cortar e, depois, Colar ou Déplacer ici na pasta de destino. Ctrl+clique seleciona vários elementos; a eliminação pede sempre confirmação.

Abrir um projeto no QGIS

Selecione um ficheiro .qgs ou .qgz e clique em Abrir, ou faça duplo clique sobre ele. O plugin pergunta onde o guardar no seu computador e, em seguida, transfere toda a pasta do projeto, incluindo as subpastas, para que os caminhos relativos continuem válidos. O QGIS abre depois o projeto, e essa pasta passa a ser o seu diretório de trabalho.

Durante o processo, as camadas PostGIS do projeto são religadas ao endereço da base de dados acessível a partir do seu computador, e a palavra-passe da base de dados fica guardada no gestor de autenticação do QGIS. Para um projeto situado na raiz da instância, abri-lo equivale a transferir toda a instância: o plugin pede confirmação antes.

O separador Upload

O separador Upload envia uma pasta inteira: escolha-a em Dossier local e clique em Uploader le dossier. A pasta chega sempre à raiz da instância, com o seu próprio nome. Para a colocar noutro local, utilize antes Uploader un dossier ici a partir da pasta pretendida.

A publicação faz-se no separador Projetos, bloco Publier vers Lizmap. Envia o projeto aberto no QGIS, quer venha da instância, quer do seu computador.

1. Abra ou guarde o seu projeto no QGIS. O seu nome aparece em frente a Projet actif.
2. Na lista de ficheiros, vá até à pasta de destino. O campo Destination propõe essa pasta seguida do nome do seu projeto. Um clique num ficheiro da lista substitui-o por esse ficheiro.
3. Opcional: clique em Validar o projeto. O servidor examina o projeto sem publicar nada, e o seu relatório abre-se no separador Valider un projet.
4. Clique em Publier vers Lizmap. O plugin guarda o projeto e envia-o de uma só vez.

Seguem com o projeto o seu ficheiro de configuração Lizmap (.qgs.cfg), se estiver ao lado, e, num projeto .qgs, os ficheiros de dados que este indica por um caminho relativo; um shapefile segue com os seus ficheiros associados. As ligações PostGIS são reescritas para o endereço interno da base de dados da instância. O portal tem em conta a nova versão de imediato.

Não seguem: os dados indicados por um caminho absoluto e os dados de um projeto .qgz, que segue sozinho com a sua configuração. Guarde o projeto em .qgs com caminhos relativos, ou envie os seus dados à parte.

As verificações antes do envio

O servidor só recusa um projeto em dois casos: camadas em projeções diferentes e ligações PostgreSQL que não levam à base de dados da instância. Para as projeções, o plugin propõe reprojetar as camadas de ficheiro antes do envio; é criada uma cópia ao lado de cada ficheiro, e os originais ficam intactos. Uma camada PostGIS, essa, reprojeta-se na base de dados.

O plugin avisa também a partir de três composições de impressão preenchidas: o servidor relê-as todas sempre que o projeto é aberto, alguns segundos cada uma, e o mapa pode deixar de carregar. O relatório de Valider un projet classifica os restantes avisos por gravidade; escolha uma linha para ler a sua consequência e a sua solução. Estes avisos degradam o mapa sem impedir a publicação. A mesma verificação existe na área de cliente: consulte Publicar um projeto.

O separador PostGIS trabalha diretamente na base de dados PostgreSQL/PostGIS da instância ligada. Requer o acesso à base de dados, reservado ao plano Pro e superiores; na conta de uma equipa, é também necessário o direito Ver as bases de dados. Sem este acesso, o separador apresenta PostGIS non disponible pour cette instance.

Adicionar uma tabela como camada

Charger les tables lista as tabelas e vistas da base de dados, com o seu esquema, a sua coluna de geometria e o seu SRID. Faça duplo clique numa tabela, ou selecione-a e clique em Ajouter à QGIS: a tabela entra no projeto como camada. Uma tabela sem geometria entra como tabela de atributos.

Importar uma camada para a base de dados

O bloco Importer une couche dans PostGIS copia uma camada vetorial do projeto para a base de dados. Escolha a Couche QGIS, verifique o Schéma e o nome da Table propostos e clique em Importer dans PostGIS. No fim, a lista de tabelas é recarregada.

Estado da base de dados

Diagnostiquer la base analisa a base de dados sem escrever nada nela: índices espaciais em falta, tabelas sem chave primária utilizável, estatísticas desatualizadas, polígonos demasiado detalhados. A coluna Correction indica o que o plugin pode fazer: Automatique, Sur confirmation ou À la main.

Tout optimiser só aplica as correções sem risco, como um índice ou estatísticas. As que modificam uma tabela selecionam-se na lista e executam-se com Optimiser la sélection, após uma confirmação que detalha o seu efeito. Cada correção aplicada deixa no registo o comando que a anula. Exporter guarda o diagnóstico em CSV, ou num script SQL para voltar a executar.