dg:Guia de preenchimento da Planilha de Doadores: mudanças entre as edições

De Documentação
Sem resumo de edição
Linha 47: Linha 47:
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 [https://github.com/digital-guard Digital Guard no GitHub]. Exemplos: [https://github.com/digital-guard/preserv-BR#readme Brasil], [https://github.com/digital-guard/preserv-CO#readme Colômbia], [https://github.com/digital-guard/preserv-PE#readme Peru], etc.
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 [https://github.com/digital-guard Digital Guard no GitHub]. Exemplos: [https://github.com/digital-guard/preserv-BR#readme Brasil], [https://github.com/digital-guard/preserv-CO#readme Colômbia], [https://github.com/digital-guard/preserv-PE#readme Peru], etc.


O código dos municípios do Brasil é dado por esta planilha: [ adicionar link ]
==== <code>shortName</code>: nome curto ====
No caso de prefeituras, será o código de 2 letras do estado e o código de 3 letras do município. O código dos municípios do Brasil é dado por esta planilha: https://github.com/datasets-br/city-codes/blob/master/data/br-city-codes.csv, na coluna ´abbrev3´.


; <code>shortName</code><nowiki>: nome curto</nowiki>: Nome curto ()
==== <code>vat_id</code>: número de CNPJ ====
;<code>vat_id</code><nowiki>: número de CNPJ</nowiki>:Pesquisar o CNPJ pela Internet.
Pesquisar o CNPJ pela Internet.
;<code>legalName</code><nowiki>: nome do doador</nowiki>:Nome do doador;
 
;<code>wikidata_id</code><nowiki>: código de identificador Wikidata)</nowiki>:Nome do doador;
==== <code>legalName</code>: nome do doador ====
; <code>url</code><nowiki>: endereço do site da entidade)</nowiki>:endereço do site da entidade;
Nome do doador como se identifica.
;donor_date:data de inclusão do doador;
 
;donor_status:status. [precisamos ver o que é]
==== <code>wikidata_id</code>: código de identificador Wikidata ====
O código é encontrado no site Wikidata, pela barra de pesquisa: https://www.wikidata.org/wiki/Wikidata:Main_Page
 
==== <code>url</code>: endereço do site da entidade)
Pesquisar o endereço principal do website da entidade pela Internet.
 
==== donor_date: data de inclusão do doador ====
Data de inclusão do doador na planilha no formato ano-mês-dia, exemplo 2023-08-29.
 
==== donor_status:status. [precisamos ver o que é]
[[Categoria:Digital-guard]]
[[Categoria:Digital-guard]]

Edição das 03h40min de 29 de agosto de 2023

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.

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 relacionamento entre doador e o Instituto.

Preenchimento

Quando e quem preenche

Obrigatório: após a realização de contato entre um representante do Instituto (CRM) e o doador. O representante inclui o doador na planilha.

Opcional: quando é feita por decisão unilateral de um integrante do Instituto para um futuro contato ou por outro motivo.

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. Exemplos: Brasil, Colômbia, Peru, etc.

shortName: nome curto

No caso de prefeituras, será o código de 2 letras do estado e o código de 3 letras do município. O código dos municípios do Brasil é dado por esta planilha: https://github.com/datasets-br/city-codes/blob/master/data/br-city-codes.csv, na coluna ´abbrev3´.

vat_id: número de CNPJ

Pesquisar o CNPJ pela Internet.

legalName: nome do doador

Nome do doador como se identifica.

wikidata_id: código de identificador Wikidata

O código é encontrado no site Wikidata, pela barra de pesquisa: https://www.wikidata.org/wiki/Wikidata:Main_Page

==== url: endereço do site da entidade) Pesquisar o endereço principal do website da entidade pela Internet.

donor_date: data de inclusão do doador

Data de inclusão do doador na planilha no formato ano-mês-dia, exemplo 2023-08-29.

==== donor_status:status. [precisamos ver o que é]

Disponível em “https://wiki.addressforall.org/w/index.php?title=dg:Guia_de_preenchimento_da_Planilha_de_Doadores&oldid=2674”