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

Edição atual tal como às 04h12min de 22 de setembro de 2023

Nota: Para a versão planilha de doadores, ver Guia de preenchimento da Planilha de Doadores

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.

Exemplo de Planilha de Pacotes: https://git.digital-guard.org/digital-guard/preserv-BR/blob/main/data/donatedPack.csv

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

dg:Guia de preenchimento da Planilha de Doadores

@@ Linha 1: / Linha 1: @@
+{{Para|a versão planilha de doadores|dg:Guia de preenchimento da Planilha de Doadores|Guia de preenchimento da Planilha de Doadores}}
 Este guia aborda o que é, para que serve e qual é o conteúdo, e explica o preenchimento da planilha de pacotes.
@@ Linha 5: / Linha 7: @@
 A '''Planilha de Pacotes''' <code>donatedPack.csv</code> lista os dados principais dos pacotes fornecidos pelos doadores (ver [[dg:Guia_de_preenchimento_da_Planilha_de_Doadores|guia]]) ao [[Instituto AddressForAll]], em especial aos projetos [[Documentação AddresForAll|AddressForAll]] e [[Documentação Digital-guard|Digital Guard]].
+Há uma planilha desta por país, as quais são armazenadas nos [https://git.digital-guard.org/ repositórios do GitHub].
+*''Exemplo de Planilha de Pacotes:'' https://git.digital-guard.org/digital-guard/preserv-BR/blob/main/data/donatedPack.csv
 == 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.
@@ Linha 11: / Linha 15: @@
 == Conteúdo ==
+A planilha consiste do seguinte (da coluna esquerda para direita):
+* <code>pack_id</code>: número de ID do pacote. Formato pela concatenação de <code>donor_id</code> e <code>pack_count</code>.
+* <code>donor_id</code>: número de ID do doador. Referencia <code>local_id</code> de donor.csv;
+* <code>pack_count</code>: valor sequencial, começando em 1 e incrementado a cada novo pacote doado pelo doador;
+* <code>lst_vers</code>: versão do pacote doado. Começa em 1 e é incrementado caso o doador forneça uma versão nova do pacote de dados;
+* <code>user_resp</code>: nome de quem fez a análise dos dados;
+* <code>accepted_date</code>: data de aceitação do pacote de dados;
+* <code>scope</code>: jurisdição do doador ou da área que o pacote de dados abrange. Valor padronizado, igual ao <code>isolabel_ext</code>;
+* <code>about</code>: descrição curta do conteúdo do pacote;
+* <code>author</code>: autoria do pacote;
+* <code>contentReferenceTime</code>: data de referência do conteúdo do pacote;
+* <code>license_is_explicit</code>: se a licença foi explicitamente declarada;
+* <code>license</code>: ID da licença. Formado pela concatenação de <code>id_label</code>-<code>id_version</code>. Exemplo: <code>cc0-1.0</code>. Ver [https://git.digital-guard.org/digital-guard/licenses digital-guard/licenses].;
+* <code>uri_objtype</code>: x;
+* <code>uri</code>: x;
+* <code>isat_arcgis</code>: x;
+* <code>status</code>: x.
 == Preenchimento ==
@@ Linha 20: / Linha 42: @@
 ==== <code>pack_id</code>: número de ID do pacote ====
+Número
+==== <code>donor_id</code>: número de ID do doador ====
+Serve para indicar quem doou o pacote de dados. O ID vem do <code>local_id</code> da [[dg:Guia de preenchimento da Planilha de Doadores#local id: número de ID do doador|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.
+==== <code>pack_count</code>: x; ====
+==== <code>lst_vers</code>: x; ====
+==== <code>user_resp</code>: membro da equipe técnica do Instituto ====
+Nome do membro do Instituto que fez o ''review/análise'' do pacote de dados;
+==== <code>accepted_date</code>: 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;
+==== <code>scope</code>: á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).
+==== <code>about</code>: x; ====
+==== <code>author</code>: x; ====
+==== <code>contentReferenceTime</code>: x; ====
+==== <code>license_is_explicit</code>: se a licença foi explicitamente declarada; ====
+==== <code>license</code>: x; ====
+==== <code>uri_objtype</code>: x; ====
+==== <code>uri</code>: x; ====
+==== <code>isat_arcgis</code>: x; ====
+==== <code>status</code>: x. ====
 ...
+== Ver também ==
+* [[dg:Guia de preenchimento da Planilha de Doadores]]
 [[Categoria:Digital-guard]]
+[[Categoria:Manuais]]

Edição atual tal como às 04h12min de 22 de setembro de 2023

Definição

Uso

Conteúdo

Preenchimento

Quando e quem preenche

Instruções de preenchimento

pack_id: número de ID do pacote

donor_id: número de ID do doador

pack_count: x;

lst_vers: x;

user_resp: membro da equipe técnica do Instituto

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

scope: área que o pacote de dados abrange;

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.