.. _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.
**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 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).
**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é
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