Atualização e validação no GitHub⚓︎
Premissas⚓︎
Sempre que os dados forem alterados as novas informações devem ser atualizadas no repositório do GitHub.
1) O nome da planilha não deve ser alterado; 2) A ordem das colunas não podem ser alteradas; 3) O arquivo deve ser salvo no formato .xlxs
1. Atualização⚓︎
- Clicar na pasta "dataset" para alterar os aquivos: README, CHANGELOG, CONTRIBUTING, DATAPACKAGE.yaml
NÃO ALTERAR/EDITAR DATAPACKAGE.json, apenas mexer no DATAPACKAGE.yaml.
- Clicar na pasta "upload" para os arquivos em excel (.xlxs)
As modificações automáticas só serão publicadas no CKAN se as alterações forem realizadas nestas pastas.
1.1 Upload⚓︎
Após a atualização dos dados, acesse a sua conta do Github e em seguida acesse o repositório do conjunto de dados a ser alterado.
- Na pasta /upload/ clique em Add file (Adicionar arquivo) e em seguida clique em upload files (upload de arquivos*);
- Arraste o arquivo ou clique em choose your files para selecionar o arquivo no computador local.
- Após o arquivo ser carregado digite na área Commit changes uma mensagem curta e significativa que descreva a alteração feita no arquivo e clique no botão verde Commit changes
Exemplo: Atualiza arquivo conforme a Deliberação XX.
1.2 Alterações nos demais arquivos: README, CHANGELOG, CONTRIBUTING, DATAPACKAGE.yaml⚓︎
Usaremos como exemplo o arquivo "Changelog".
- Acesse o arquivo CHANGELOG.md dentro da pasta dataset;
- Clique em Edit this file;
- Após as informações serem inseridas digite na área Commit changes uma mensagem curta e significativa que descreva a alteração feita no arquivo e clique no botão verde Commit changes.
Nota: Para acrescentar um link em algum texto coloque entre colchetes o [TEXTO] e o link entre parênteses(LINK). * Exemplo: '[texto] (link)', não deve haver espaço entre o último colchete eo primeiro parêntese.
2. Validação⚓︎
Após realizar o commit do arquivo é necessário verificar se o mesmo foi validado, ou seja, se o arquivo está de acordo com as regras de validação estabelecidas.
Caso não seja realizado nenhuma alteração do arquivo carregado o fluxo de validação não será iniciado, pois o sistema irá considerar a mesma hash.
- Na página do Repositório clique em Actions.
-
Se o processo for exibido como concluído em todas as etapas, apenas verifique no Portal de Dados Abertos se os dados alterados realmente foram carregados.
-
Se aparecer algum problema durante a validação, siga os passos abaixo:
-
Clique em validate e no link que apresenta o erro de validação;
- Em seguida verifique qual o erro apresentado e faça as correções necessárias.
- Faça novamente o upload do arquivo corrigido e repita os passos executados anteriormente.
Criado em: January 10, 2024 11:38:25