Project

General

Profile

1
<?xml version="1.0" encoding="UTF-8"?>
2
<chapter version="5.0" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
3
    xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="cha_oai_pmh" xreflabel="OAI-PMH">
4
    <title>Bulk access via OAI-PMH</title>
5
    <para>
6
        <warning>
7
            <para>The OAI-PMH publisher is not currently supporting incremental harvesting.</para>
8
            <para>Although the usage of the OAI parameters 'from' and 'until' is handled by the OAI publisher, the datestamps of metadata records are updated about every week.</para>
9
            <para>We apologise for any inconvenience this may cause to harvesters,</para>
10
            <para>the OpenAIRE technical team.</para>
11
        </warning>
12
    </para>
13
    <para>OAI-PMH is a standard protocol for metadata publishing and harvesting. For details on the
14
        OAI-PMH protocol please refer to the official documentation at <link
15
            xlink:href="http://www.openarchives.org/OAI/openarchivesprotocol.html"/></para>
16
    <para>The OpenAIRE OAI-PMH endpoint is <link xlink:href="http://api.openaire.eu/oai_pmh"
17
        /></para>
18
    <para>For information about the endpoint check <link
19
            xlink:href="http://api.openaire.eu/oai_pmh?verb=Identify"/></para>
20
    <para>The updated list of OAI sets is always available at: <link
21
            xlink:href="http://api.openaire.eu/oai_pmh?verb=ListSets"/></para>
22
    <para>For quick reference, we report some of the likely more interesting sets:</para>
23
    <simplelist>
24
        <member>
25
            <emphasis>openaire</emphasis>: the set of publications. Metadata prefixes available:
26
            oaf, oai_dc</member>
27
        <member>
28
            <emphasis>FP7Publications</emphasis>: the set of publications funded by EC FP7. Metadata
29
            prefixes available: oaf, oai_dc</member>
30
        <member>
31
            <emphasis>H2020Publications</emphasis>: the set of publications funded by EC H2020.
32
            Metadata prefixes available: oaf, oai_dc</member>
33
        <member>
34
            <emphasis>openaire_data</emphasis>: the set of datasets. Metadata prefixes available:
35
            oaf, oai_datacite</member>
36
        <member>
37
            <emphasis>OpenAccess</emphasis>: the set of all Open Access publications and datasets.
38
            Metadata prefixes available: oaf (return datasets and publications), oai_dc (return
39
            datasets and publications), oai_datacite (return datasets only)</member>
40
        <member>
41
            <emphasis>projects</emphasis>: the set of all projects. Metadata prefix available:
42
            oaf</member>
43
        <member>
44
            <emphasis>ECProjects</emphasis>: the set of projects funded by the European Commission
45
            (EC) under the programmes FP7 and H2020. Metadata prefix available: oaf</member>
46
        <member>
47
            <emphasis>FP7Projects</emphasis>: the set of projects funded by the EC Seventh Framework
48
            Programme. Metadata prefix available: oaf</member>
49
        <member>
50
            <emphasis>H2020Projects</emphasis>: the set of projects funded by the EC Horizn 2020
51
            Programme. Metadata prefix available: oaf</member>
52
        <member>
53
            <emphasis>WTProjects</emphasis>: the set of projects funded by Wellcome Trust. Metadata
54
            prefix available: oaf</member>
55
    </simplelist>
56
    <para>For the list of available metadata prefixes, check: <link
57
            xlink:href="http://api.openaire.eu/oai_pmh?verb=ListMetadataFormats"/>.</para>
58
    <para>Note that records will always be available in the OpenAIRE format (<link
59
            xlink:href="https://www.openaire.eu/schema/0.2/oaf-0.2.xsd">schema</link>, <link
60
            xlink:href="https://www.openaire.eu/schema/0.2/doc/oaf-0.2.html">documentation</link>).
61
        The availability of records in oai_dc and oai_datacite depends on the typology of
62
        records.</para>
63
    <para>Publications are avaialble in oai_dc according to the <link
64
        xlink:href="https://guidelines.openaire.eu/en/latest/literature/index.html"
65
            >OpenAIRE3.0 guidelines for literature repositories</link>.</para>
66
    <para>Datasets are available in oai_datacite according to the <link
67
        xlink:href="https://guidelines.openaire.eu/en/latest/data/index.html"
68
            >OpenAIRE2.0 guidelines for data archives</link>. </para>
69
</chapter>
(3-3/6)