Basic information
DOI (digital object identifier) – a digital identifier of an electronic document, which – unlike URL identifiers – does not depend on the physical location of a document but is permanently ascribed to it.
DataCite – an international non-profit organization, the goal of which is to improve data citations to:
- facilitate access to scientific data on the Internet,
- increase the acceptance of scientific data as verified data and of the input in scientific publications,
- support data archiving in order to makes it possible to to verify results and to use them in the future.
Integrating the dLibra System with the DataCite System and the Metadata Store (MDS)
The DataCite Metadata Store (MDS) allows users to register DOIs with the associated metadata. Version 6.1 of the dLibra system integrates with the abovementioned API and makes it possible to easily register objects created in the system. After they have been correctly registered, the objects will be available to the public through the DataCite REST API.
NOTE: In order to use the DOI functionality built into the dLibra system, the user must have an account in the DataCite system. For that purpose, the user should contact the DlnGO team through the contact form on the DlnGO website (http://dingo.psnc.pl/) or contact our technical support via its email address (help at dlibra.psnc.pl) in order to obtain information about the cooperation with DataCite. The PCSS is a member of the DataCite consortium, and it is authorized to take care of the necessary formalities on the basis of which an account is created for the interested institution.
Configuration
The dLibra System Server – Metadata Mapping
The metadata required by the MDS are mapped from the dLibra system to the metadata schema on the basis of the content of the doi-export.properties file located in the conf/ms subdirectory of the root directory of the server. The box below contains a sample content of that file.
#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 =
Notes on mapping:
- 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