.. _oai_openaire_v2: oai_openaire format ======================================== .. contents:: Table of Contents :depth: 2 The ``oai_openaire`` format provides the following elements, according to `OpenAIRE Guidelines for Literature Repository Managers v4 `_. 1. datacite:identifier ---------------------------- - ``datacite:identifier`` provides the Handle of the document - Available for all records. - The Handle identifier is also used as OAI-PMH identifier ``record/header/identifier`` **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 20.500.13089/jsak 2. datacite:title --------------------------- - ``datacite:title`` without attribute provides the main Title of the document. - ``datacite:title`` with attribute ``titleType="Subtitle"`` provides the subtitle of the document. - ``datacite:title`` with attribute ``titleType="TranslatedTitle"`` provides the translated titles of the document. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/gd0i&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Qu’est-ce que le travail quand on n’a pas d’emploi ? Le travail non salarié à l’aune des projections d’avenir des chômeurs What’s work when you’re unemployed ? Non-wage work in the light of future projections for the unemployed Was ist Arbeit, wenn man keinen Arbeitsplatz hat ? Selbständige Arbeit, gemessen an den Zukunftsprojektionen von Arbeitssuchenden ¿Qué es el trabajo cuando no se tiene empleo ? El trabajo no asalariado según las proyecciones de futuro de los desempleados 3. datacite:creator ------------------------- - Author(s), scientific and academic editor, archaeological project director. Repeatable. - For OpenEdition Journals, OpenEdition Books and Calenda, ``givenName`` and ``familyName`` are distincts. - For Hypotheses blog posts, there is no distinction. - For OpenEdition Journals, OpenEdition Books and Calenda, person Identifiers are provided if available: - IdRef: ``datacite:nameIdentifier[@nameIdentifierScheme="IDREF"]`` - Orcid: ``datacite:nameIdentifier[@nameIdentifierScheme="ORCID"]`` - Isni: ``datacite:nameIdentifier[@nameIdentifierScheme="ISNI"]`` - Viaf: ``datacite:nameIdentifier[@nameIdentifierScheme="VIAF"]`` - Bnf: ``datacite:nameIdentifier[@nameIdentifierScheme="BNF"]`` - The attribute ``datacite:nameIdentifier[@schemeURI]`` provide the url of the resolver of the identifier. So Harvesters may build link to the resource. - Example: ``ark:/12148/cb150098665`` - Link to the resource: https://ark.bnf.fr/ark:/12148/cb150098665 **Example of a book:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/31o8&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Groth, Stefan Stefan Groth **Example of a journal article with person Identifiers:** https://metadata.openedition.org/oai?verb=GetRecord&metadataPrefix=oai_openaire&identifier=20.500.13089/k1oc .. code-block:: xml :linenos: Dupriez, Vincent Vincent Dupriez 088067882 0000-0002-0714-7318 0000000119368823 81031688 ark:/12148/cb150098665 Dumay, Xavier Xavier Dumay 121813843 0000000077335977 49559478 ark:/12148/cb15856700n **Example of an archeological note:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/9xim&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Racinet, Philippe Philippe Racinet Jonvel, Richard Richard Jonvel **Example of a blog post:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11r1e&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Olivier Jacquot 4. datacite:contributor --------------------------------- - Other contributors: translators, collaborators (For archeological note and article). - For OpenEdition Journals, OpenEdition Books and Calenda, person Identifiers are provided if available: **Example (translator):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/k5wx&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Mannoni, Olivier Olivier Mannoni **Example (collaborators):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/9wrn&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Perrault, Christophe Christophe Perrault Prat, Béatrice Béatrice Prat Rué, Mathieu Mathieu Rué 24298276X 0000-0001-7948-9459 1542159234530503371916 Caillat, Pierre Pierre Caillat 5. oaire:fundingReference --------------------------------- - Information about financial support. Repeatable. - Available on OpenEdition Books and OpenEdition Journals - ``funderIdentifiertype`` is always ``"Crossref Funder"`` - ``awardNumber`` may be precised, if information is available **Example :** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/fx&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Coordenação de Aperfeiçoamento de Pessoal de Nível Superior http://dx.doi.org/10.13039/501100002322 Programme Saint Hilaire Ministère des Affaires Étrangères http://dx.doi.org/10.13039/501100003388 Programme Saint Hilaire 6. datacite:alternateIdentifier --------------------------------------- - Alternative identifier of the document. Repeatable. 6.1. DOI ^^^^^^^^^^ - ``datacite:alternateIdentifier`` with attribute ``alternateIdentifierType="DOI"`` provides the DOI of the document. - Available for all platforms. - Some records from OpenEdition Books and OpenEdition Journals may have no DOI. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 10.4000/remi.5530 [...] 6.2. URL ^^^^^^^^^ - ``datacite:alternateIdentifier`` with attribute ``alternateIdentifierType="URL"`` provides the URL of the document. - Available for all records. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=oai_openaire .. code-block:: xml :linenos: https://journals.openedition.org/remi/5530 [...] 6.3. ISBN ^^^^^^^^^^ - ``datacite:alternateIdentifier`` with attribute ``alternateIdentifierType="ISBN"`` or ``alternateIdentifierType="PISBN"`` provides respectively the digital ISBN and print ISBN of the document. - Available for books (OpenEdition Books) and journals issues (OpenEdition Journals). **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/31o4&metadataPrefix=oai_openaire .. code-block:: xml :linenos: [...] 978-2-8218-7547-0 978-3-86395-122-1 7. datacite:relatedIdentifier --------------------------------------- - ``datacite:relatedIdentifier`` provides identifiers of "parent" of the resource (Journal and Journal Issue for resource of OpenEdition Journals), (Book for Chapters of OpenEdition Books) - ``datacite:relatedIdentifier`` element with attribute ``relatedIdentifierType="EISSN"`` and ``relatedIdentifierType="PISSN"`` provides respectively e-ISSN and Print ISSN of the journal. For chapters published in a book and articles published in a journal issue : - ``datacite:relatedIdentifier`` element with attribute ``relatedIdentifierType="Handle"`` provides the Handle of the parent book or journal issue. - ``datacite:relatedIdentifier`` element with attribute ``relatedIdentifierType="DOI"`` provides the DOI of the parent book or journal issue. - ``datacite:relatedIdentifier`` element with attribute ``relatedIdentifierType="ISBN"`` and ``relatedIdentifierType="PISBN"`` provides respectively the digital ISBN and Print ISBN of the parent book or journal issue. **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/gh7p&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 1960-601X 1627-4873 20.500.13089/gh7p 10.4000/geocarrefour.10012 **Example (book chapter):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/7kfl&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 20.500.13089/81qu 10.4000/books.pur.29424 978-2-7535-4677-6 978-2-7535-0687-9 .. note:: For a document of type ‘chapter’, the Handle relatedIdentifier can be used with a GetRecord request to obtain detailed information about the book in which the chapter is published. 8. dc:language ----------------- - Document language. RFC1766 format. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1x9t&metadataPrefix=oai_openaire .. code-block:: xml :linenos: fr 9. dc:publisher ----------------- - ``dc:publisher`` provides the publisher name. Repeatable. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1x9t&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Casa de Velázquez Éditions Rue d’Ulm 10. datacite:date ----------------- - ``datacite:date`` with attribute ``dateType="Issued"`` provides the year of publication of the document. - ``datacite:date`` with attribute ``dateType="Updated"`` provides the last update of the document. - For OpenEdition Journals, if ``datacite:rights = embargoed access``, an extra ``dc.date`` element with attribute ``dateType="Available"`` provides the end date of embargo (availability date of the document in open access): **Example (book published in 1990, published on OpenEditon Books on 28/08/2022):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/5div&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 1990 2024-05-23 **Example (journal article with embargoed access):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/k213&metadataPrefix=oai_openaire .. code-block:: xml :linenos: embargoed access 2027-01-01 2023 2023-11-28 .. _resourceType_v2: 11. oaire:resourceType ------------------------------- - Type of resource in the `COAR Resource Type Vocabulary `_ - Available for all records. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/hpx1&metadataPrefix=oai_openaire .. code-block:: xml :linenos: review 12. dc:description -------------------------------- ``dc:description`` contains abstracts of the document if available, an excerpt (usualy the first lines) otherwise. Abstacts may be available in several languages. In this case, and ``xml:lang`` attribute specifies the language of the description. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/l8zw&metadataPrefix=oai_openaire .. code-block:: xml :linenos: L’archipel des Marquises (Polynésie française) construit son projet de développement territorial, y figurent deux projets d’excellence : l’inscription de l’archipel sur la liste du patrimoine mondial de l’UNESCO et la création d’une aire marine protégée. Dans ce contexte, un programme de recherche partenarial et participatif portant sur le patrimoine lié à la mer aux Marquises (PALIMMA) a contribué à identifier les connaissances présentes dans la bibliographie et à construire des données avec la population. Il s’agissait de déterminer quels étaient les patrimoines liés à la mer pour les Marquisiens, les éventuelles menaces afférentes et les pistes de gestion. Au-delà de la production de connaissance, ce programme, porté par la société marquisienne, a participé à la construction des territoires, à renforcer la capacité des populations à intervenir dans les débats et à la construction de liens entre individus et institutions. Marquesas islands archipelago aimes to built its territorial development project in particular thanks to become listed as a world heritage site by UNESCO and the establishment of a marine protected area. In this context, a research programme was carried out. It was a partenarial and partipatory research about maritime heritage in Marquesas (PALIMMA). The objectives were to identify knowledge in the bibliography and to built data with the population (what heritage, what threats and what managerial solutions). Beyond knowledge production, this research programme, with marquisian local community, showed how important it is in ordrer to reach a balanced territorial development, to foster the empowerment of local population and to build relationships between individuals and institutions. A research program like PALIMMA can help to aim those objectives. 13. dc:format ----------------- - mime type of all records is ``text/html`` **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=oai:revues.org:geocarrefour/10121&metadataPrefix=oai_openaire .. code-block:: xml :linenos: text/html .. _dataciterights: 14. datacite:subject --------------------------- - ``dc:subject`` contains keywords. An ``xml:lang`` attribute specifies the language of the keyword. - Available for OpenEdition Journals and OpenEdition Books and Calenda. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d85h&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Belgium migration commuting community detection interaction fields provinces Census11 Belgique migration détection de communautés champs d’interactions navettes provinces Census11 15. datacite:rights -------------------------- - Access right of the resource. - Available for all records. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1i54&metadataPrefix=oai_openaire .. code-block:: xml :linenos: open access 16. oaire:licenseCondition ------------------------------ - ``oaire:licenseCondition`` contains license information. - Available for all records. **Example:** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d85h&metadataPrefix=oai_openaire .. code-block:: xml :linenos: CC-BY-4.0 .. _oairefile: 17. oaire:file --------------------------- - ``oaire:file`` provides the URL of the HTML of the resource. - For OpenEdition Journals and OpenEdition Books ``oaire:file`` provides also, the URL of the PDF, ePub, TEI and "Basic TEI" version of the resource. - ``mimeType`` attribute precises the format and ``accessRightsURI`` the access right type (using the http://purl.org/coar/access_right references). **Example (book):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1i54&metadataPrefix=oai_openaire .. code-block:: xml :linenos: https://books.openedition.org/ariadnaediciones/158 https://books.openedition.org/ariadnaediciones/pdf/158 https://books.openedition.org/ariadnaediciones/epub/158 **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d8ae&metadataPrefix=oai_openaire .. code-block:: xml :linenos: https://journals.openedition.org/belgeo/57360 https://journals.openedition.org/belgeo/tei/57360 https://journals.openedition.org/belgeo/basictei/57360 https://journals.openedition.org/belgeo/pdf/57360 **Example (blog post):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11sem&metadataPrefix=oai_openaire .. code-block:: xml :linenos: https://sms.hypotheses.org/43068 18. oaire:citationTitle -------------------------- - For OpenEdition Journals, Hypotheses, Calenda ``oaire:citationTitle`` contains the Title of the journal, blog, site. - For OpenEdition Books (for chapters) ``oaire:citationTitle`` contains the Title of the book. **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d8ae&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Belgeo **Example (book chapter):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11qip&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Between Lines and Notarial Marks 19. oaire:citationVolume -------------------------- - For OpenEdition Journals ``oaire:citationVolume`` contains the volume of the issue. **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1i54&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 4 20. oaire:citationIssue -------------------------- - For OpenEdition Journals ``oaire:citationIssue`` contains the issue of the issue. **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jry1&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 34 4 21. oaire:citationStartPage / oaire:citationEndPage -------------------------------------------------------- - For OpenEdition Journals and OpenEdition Books; ``oaire:citationStartPage`` and ``oaire:citationEndPage`` contains the pagination. **Example (journal article):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jry1&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 223 230 22. datacite:geoLocation -------------------------------------------------------- - Geolocalisation for Calenda events **Example (Calenda event):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11pm5&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Aix-en-Provence 23. oaire:citationConferencePlace -------------------------------------------------------- - Calenda events : Conference place **Example (Calenda event):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11pm5&metadataPrefix=oai_openaire .. code-block:: xml :linenos: Aix-en-Provence 24. oaire:citationConferenceDate -------------------------------------------------------- - Calenda events : Conference date **Example (Calenda event):** https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11pm5&metadataPrefix=oai_openaire .. code-block:: xml :linenos: 2024-06-04