Escolha uma base e uma pergunta de uso
A primeira publicação não precisa abranger toda a prefeitura. Escolha um conjunto cuja manutenção seja viável e que responda a uma necessidade reconhecida. Uma lista de equipamentos públicos pode ajudar a localizar serviços; registros agregados de atendimento podem apoiar análise de procura. A utilidade deve ser explicitada sem prometer que a abertura resolverá sozinha um problema de gestão.
Converse com a área que produz o dado e com possíveis usuários. Pergunte quais campos são necessários, como seriam combinados e qual atualização faria diferença. Esse diálogo ajuda a evitar arquivos que reproduzem relatórios internos incompreensíveis fora da secretaria. Também revela quando uma informação solicitada ainda não possui qualidade suficiente para o uso pretendido.
Defina o que cada linha representa antes de extrair. Ela pode corresponder a uma unidade, um evento ou uma consolidação mensal. Misturar essas unidades na mesma tabela dificulta análise e pode duplicar resultados. O conteúdo sobre qualidade dos indicadores municipais aprofunda a conferência quando a base será usada para calcular ou comparar medidas.
Revise acesso e risco antes de exportar
Nem toda base mantida pelo poder público pode ser divulgada integralmente. Identifique dados pessoais, informações sujeitas a sigilo e restrições específicas do domínio. A análise deve considerar o conteúdo e a finalidade da publicação, com participação dos responsáveis adequados. A simples existência de uma coluna em um sistema não é razão suficiente para torná-la pública.
Retirar nomes e documentos não garante anonimização. Combinações de bairro, idade, data e ocorrência rara podem permitir associação a uma pessoa. Avalie também cruzamentos plausíveis com outras bases disponíveis. Quando o risco for relevante, considere agregação, redução de detalhe ou outra forma de divulgação compatível com a finalidade, submetendo a decisão à avaliação pertinente.
A LGPD define dados pessoais e parâmetros para seu tratamento. Use esse fundamento para avaliar necessidade e proteção, sem presumir que transparência e privacidade sejam escolhas incompatíveis. É possível oferecer informação útil sobre uma política pública com desenho adequado, mas a solução depende das características da base e das regras aplicáveis ao caso.
Prepare uma estrutura consistente para reutilização
Evite arquivos com títulos decorativos, células mescladas e totais inseridos entre registros quando o objetivo for processamento. Uma tabela deve ter cabeçalho estável e tipos de campo consistentes. Escolha formato aberto apropriado ao conteúdo e à capacidade de manutenção, explicando codificação, separadores e convenções utilizadas.
Padronize datas, unidades, códigos e representação de valores ausentes. Diferencie zero de informação não disponível e de situação em que o campo não se aplica. Não use a mesma expressão para significados distintos. Preserve identificadores estáveis quando forem necessários e seguros, para que atualizações possam ser relacionadas sem depender de nomes sujeitos a alteração.
Confira se a exportação mantém caracteres, casas decimais e zeros relevantes em códigos. Abra o resultado em mais de uma ferramenta e verifique uma amostra contra a origem. Uma planilha que parece correta na tela pode ter convertido automaticamente códigos em números ou datas. O teste deve ocorrer no arquivo que será efetivamente publicado.
Explique cada campo com um dicionário
O dicionário deve apresentar nome do campo, significado, tipo, unidade, valores permitidos e forma de preenchimento. Inclua exemplos sintéticos quando ajudarem a compreensão. Para códigos, disponibilize a tabela de referência ou explique como encontrá-la. Uma coluna chamada situação não informa por si só se representa cadastro, atendimento ou resultado.
Descreva também regras que afetam a leitura: duplicidades legítimas, registros cancelados, mudanças de classificação e limites de cobertura. Se uma linha pode aparecer mais de uma vez porque houve atualização, explique como identificar a versão válida. Usuários externos não devem depender de conhecer práticas internas para interpretar o arquivo.
O glossário do Governo Digital diferencia conceitos como dados abertos, dado pessoal e dados de referência. Essa distinção ajuda a separar acesso, formato e significado. Disponibilizar um arquivo sem documentação semântica pode permitir download, mas continuar impedindo uso confiável. O dicionário deve acompanhar a evolução da base, em vez de ser escrito uma única vez e esquecido.
Publique contexto, licença e responsável
Além do arquivo, informe título compreensível, descrição, órgão responsável, cobertura territorial, período de referência, data da extração e frequência prevista de atualização. Explique limitações relevantes e como reportar um problema. Essas informações permitem que a pessoa avalie se o conjunto atende à sua pergunta antes de iniciar a análise.
Deixe explícitas as condições de reutilização por uma licença adequada e validada institucionalmente. Não presuma que ausência de informação sobre licença equivale a permissão irrestrita. A escolha precisa ser coerente com o conjunto e suas restrições. A equipe responsável deve saber quem aprovou a publicação e qual versão passou pela revisão.
O Catálogo Nacional de Dados destaca a organização e padronização de metadados para localização e interpretação. Essa referência não implica que toda publicação municipal esteja automaticamente integrada ao catálogo nacional. Defina onde o conjunto será descoberto e como páginas e catálogos apontarão para uma versão reconhecida, sem criar endereços concorrentes que ninguém mantém.
Faça uma leitura como usuário externo
Peça a alguém que não participou da preparação para baixar o arquivo, localizar o dicionário e responder a uma pergunta simples. Observe se consegue identificar período, território e unidade de registro. Se precisar perguntar ao produtor o significado de vários campos, a documentação ainda está incompleta.
Execute verificações de quantidade de registros, campos obrigatórios, valores fora do domínio e diferenças em relação à extração anterior. Documente divergências esperadas. Um aumento de registros pode refletir ampliação da cobertura, mudança de regra ou erro. Publicar sem explicar essa diferença transfere ao usuário o risco de interpretar uma alteração técnica como mudança na realidade municipal.
Confira o conteúdo público final, inclusive anexos e propriedades dos arquivos. Planilhas podem conter abas ocultas, comentários ou informações que não deveriam sair da instituição. A revisão deve examinar a entrega efetiva, não apenas a tabela selecionada na tela. Registre quem conferiu o conteúdo e a evidência de que a versão aprovada foi a publicada.
Defina manutenção, correção e mudança de versão
A frequência deve ser viável e útil para o uso declarado. Indique a data da próxima atualização quando houver compromisso definido e explique atrasos relevantes. Não mantenha aparência de atualidade apenas porque a página foi editada: a referência dos dados e o momento da publicação são informações diferentes.
Mudanças incompatíveis, como remover campo ou redefinir categoria, precisam ser comunicadas. Preserve histórico apropriado e informe qual versão substitui a anterior. Quando houver erro, publique a correção com descrição do alcance e avalie se usuários precisam refazer análises. Corrigir silenciosamente valores pode comprometer trabalhos que já estavam em andamento.
Se a atualização vier de uma integração, documente produtor, consumidor, validações e responsáveis. O guia de interoperabilidade complementa esse desenho. A automação deve manter uma etapa de controle proporcional ao risco; gerar um arquivo automaticamente não garante que sua definição ou conteúdo continue adequado à publicação.
Comece com um conjunto sustentável
Uma primeira entrega útil reúne arquivo reutilizável, dicionário, metadados, licença, revisão de restrições e responsável por manutenção. Teste a atualização seguinte antes de ampliar o número de conjuntos. Isso revela se o procedimento depende de uma pessoa, se a exportação é repetível e se as verificações conseguem detectar mudanças inesperadas.
Acompanhe erros reportados, dúvidas recorrentes e usos conhecidos sem inventar impacto ou reduzir avaliação à contagem de downloads. Esses sinais ajudam a melhorar documentação e escolher o próximo conjunto. A publicação deve facilitar compreensão e participação, sem expor pessoas nem produzir uma obrigação de manutenção que a equipe não consegue sustentar.
O Grupo Edge conecta dados, integração e automação à operação institucional. A visão de tecnologia para o setor público apresenta esse posicionamento. O roteiro não pressupõe um portal comercial próprio nem transfere ao fornecedor a responsabilidade pela decisão de abertura e pela qualidade dos dados municipais.
Perguntas frequentes
Uma planilha disponível para download já é dado aberto reutilizável?
O download é apenas parte da entrega. Formato, licença, documentação, qualidade e manutenção precisam permitir que pessoas e sistemas interpretem e reutilizem o conjunto.
Retirar nome e CPF garante anonimização?
Não. É necessário avaliar possibilidade de associação direta ou indireta, inclusive por combinações e cruzamentos com outras informações disponíveis.