Project

General

Profile

1 52357 sandro.lab
<style>
2
table, th, td {
3
    border: 1px solid black;
4
    border-collapse: collapse;
5
}
6
th, td {
7
    padding: 5px;
8
    text-align: left;
9
}
10
    table>thead>tr>th, .table>thead>tr>th, table>tbody>tr>th, .table>tbody>tr>th, table>tfoot>tr>th, .table>tfoot>tr>th, table>thead>tr>td, .table>thead>tr>td, table>tbody>tr>td, .table>tbody>tr>td, table>tfoot>tr>td, .table>tfoot>tr>td {
11
    border: 1px solid black;
12
}
13
</style>
14
15 50035 sandro.lab
<section style="font-size: 20px; font-family: Lato">
16
17 46770 sandro.lab
    <div class="row">
18 50035 sandro.lab
        <div class="col-lg-8 col-lg-offset-2">
19
20
            <div class="card z-depth-2" style="padding-top: 10px ;">
21 52357 sandro.lab
                <div class="row" style="margin-top: 10px; text-align: justify;  text-justify: inter-word;">
22
                    <h4 class="center-align"><b>ABOUT SCHOLEXPLORER: THE OPENAIRE’S SCHOLIX HUB</b></h4>
23
                    <b>Scholix</b>  The goal of the Scholix initiative is to establish a high level interoperability
24
                    framework for exchanging information about the links between scholarly literature and data.
25
                    It aims to enable an open information ecosystem to understand systematically what data underpins
26
                    literature and what literature references data. Scholix maintains an evolving set
27
                    of<a href="http://www.scholix.org">Guidelines</a> consisting of:
28
                    (i) an information model (conceptual definition of what is a Scholix scholarly link),
29
                    (ii) a link metadata schema (set of metadata fields representing a Scholix link),
30
                    and (iii) a corresponding XML and JSON schema.
31
                </div>
32
                <div class="row" style="text-align: center;">
33 56023 sandro.lab
                    <img src="static/img/ScholixDM.png" style="max-width: 80%;">
34 52357 sandro.lab
                </div>
35
                <div class="row" style="text-align: justify; text-justify: inter-word;  margin-top: 10px">
36
                    <b>How to expose Scholix data from this hub</b> Scholexplorer harvests scholarly links
37
                    (i.e. collects metadata records about links from public APIs) from the Scholix
38
                    compatible sources and from DataCite compatible sources. The main sources collected
39
                    by the service are listed in Table 1.
40
                </div>
41
                <div class="row" style="font-size: 12px; margin-top: 10px">
42
                    <b>Table 1.</b> Scholexplorer: data sources. Legenda: Hub (aggregator of sources that exposes Scholix links), Source (data source that exposes Scholix links)
43 50035 sandro.lab
44 52357 sandro.lab
                </div>
45
                <div class="row" style="text-align: justify;">
46
                   <table class="table">
47
                       <thead>
48
                       <tr>
49
                           <th scope="col">Data Source</th>
50
                           <th scope="col">Type of source</th>
51
                       </tr>
52
                       <tr>
53
                           <td>DataCite from the DataCite OAI-PMH <a href="https://oai.datacite.org/"> end point</a></td>
54
                           <td>Hub: a <i>provider</i> of links <i>published</i> by data repositories; links are between datasets (DOIs) and articles (DOIs, handles, URLs) or datasets (DOI)</td>
55
                       </tr>
56
                       <tr>
57
                           <td>CrossRef from the Event Data <a href="https://www.crossref.org/services/event-data/"> end point</a></td>
58
                           <td>Hub: a <i>provider</i> of links <i>published</i> by publishers; links are between articles (DOIs) and datasets (DOI, accession numbers, URLs)</td>
59
                       </tr>
60
                       <tr>
61
                           <td>Data repositories that are not yet DataCite members</td>
62
                           <td>Source: a <i>publisher</i> of links between datasets (no DOI) and articles</td>
63
                       </tr>
64
                        <tr>
65
                           <td>Thematic publishers, e.g. Europe PMC</td>
66
                           <td>Source: a <i>publisher</i> of links between articles and accession numbers</td>
67
                       </tr>
68 50035 sandro.lab
69 52357 sandro.lab
                        <tr>
70
                           <td>Dataset databases, e.g. ENA</td>
71
                           <td>Source: a <i>publisher</i> of links between accession numbers of sequences and articles</td>
72
                       </tr>
73
                   </table>
74
                </div>
75
                <div class="row" style="text-align: justify; text-justify: inter-word">
76
                    Data sources willing to include the links they publish or provide within Scholexplorer have two options:
77
                    <ul>
78
                        <li>
79
                            Become Scholix-compliant and register to become a Scholexplorer data source;
80
                        </li>
81
                        <li>
82
                            Become a data source aggregated by any of the hubs above.
83
                        </li>
84
                    </ul>
85 50035 sandro.lab
86 52357 sandro.lab
                </div>
87 50035 sandro.lab
88
            </div>
89 46770 sandro.lab
        </div>
90
    </div>
91
92
93 50035 sandro.lab
    <div class="row">
94
        <div class="col-lg-8 col-lg-offset-2">
95 46770 sandro.lab
96 52357 sandro.lab
            <div class="card z-depth-2" style="padding-top: 10px;text-align: justify; text-justify: inter-word">
97 50035 sandro.lab
                <div class="row" style="margin-top: 10px">
98 52357 sandro.lab
                    <h4 class="center-align"><b>HOW TO ACCESS SCHOLIX DATA FROM THIS HUB</b></h4>
99
                    The Scholix Swagger API allows clients to run REST queries over the Scholexplorer index
100
                    in order to fetch links matching given criteria. In the current version, clients can search for:
101 50035 sandro.lab
                    <ul>
102 52357 sandro.lab
                        <li> Links whose source object has a given PID or PID type; </li>
103
                        <li> Links whose source object has been <b>published</b> by a given data source ("data source as publisher");</li>
104
                        <li> Links that were <b>collected</b> from a given data source ("data source as provider"). </li>
105 50035 sandro.lab
                    </ul>
106
                    The APIs are available from <a
107 52357 sandro.lab
                        href="https://api.scholexplorer.openaire.eu/v2/ui"> here</a>. The results of queries return lists of links
108
                        encoded as JSON Scholix records. JSON (and XML) schema and example records for Scholix links are availabe on
109 50064 sandro.lab
                        <a href="https://github.com/scholix/schema">GitHub</a>.
110 46770 sandro.lab
                </div>
111
            </div>
112
        </div>
113 50035 sandro.lab
    </div>
114
115
116 51701 sandro.lab
    <div class="row">
117
        <div class="col-lg-8 col-lg-offset-2">
118 52357 sandro.lab
            <div class="card z-depth-2" style="padding-top: 10px;text-align: justify; text-justify: inter-word">
119 51701 sandro.lab
                <div class="row" style="margin-top: 10px">
120
                    <h4 class="center-align"><b>TERMS OF USE and SLA</b></h4>
121
                    <b>REST APIs:</b> ScholeXplorer's REST APIs are free-to-use (no sign-up needed) by any third-party service. Note that:
122
                    <ul>
123
                        <li> The service limits each query to around 10,000 paged results (pages are by default of length 100 and can be navigated via resumption token); </li>
124 52357 sandro.lab
                        <li> Since March 2018 a full <a href="https://zenodo.org/search?page=1&size=20&q=openaire%20scholexplorer%20service%20JSON%20dump"> JSON dump of the service is made available in Zenodo.org</a>
125
                            every six months </li>
126 51701 sandro.lab
                        <li> For unlimited access to the APIs please contact the <a href="mailto:paolo.manghi@isti.cnr.it">service administrators</a> </li>
127
                    </ul>
128
                    <p>
129 52357 sandro.lab
                        <b>Metadata license is CC-BY:</b> Scholix metadata records returned by the service can be freely re-used by commercial and non-commercial
130 51701 sandro.lab
                        partners under CC-BY license, hence as long as OpenAIRE ScholeXplorer is acknowledged as content provider provider.
131
                    </p>
132
                    <p>
133 52357 sandro.lab
                        <b>SLA:</b> the service is running in production 24/7 within the OpenAIRE infrastructure premises deployed at the
134
                        <a href="http://icm.edu.pl/en/centre-of-technology/">data center</a> facilities
135 51705 sandro.lab
                        of the <a href="http://icm.edu.pl/en/">Interdisciplinary Centre for Mathematical and Computational Modelling</a> (ICM)
136 51701 sandro.lab
                    </p>
137
                </div>
138 52357 sandro.lab
                 <div class="row" style="margin-top: 10px">
139
                    <h4 class="center-align"><b>Faq</b></h4>
140
                     For any questions you may have about this service please contact <a href="mailto:sandro.labruzzo@isti.cnr.it">Sandro La Bruzzo</a>.
141
142
                     <p style="margin-top: 10px">1. <i>How to I expose Scholix links to Scholexplorer (or other services)? Does Scholix recommend an access protocol?</i></p>
143
                     Scholix does not recommend any specific protocol to expose links, although any community standard is strongly encouraged.
144
                     As to Scholexplorer, its harvesting layer bulk-collects links from external data sources via public APIs. OAI-PMH is preferable,
145
                     but also REST APIs can be accepted. The option of “incremental” harvesting is strongly encouraged (not mandatory),
146
                     for example allowing to search links by "last date of indexing": http://www.mydomain.eu/scholix?lastIndexingDate=yyyy-mm-dd).
147
                     If Scholix links are returned with all metadata fields, including the optional ones, the APIs above are enough. If instead, the links are limited to
148
                     the mandatory fields, then a "resolution" API would be required: given a PID of an object the API returns its full metadata record.
149
150
                     <p style="margin-top: 10px">2. <i>Which PIDs are compatible with Scholexplorer?</i></p>
151 52358 sandro.lab
                     Scholexplorer accepts links between any kind of persistent identifiers, including URLs.
152 52357 sandro.lab
                     The major standard identifiers (e.g. DOIs, PDBs, PMCID, etc) are also resolved to include the complete record information in Scholexplorer,
153
                     while in general URLs are not resolved as the variability of the associated resolvers cannot be handled by one service.
154
                     In principle if your data source is Scholix compliant and provides proprietary PIDs you can include complete Scholix links records in Scholexplorer in two ways:
155
                     (i) exposing complete Scholix records or (ii) exposing minimally compliant records but making a resolver available,
156
                     so that Scholexplorer can collect the PID complete records (note: your PIDs will have a specific type, associated by Scholexplorer to your resolver service).
157
158
159
                 </div>
160 51701 sandro.lab
            </div>
161
        </div>
162
    </div>
163 46770 sandro.lab
</section>
164 50035 sandro.lab