oai_openaire format

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

1<datacite:identifier identifierType="HANDLE">20.500.13089/jsak</datacite:identifier>

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

1<datacite:titles>
2  <datacite:title>Qu’est-ce que le travail quand on n’a pas d’emploi ?</datacite:title>
3  <datacite:title titleType="Subtitle">Le travail non salarié à l’aune des projections d’avenir des chômeurs</datacite:title>
4  <datacite:title titleType="TranslatedTitle" xml:lang="en">What’s work when you’re unemployed ? Non-wage work in the light of future projections for the unemployed</datacite:title>
5  <datacite:title titleType="TranslatedTitle" xml:lang="de">Was ist Arbeit, wenn man keinen Arbeitsplatz hat ? Selbständige Arbeit, gemessen an den Zukunftsprojektionen von Arbeitssuchenden</datacite:title>
6  <datacite:title titleType="TranslatedTitle" xml:lang="es">¿Qué es el trabajo cuando no se tiene empleo ? El trabajo no asalariado según las proyecciones de futuro de los desempleados</datacite:title>
7</datacite:titles>

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

1<datacite:creators>
2  <datacite:creator>
3    <datacite:creatorName nameType="Personal">Groth, Stefan</datacite:creatorName>
4    <datacite:givenName>Stefan</datacite:givenName>
5    <datacite:familyName>Groth</datacite:familyName>
6  </datacite:creator>
7</datacite:creators>

Example of an archeological note: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/9xim&metadataPrefix=oai_openaire

 1<datacite:creators>
 2    <datacite:creator>
 3      <datacite:creatorName nameType="Personal">Racinet, Philippe</datacite:creatorName>
 4      <datacite:givenName>Philippe</datacite:givenName>
 5      <datacite:familyName>Racinet</datacite:familyName>
 6    </datacite:creator>
 7    <datacite:creator>
 8      <datacite:creatorName nameType="Personal">Jonvel, Richard</datacite:creatorName>
 9      <datacite:givenName>Richard</datacite:givenName>
10      <datacite:familyName>Jonvel</datacite:familyName>
11    </datacite:creator>
12</datacite:creators>

Example of a blog post: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11r1e&metadataPrefix=oai_openaire

1<datacite:creators>
2  <datacite:creator>
3    <datacite:creatorName>Olivier Jacquot</datacite:creatorName>
4  </datacite:creator>
5</datacite:creators>

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

1<datacite:contributors>
2  <datacite:contributor contributorType="Other">
3    <datacite:creatorName nameType="Personal">Mannoni, Olivier</datacite:creatorName>
4    <datacite:givenName>Olivier</datacite:givenName>
5    <datacite:familyName>Mannoni</datacite:familyName>
6  </datacite:contributor>
7</datacite:contributors>

Example (collaborators): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/9wrn&metadataPrefix=oai_openaire

 1<datacite:contributors>
 2  <datacite:contributor contributorType="Other">
 3    <datacite:creatorName nameType="Personal">Perrault, Christophe</datacite:creatorName>
 4    <datacite:givenName>Christophe</datacite:givenName>
 5    <datacite:familyName>Perrault</datacite:familyName>
 6  </datacite:contributor>
 7  <datacite:contributor contributorType="Other">
 8    <datacite:creatorName nameType="Personal">Prat, Béatrice</datacite:creatorName>
 9    <datacite:givenName>Béatrice</datacite:givenName>
10    <datacite:familyName>Prat</datacite:familyName>
11  </datacite:contributor>
12  <datacite:contributor contributorType="Other">
13    <datacite:creatorName nameType="Personal">Rué, Mathieu</datacite:creatorName>
14    <datacite:givenName>Mathieu</datacite:givenName>
15    <datacite:familyName>Rué</datacite:familyName>
16  </datacite:contributor>
17  <datacite:contributor contributorType="Other">
18    <datacite:creatorName nameType="Personal">Caillat, Pierre</datacite:creatorName>
19    <datacite:givenName>Pierre</datacite:givenName>
20    <datacite:familyName>Caillat</datacite:familyName>
21  </datacite:contributor>
22</datacite:contributors>

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

 1<oaire:fundingReferences>
 2  <oaire:fundingReference>
 3    <oaire:funderName>Coordenação de Aperfeiçoamento de Pessoal de Nível Superior</oaire:funderName>
 4    <oaire:funderIdentifier funderIdentifierType="Crossref Funder ID">http://dx.doi.org/10.13039/501100002322</oaire:funderIdentifier>
 5    <oaire:awardTitle>Programme Saint Hilaire</oaire:awardTitle>
 6  </oaire:fundingReference>
 7  <oaire:fundingReference>
 8    <oaire:funderName>Ministère des Affaires Étrangères</oaire:funderName>
 9    <oaire:funderIdentifier funderIdentifierType="Crossref Funder ID">http://dx.doi.org/10.13039/501100003388</oaire:funderIdentifier>
10    <oaire:awardTitle>Programme Saint Hilaire</oaire:awardTitle>
11  </oaire:fundingReference>
12</oaire:fundingReferences>

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

1<datacite:alternateIdentifiers>
2  <datacite:alternateIdentifier alternateIdentifierType="DOI">10.4000/remi.5530</datacite:alternateIdentifier>
3  [...]
4</datacite:alternateIdentifiers>

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

1<datacite:alternateIdentifiers>
2  <datacite:alternateIdentifier alternateIdentifierType="URL">https://journals.openedition.org/remi/5530</datacite:alternateIdentifier>
3  [...]
4</datacite:alternateIdentifiers>

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

1<datacite:alternateIdentifiers>
2  [...]
3  <datacite:alternateIdentifier alternateIdentifierType="ISBN">978-2-8218-7547-0</datacite:alternateIdentifier>
4  <datacite:alternateIdentifier alternateIdentifierType="PISBN">978-3-86395-122-1</datacite:alternateIdentifier>
5</datacite:alternateIdentifiers>

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

1<datacite:relatedIdentifiers>
2  <datacite:relatedIdentifier relatedIdentifierType="EISSN" relationType="IsPartOf">1960-601X</datacite:relatedIdentifier>
3  <datacite:relatedIdentifier relatedIdentifierType="PISSN" relationType="IsPartOf">1627-4873</datacite:relatedIdentifier>
4  <datacite:relatedIdentifier relatedIdentifierType="Handle" relationType="IsPartOf">20.500.13089/gh7p</datacite:relatedIdentifier>
5  <datacite:relatedIdentifier relatedIdentifierType="DOI" relationType="IsPartOf">10.4000/geocarrefour.10012</datacite:relatedIdentifier>
6</datacite:relatedIdentifiers>

Example (book chapter): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/7kfl&metadataPrefix=oai_openaire

1<datacite:relatedIdentifiers>
2  <datacite:relatedIdentifier relatedIdentifierType="Handle" relationType="IsPartOf">20.500.13089/81qu</datacite:relatedIdentifier>
3  <datacite:relatedIdentifier relatedIdentifierType="DOI" relationType="IsPartOf">10.4000/books.pur.29424</datacite:relatedIdentifier>
4  <datacite:relatedIdentifier relatedIdentifierType="ISBN" relationType="IsPartOf">978-2-7535-4677-6</datacite:relatedIdentifier>
5  <datacite:relatedIdentifier relatedIdentifierType="PISBN" relationType="IsPartOf">978-2-7535-0687-9</datacite:relatedIdentifier>
6</datacite:relatedIdentifiers>

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

1<dc:language>fr</dc:language>

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

1<dc:publisher>Casa de Velázquez</dc:publisher>
2<dc:publisher>Éditions Rue d’Ulm</dc:publisher>

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

1<datacite:dates>
2  <datacite:date dateType="Issued">1990</datacite:date>
3  <datacite:date dateType="Updated">2024-05-23</datacite:date>
4</datacite:dates>

Example (journal article with embargoed access): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/k213&metadataPrefix=oai_openaire

1<datacite:rights rightsURI="http://purl.org/coar/access_right/c_f1cf">embargoed access</datacite:rights>
2<datacite:dates>
3  <datacite:date dateType="Available">2027-01-01</datacite:date>
4  <datacite:date dateType="Issued">2023</datacite:date>
5  <datacite:date dateType="Updated">2023-11-28</datacite:date>
6</datacite:dates>

11. oaire:resourceType

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/hpx1&metadataPrefix=oai_openaire

1<oaire:resourceType resourceTypeGeneral="literature" uri="http://purl.org/coar/resource_type/c_efa0">review</oaire:resourceType>

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

1<dc:description xml:lang="fr">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.</dc:description>
2<dc:description xml:lang="en">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.</dc:description>

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

1<dc:format>text/html</dc:format>

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

 1<datacite:subjects>
 2  <datacite:subject xml:lang="en">Belgium</datacite:subject>
 3  <datacite:subject xml:lang="en">migration</datacite:subject>
 4  <datacite:subject xml:lang="en">commuting</datacite:subject>
 5  <datacite:subject xml:lang="en">community detection</datacite:subject>
 6  <datacite:subject xml:lang="en">interaction fields</datacite:subject>
 7  <datacite:subject xml:lang="en">provinces</datacite:subject>
 8  <datacite:subject xml:lang="en">Census11</datacite:subject>
 9  <datacite:subject xml:lang="fr">Belgique</datacite:subject>
10  <datacite:subject xml:lang="fr">migration</datacite:subject>
11  <datacite:subject xml:lang="fr">détection de communautés</datacite:subject>
12  <datacite:subject xml:lang="fr">champs d’interactions</datacite:subject>
13  <datacite:subject xml:lang="fr">navettes</datacite:subject>
14  <datacite:subject xml:lang="fr">provinces</datacite:subject>
15  <datacite:subject xml:lang="fr">Census11</datacite:subject>
16</datacite:subjects>

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

1<datacite:rights rightsURI="http://purl.org/coar/access_right/c_abf2">open access</datacite:rights>

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

1<oaire:licenseCondition uri="https://creativecommons.org/licenses/by/4.0/">CC-BY-4.0</oaire:licenseCondition>

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

1<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_abf2" mimeType="text/html" objectType="fulltext">https://books.openedition.org/ariadnaediciones/158</oaire:file>
2<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_16ec" mimeType="application/pdf" objectType="fulltext">https://books.openedition.org/ariadnaediciones/pdf/158</oaire:file>
3<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_16ec" mimeType="application/epub+zip" objectType="fulltext">https://books.openedition.org/ariadnaediciones/epub/158</oaire:file>

Example (journal article): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d8ae&metadataPrefix=oai_openaire

1<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_abf2" mimeType="text/html" objectType="fulltext">https://journals.openedition.org/belgeo/57360</oaire:file>
2<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_16ec" mimeType="application/tei+xml" objectType="fulltext">https://journals.openedition.org/belgeo/tei/57360</oaire:file>
3<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_16ec" mimeType="application/tei+xml" objectType="fulltext">https://journals.openedition.org/belgeo/basictei/57360</oaire:file>
4<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_abf2" mimeType="application/pdf" objectType="fulltext">https://journals.openedition.org/belgeo/pdf/57360</oaire:file>

Example (blog post): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11sem&metadataPrefix=oai_openaire

1<oaire:file accessRightsURI="http://purl.org/coar/access_right/c_abf2" mimeType="text/html" objectType="fulltext">https://sms.hypotheses.org/43068</oaire:file>

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

1<oaire:citationTitle>Belgeo</oaire:citationTitle>

Example (book chapter): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11qip&metadataPrefix=oai_openaire

1<oaire:citationTitle>Between Lines and Notarial Marks</oaire:citationTitle>

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

1<oaire:citationVolume>4</oaire:citationVolume>

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

1<oaire:citationVolume>34</oaire:citationVolume>
2<oaire:citationIssue>4</oaire:citationIssue>

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

1<oaire:citationStartPage>223</oaire:citationStartPage>
2<oaire:citationEndPage>230</oaire:citationEndPage>

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

1<datacite:geoLocations>
2  <datacite:geoLocation>
3    <datacite:geoLocationPlace>Aix-en-Provence</datacite:geoLocationPlace>
4  </datacite:geoLocation>
5</datacite:geoLocations>

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

1<oaire:citationConferencePlace>Aix-en-Provence</oaire:citationConferencePlace>

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

1<oaire:citationConferenceDate>2024-06-04</oaire:citationConferenceDate>