a4a:Convenções/Visualização de dados: mudanças entre as edições

De Documentação
(→‎Tabela viz-de-para: Atualiza localização e nome da tabela.)
Linha 28: Linha 28:


=== Tabela viz-de-para ===
=== Tabela viz-de-para ===
A tabela '''[https://docs.google.com/spreadsheets/d/1CL6f0I9DSpqKxKC7QNJGCfyabq7mDOVab5QBGV5VLOk/edit#gid=592701333 viz-de-para]''' é uma alternativa para não lidar com [https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv fromCutLayer_toVizLayer.csv] diretamente no git.
A tabela <strike>'''[https://docs.google.com/spreadsheets/d/1CL6f0I9DSpqKxKC7QNJGCfyabq7mDOVab5QBGV5VLOk/edit#gid=592701333 viz-de-para]'''</strike> '''[https://docs.google.com/spreadsheets/d/1_4iF6n2JQNl-CK0Kp6zv3LesDVLsMSOYyxNXLlAW-3A/edit#gid=0 issue144-entregaESRI] é uma alternativa para não lidar com [https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv fromCutLayer_toVizLayer.csv] diretamente no git.


No entanto:
No entanto:

Edição das 14h31min de 26 de julho de 2023

Para visualizar camadas de dados ingestados em interface de terceiros foram definidas regras para gerar url única.

Url

Por exemplo, a camada de quadras doada pela prefeitura de Natal pode ser visualizada por meio dos links:


Quando houver possibilidade de ambiguidade, por exemplo, o pacote de dados possuir mais de uma camada, é necessário especificar a camada:

Redirecionamento

Tabela viz-de-para

A tabela viz-de-para issue144-entregaESRI é uma alternativa para não lidar com fromCutLayer_toVizLayer.csv diretamente no git.

No entanto:

fromCutLayer_toVizLayer.csv

Foi convencionado que o link do provedor de serviços esteja oficialmente em https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv.

Tal arquivo possui os seguintes campos:

campo descrição exemplo
jurisdiction_pack_layer Campo formado por <isolabel_ext>/<identificador completo do pacote>/<nome da camada>. BR-RN-Natal/_pk0073.01/block
hash_from sha256 do arquivo que contém a camada de dados. 63f265730d08e440bbfaf630a78c053968ee7ec12447b19af9554f5a8a78614f.zip
url_layer_visualization Url do arquivo no serviço de visualização. https://addressforall.maps.arcgis.com/apps/mapviewer/index.html?layers=84999bdcf69049bf912afbd03425b299

Importante: não adicione linhas em branco ao final do arquivo.

O que fazer após atualizar fromCutLayer_toVizLayer.csv

Importante: o target redirects_update consome o conteúdo de fromCutLayer_toVizLayer.csv. Ele não consome o conteúdo da tabela viz-de-para.

Atualizar fromCutLayer_toVizLayer.csv não atualiza automaticamente o datalake em produção. Para atualizá-lo, executar os comandos:

cd /var/gits/_dg/preserv
git pull
cd /var/gits/_dg/preserv/src
make redirects_update pg_datalake=dl05s_main