Podstawowe informacje

DOI (ang. digital object identifier) – cyfrowy identyfikator dokumentu elektronicznego, który w odróżnieniu od identyfikatorów URL nie zależy od fizycznej lokalizacji dokumentu, lecz jest do niego na stałe przypisany.

DataCite - międzynarodowa organizacja typu not-for-profit, której założeniem jest ulepszenie cytowania danych w celu:

ułatwienia dostępu do danych naukowych w internecie,
wzrostu akceptacji danych naukowych jako sprawdzonych oraz wkładu w zapisach naukowych,
wsparcia archiwizacji danych, która umożliwi weryfikację wyników oraz użycie ich w przyszłości.

Integracja systemu dlibra z systemem DataCite Metadata Store (MDS)

DataCite Metadata Store (MDS) pozwala użytkownikom na rejestrację DOI wraz ze skojarzonymi metadanymi. Dlibra 6.1 integruje się z ww. API i umożliwia łatwą rejestrację tworzonych w systemie obiektów. Po poprawnej rejestracji obiekty będą dostępne publicznie poprzez DataCite REST API.

UWAGA: aby korzystać z funkcjonalności DOI wbudowanej w system dLibra, należy posiadać konto w systemie DataCite. PCSS jest członkiem konsorcjum DataCite i ma uprawnienia do przeprowadzenia niezbędnych formalności, na podstawie których tworzone jest konto dla zainteresowanej instytucji. Więcej informacji na ten temat oraz formularz kontaktowy można znaleźć na stronie usługi Data ID.

Konfiguracja

Serwer systemu dlibra - mapowanie metadanych

Mapowanie metadanych z systemu dlibra do schematu metadanych wymaganych przez MDS odbywa się na podstawie zawartości pliku doi-export.properties znajdującego się w podkatalogu conf/ms katalogu głównego serwera. Przykładowa treść pliku znajduje się poniżej.

#Mandatory
creator															= Creator
title															= Title
title.AlternativeTitle											= Alternative
title.Subtitle													= 
title.TranslatedTitle											= 
title.Other														= 
publisher														= Publisher
publicationYear 												= 
resourceType.Audiovisual										=
resourceType.Collection											=
resourceType.DataPaper											=
resourceType.Dataset											=
resourceType.Event												=
resourceType.Image												=
resourceType.InteractiveResource								=
resourceType.Model												=
resourceType.PhysicalObject										=
resourceType.Service											=
resourceType.Software											=
resourceType.Sound												=
resourceType.Text												=
resourceType.Workflow											=
resourceType.Other												= Type
#Recommended
subject															= Subject
contributor.ContactPerson										=
contributor.DataCollector										=
contributor.DataCurator											=
contributor.DataManager											=
contributor.Distributor											=
contributor.Editor												=
contributor.HostingInstitution									=
contributor.Producer											=
contributor.ProjectLeader										=
contributor.ProjectManager										=
contributor.ProjectMember										=
contributor.RegistrationAgency									=
contributor.RegistrationAuthority								=
contributor.RelatedPerson										=
contributor.Researcher											=
contributor.ResearchGroup										=
contributor.RightsHolder										=
contributor.Sponsor												=
contributor.Supervisor											=
contributor.WorkPackageLeader									=
contributor.Other												= Contributor
date.Accepted													= Accepted
date.Available													= Available
date.Copyrighted												= Copyrighted
date.Collected													= 
date.Created													= Created
date.Issued														= Issued
date.Submitted													= Submitted
date.Updated													= Modified
date.Valid														= Valid
date.Other														= Date
#Related identifier types - all combinations relatedIdentifier.{relatedIdentifierType}.{relationType}
#relatedIdentifier.ARK.{relationType}							=
#relatedIdentifier.arXiv.{relationType}							=
#relatedIdentifier.bibcode.{relationType}						=
#relatedIdentifier.DOI.{relationType}							=
#relatedIdentifier.EAN13.{relationType}							=
#relatedIdentifier.EISSN.{relationType}							=
#relatedIdentifier.Handle.{relationType}						=
#relatedIdentifier.IGSN.{relationType}							=
#relatedIdentifier.ISBN.{relationType}							=
#relatedIdentifier.ISSN.{relationType}							=
#relatedIdentifier.ISTC.{relationType}							=
#relatedIdentifier.LISSN.{relationType}							=
#relatedIdentifier.LSID.{relationType}							=
#relatedIdentifier.PMID.{relationType}							=
#relatedIdentifier.PURL.{relationType}							=
#relatedIdentifier.UPC.{relationType}							=
#relatedIdentifier.URL.{relationType}							=
#relatedIdentifier.URN .{relationType}							=
#relatedIdentifier.{relatedIdentifierType}.IsCitedBy			=
#relatedIdentifier.{relatedIdentifierType}.Cites				=
#relatedIdentifier.{relatedIdentifierType}.IsSupplementTo		=
#relatedIdentifier.{relatedIdentifierType}.IsSupplementedBy		=
#relatedIdentifier.{relatedIdentifierType}.IsContinuedBy		=
#relatedIdentifier.{relatedIdentifierType}.Continues			=
#relatedIdentifier.{relatedIdentifierType}.IsDescribedBy		=
#relatedIdentifier.{relatedIdentifierType}.Describes			=
#relatedIdentifier.{relatedIdentifierType}.HasMetadata			=
#relatedIdentifier.{relatedIdentifierType}.IsMetadataFor		=
#relatedIdentifier.{relatedIdentifierType}.HasVersion			=
#relatedIdentifier.{relatedIdentifierType}.IsVersionOf			=
#relatedIdentifier.{relatedIdentifierType}.IsNewVersionOf		=
#relatedIdentifier.{relatedIdentifierType}.IsPreviousVersionOf	=
#relatedIdentifier.{relatedIdentifierType}.IsPartOf				=
#relatedIdentifier.{relatedIdentifierType}.HasPart				=
#relatedIdentifier.{relatedIdentifierType}.IsReferencedBy		=
#relatedIdentifier.{relatedIdentifierType}.References			=
#relatedIdentifier.{relatedIdentifierType}.IsDocumentedBy		=
#relatedIdentifier.{relatedIdentifierType}.Documents			=
#relatedIdentifier.{relatedIdentifierType}.IsCompiledBy			=
#relatedIdentifier.{relatedIdentifierType}.Compiles				=
#relatedIdentifier.{relatedIdentifierType}.IsVariantFormOf		=
#relatedIdentifier.{relatedIdentifierType}.IsOriginalFormOf		=
#relatedIdentifier.{relatedIdentifierType}.IsIdenticalTo		=
#relatedIdentifier.{relatedIdentifierType}.IsReviewedBy			=
#relatedIdentifier.{relatedIdentifierType}.Reviews				=
#relatedIdentifier.{relatedIdentifierType}.IsDerivedFrom		=
#relatedIdentifier.{relatedIdentifierType}.IsSourceOf			=
#relatedIdentifier.{relatedIdentifierType}.IsRequiredBy			=
#relatedIdentifier.{relatedIdentifierType}.Requires				=
description.Abstract											= Abstract
description.Methods
description.SeriesInformation
description.TableOfContents										= TableOfContents
description.TechnicalInfo
description.Other												= Description
geolocation														= Geolocation
#Optional
language														= Language
#alternateIdentifier.{freeText} 								= 
size															= 
format															= Format
version															= 
rights															= Rights
fundingReference												=

Uwagi dotyczące mapowania:

Przypisywanie metadanych do schematu wymaganego przez MDS odbywa się poprzez podanie po znaku równości nazwy RDF atrybutu dostępnego w systemie dlibra (np. creator = Creator). Możliwe jest przypisanie kilku atrybutów (np. title = Title, Alternative).

Treść pliku konfiguracyjnego została podzielona na 3 sekcje: #Mandatory (wymagane), #Recommended (rekomendowane) oraz #Optional (opcjonalne). Pola w sekcji mandatory pojawią się zawsze w wynikowym schemacie metadanych. Jeśli nie zostaną do tych pól przypisane nazwy atrybutów RDF lub atrybuty te nie będą posiadać żadnej wartości dla danego obiektu, to nastąpi przypisanie domyślnej wartości "(:unav)". Aby upewnić się, że obowiązkowe pola będą zawsze wypełnione, można skorzystać z mechanizmu widoków atrybutów, który pozwala skonfigurować atrybuty wymagane przy tworzeniu opisu obiektu.
Metadane zaczynające się od prefixu relatedIdentifier mogą być tworzone dowolnie na podstawie kombinacji typu relatedIdentifier.{relatedIdentifierType}.{relationType}. Wartości dla {relatedIdentifierType} oraz {relationType} zostały wymienione w powyższym pliku.
Możliwe jest utworzenie dowojnej liczby przypisań dla metadanej typu alternateIdentifier wg. schematu alternateIdentifier.{freeText}, gdzie {freeText}, jest wartością dowolną
Metadana publicationYear jest wymagana przez MDS i jej wartość musi stanowić czterocyfrowa liczba naturalna (0000-9999). Jeśli wartość będzie niepoprawna, to zostanie wykorzystana data utworzenia obiektu w repozytorium cyfrowym.

Aplikacja czytelnika

Do prawidłowego działania rejestracji DOI w systemie MDS należy skonfigurować również plik doi.properties, który znajduje się w katalogu /conf aplikacji czytelnika. Przykładowa treść pliku znajduje się poniżej.

class.name = pl.psnc.dlibra.web.comp.resources.doi.DoiManager
doi.username=
doi.password=
doi.prefix=10.5072
doi.endpoint.mds=https://mds.test.datacite.org
doi.defaultLanguage=pl

Parametry konfiguracyjne:

doi.username - nazwa użytkownika w systemie DataCite,
doi.password - hasło skojarzone z kontem w systemie Datacite,
doi.prefix - przypisany przez DataCite prefix doi
```
doi.endpoint.mds - adres do MDS, gdzie:
```
- https://mds.test.datacite.org - adres do testów
- https://mds.datacite.org - adres produkcyjny
doi.defaultLanguage - język metadanych, który powinien być wykorzystany w przypadku obiektów, które mają zdefiniowane metadane w wielu językach