dg:Guia de preenchimento da Planilha de Pacotes

De Documentação
Revisão de 12h57min de 31 de agosto de 2023 por 0e1 (discussão | contribs) (→‎Conteúdo: Completos nas descrições dos campos da tabela.)

Este guia aborda o que é, para que serve e qual é o conteúdo, e explica o preenchimento da planilha de pacotes.

Definição

A Planilha de Pacotes donatedPack.csv lista os dados principais dos pacotes fornecidos pelos doadores (ver guia) 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 pacotes de dados, dar-lhes atribuição (crédito ou autoria) e preencher seus metadados, 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 pacote no box de metadados dos pacotes armazenados no Digital Guard (exemplo).

Conteúdo

A planilha consiste do seguinte (da coluna esquerda para direita):

  • pack_id: número de ID do pacote. Formato pela concatenação de donor_id e pack_count.
  • donor_id: número de ID do doador. Referencia local_id de donor.csv;
  • pack_count: valor sequencial, começando em 1 e incrementado a cada novo pacote doado pelo doador;
  • lst_vers: versão do pacote doado. Começa em 1 e é incrementado caso o doador forneça uma versão nova do pacote de dados;
  • user_resp: nome de quem fez a análise dos dados;
  • accepted_date: data de aceitação do pacote de dados;
  • scope: jurisdição do doador ou da área que o pacote de dados abrange. Valor padronizado, igual ao isolabel_ext;
  • about: descrição curta do conteúdo do pacote;
  • author: autoria do pacote;
  • contentReferenceTime: data de referência do conteúdo do pacote;
  • license_is_explicit: se a licença foi explicitamente declarada;
  • license: ID da licença. Formado pela concatenação de id_label-id_version. Exemplo: cc0-1.0. Ver digital-guard/licenses.;
  • uri_objtype: x;
  • uri: x;
  • isat_arcgis: x;
  • status: x.

Preenchimento

Quando e quem preenche

Instruções de preenchimento

Estas são as instruções de preenchimento:

pack_id: número de ID do pacote

Número

donor_id: número de ID do doador

Serve para indicar quem doou o pacote de dados. O ID vem do local_id da Planilha de Doadores, referente ao país.

Isso é essencial e deve-se certificar que o ID esteja correto, do contrário a autoria do pacote será atribuído a um ente errado.

pack_count: x;

lst_vers: x;

user_resp: membro da equipe técnica do Instituto

Nome do membro do Instituto que fez o review/análise do pacote de dados;

accepted_date: data de aceitação do pacote de dados;

Data de quando a última versão [?] do pacote de dados foi aceita através de uma análise positiva;

scope: área que o pacote de dados abrange;

É um código que identifica área de abrangência do pacote de dados, que pode ser um país, uma subdivisão do país (estado ou província), ou um município (ou equivalente local).

about: x;

author: x;

contentReferenceTime: x;

license_is_explicit: se a licença foi explicitamente declarada;

license: x;

uri_objtype: x;

uri: x;

isat_arcgis: x;

status: x.

...


Ver também