dg:Guia de preenchimento da Planilha de Doadores: mudanças entre as edições
m (→Definição) |
m (→Conteúdo) |
||
| Linha 17: | Linha 17: | ||
A planilha consiste do seguinte (da coluna esquerda para direita): | A planilha consiste do seguinte (da coluna esquerda para direita): | ||
* local_id: Número de ID do doador; | * <code>local_id</code>: Número de ID do doador; | ||
*scope_label: Código da área de atuação do doador; | *<code>scope_label</code>: Código da área de atuação do doador; | ||
*shortName: Código ou nome curto do doador; | *<code>shortName</code>: Código ou nome curto do doador; | ||
*vat_id: número de CNPJ; | *<code>vat_id</code>: número de CNPJ; | ||
*legalName: Nome do doador; | *<code>legalName</code>: Nome do doador; | ||
*wikidata_id: Código de identificador Wikidata; | *<code>wikidata_id</code>: Código de identificador Wikidata; | ||
*url: endereço do site da entidade; | *<code>url</code>: endereço do site da entidade; | ||
*donor_date: data de inclusão do doador; | *<code>donor_date</code>: data de inclusão do doador; | ||
*donor_status: a situação do relacionamento entre doador e o Instituto. | *<code>donor_status</code>: a situação do relacionamento entre doador e o Instituto. | ||
== Preenchimento == | == Preenchimento == | ||
| Linha 37: | Linha 37: | ||
Estas são as instruções de preenchimento: | Estas são as instruções de preenchimento: | ||
==== local_id: Número de ID ==== | ==== <code>local_id</code>: 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... | É 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 ==== | ==== <code>scope_label</code>: Á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. | É 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. | ||
| Linha 49: | Linha 49: | ||
O código dos municípios do Brasil é dado por esta planilha: [ adicionar link ] | O código dos municípios do Brasil é dado por esta planilha: [ adicionar link ] | ||
; shortName: Nome curto () | ; <code>shortName</code><nowiki>: nome curto</nowiki>: Nome curto () | ||
;<code>vat_id</code><nowiki>: número de CNPJ</nowiki>:Pesquisar o CNPJ pela Internet. | |||
;vat_id | ;<code>legalName</code><nowiki>: nome do doador</nowiki>:Nome do doador; | ||
;legalName | ;<code>wikidata_id</code><nowiki>: código de identificador Wikidata)</nowiki>:Nome do doador; | ||
;wikidata_id | ; <code>url</code><nowiki>: endereço do site da entidade)</nowiki>:endereço do site da entidade; | ||
; url | |||
;donor_date:data de inclusão do doador; | ;donor_date:data de inclusão do doador; | ||
;donor_status:status. [precisamos ver o que é] | ;donor_status:status. [precisamos ver o que é] | ||
Edição das 18h57min de 28 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.
- 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 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.
O código dos municípios do Brasil é dado por esta planilha: [ adicionar link ]
shortName: nome curto- Nome curto ()
vat_id: número de CNPJ- Pesquisar o CNPJ pela Internet.
legalName: nome do doador- 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 é]