dg:Guia de preenchimento da Planilha de Pacotes: mudanças entre as edições
Sem resumo de edição |
Sem resumo de edição |
||
(10 revisões intermediárias por 2 usuários não estão sendo mostradas) | |||
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. | 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]]. | 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 == | == 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. | 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 13: | Linha 17: | ||
A planilha consiste do seguinte (da coluna esquerda para direita): | A planilha consiste do seguinte (da coluna esquerda para direita): | ||
* pack_id | * <code>pack_id</code>: número de ID do pacote. Formato pela concatenação de <code>donor_id</code> e <code>pack_count</code>. | ||
* donor_id | * <code>donor_id</code>: número de ID do doador. Referencia <code>local_id</code> de donor.csv; | ||
* pack_count | * <code>pack_count</code>: valor sequencial, começando em 1 e incrementado a cada novo pacote doado pelo doador; | ||
* lst_vers | * <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; | ||
* user_resp | * <code>user_resp</code>: nome de quem fez a análise dos dados; | ||
* accepted_date | * <code>accepted_date</code>: data de aceitação do pacote de dados; | ||
* scope | * <code>scope</code>: jurisdição do doador ou da área que o pacote de dados abrange. Valor padronizado, igual ao <code>isolabel_ext</code>; | ||
* about | * <code>about</code>: descrição curta do conteúdo do pacote; | ||
* author | * <code>author</code>: autoria do pacote; | ||
* contentReferenceTime | * <code>contentReferenceTime</code>: data de referência do conteúdo do pacote; | ||
* license_is_explicit | * <code>license_is_explicit</code>: se a licença foi explicitamente declarada; | ||
* license | * <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].; | ||
* uri_objtype | * <code>uri_objtype</code>: x; | ||
* uri | * <code>uri</code>: x; | ||
* isat_arcgis | * <code>isat_arcgis</code>: x; | ||
* status | * <code>status</code>: x. | ||
== Preenchimento == | == Preenchimento == | ||
Linha 38: | Linha 42: | ||
==== <code>pack_id</code>: número de ID do pacote ==== | ==== <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:Digital-guard]] | ||
[[Categoria:Manuais]] |
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 dedonor_id
epack_count
.donor_id
: número de ID do doador. Referencialocal_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 aoisolabel_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 deid_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.
...