dg:Guia de preenchimento da Planilha de Doadores
Este guia aborda o que é, qual é o conteúdo e explica o preenchimento da planilha de doadores.
Definição
A Planilha de Doadores donor.csv
lista os dados principais das entidades que são potenciais doadores de pacotes de dados ao Instituto AddressForAll, em especial aos projetos AddressForAll e Digital guard.
Há uma planilha desta por país, as quais são armazenadas nos repositórios do GitHub.
- Exemplo de Planilha de Doadores: https://git.digital-guard.org/digital-guard/preserv-BR/blob/main/data/donor.csv
Uso
Os dados desta planilha são usados para identificar e informar sobre os doadores e dar-lhes atribuição (crédito ou autoria) em qualquer meio de armazenamento, publicação e distribuição do material que o Instituto venha a fazer.
Por exemplo, um software do Instituto usa os dados da planilha para adicionar os dados do doador no box de metadados dos pacotes armazenados no Digital Guard (exemplo).
Conteúdo
A planilha consiste do seguinte (da coluna esquerda para direita):
- local_id: Número de ID do doador;
- scope_label: Código da área de atuação do doador;
- shortName: Código ou nome curto do doador;
- vat_id: número de CNPJ;
- legalName: Nome do doador;
- wikidata_id: Código de identificador Wikidata;
- url: endereço do site da entidade;
- donor_date: data de inclusão do doador;
- donor_status: a situação do contato.
Preenchimento
Quem preenche
Ela deve ser preenchida após a realização de contato entre um representante do Instituto AddressForAll.
Instruções de preenchimento
Estas são as instruções de preenchimento:
local_id: Número de ID
É dado por quem preenche no momento da inclusão na planilha, pela ordem numérica. Se o último foi 36, o próximo será 37, 38, 39...
scope_label: Área de atuação do doador
É um código que identifica área de atuação do doador, que pode ser um município, estado ou província ou o país todo.
O código é composto pelos identificadores de duas letras de país e estado, e o nome do município sem acentos e preposições, separados por hifens, tudo sem espaço. Por exemplo, se a área de atuação do doador é o município de São José dos Pinhais, estado do Paraná, Brasil, seu código será BR-PR-SaoJosePinhais.
O código de país e estado (ou província) é dado pela norma ISO 3166-2. Há um link para esta norma no README do repositório de cada país no projeto Digital Guard no GitHub. Do Brasil é https://github.com/digital-guard/preserv-BR#readme; Colômbia https://github.com/digital-guard/preserv-CO#readme; Peru https://github.com/digital-guard/preserv-PE#readme, etc.
O código dos municípios do Brasil é dado por esta planilha: [ adicionar link ]
- shortName
- Nome curto ()
- vat_id (número de CNPJ)
- Pesquisar o CNPJ pela Internet.
- legalName (
- Nome do doador;
- wikidata_id (código de identificador Wikidata)
- Nome do doador;
- url (endereço do site da entidade)
- endereço do site da entidade;
- donor_date
- data de inclusão do doador;
- donor_status
- status. [precisamos ver o que é]