SRU service for LUP Student Papers
About the SRU Service
SRU (Search/Retrieve via URL) is a standard XML-based search protocol for Internet search queries, utilizing CQL (Contextual Query Language) as the standard syntax for representing queries.
This service makes it possible to automate basic queries and search in all the public records of LUP student papers.
Note that research papers are not included. They have their own SRU service.
If you want to harvest all the records, the LUP OAI service is better suited for that purpose.
To avoid server overload we kindly ask you to limit use to maximum 30 queries per minute.
The base URL for the service is http://lup.lub.lu.se/student-papers/sru.
SRU and CQL conformance
- Version 1.1 of SRU is supported (Link to specification here )
- Scan operation is not supported.
- Explain operation is supported.
- The following relations are supported: '<', '>', '>=', '<=', '=', '<>', 'exact', 'all', 'any'.
- Relation modifiers are not supported.
- The boolean operators 'And', 'Or', 'Not' are supported. 'Prox' is not supported.
- Boolean modifiers are not supported.
- Masking characters '*' and '?' are supported, except at the beginning of words.
- Result sets are not supported.
- Maximum number of records that can be returned for a single
request is now 1000. By default not more than 20
records are returned, but this can be changed by setting the parameter
maximumRecords
.
Indexes available for CQL queries
The available indexes are listed below. Note that the '_' between letters are ignored in the index name and the index name is also case insensitive.
So articlenumber
can also be written as article_number
or articleNumber
.
Each index corresponds to one or more fields in the records.
Index name | Relations Supported | Possible Values | Sortable | Description |
---|---|---|---|---|
abstract |
<>, =, all, any | any text | no | Searches all abstracts text including popular abstracts |
author |
<>, =, all, any, exact | See person indexes | yes | |
basic |
<>, =, all, any | any text | no | Search in the following basic fields: alternativeTitle, author, first_author, isbn, issn, keyword, last_author, mainTitle, oId, publication, publishingYear, supervisor |
course |
<>, =, exact | any text | yes | |
courseterm |
<>, =, exact | any text | yes | |
datecreated |
<, <=, <>, =, >, >=, exact | See date-time indexes | yes | |
datefirstpublic |
<, <=, <>, =, >, >=, exact | See date-time indexes | yes | |
datelastchanged |
<, <=, <>, =, >, >=, exact | See date-time indexes | yes | |
department |
<>, =, >, all, any, exact | See list of valid department/affilation | no | will also find any subunits of the given organizationial unit |
departmentexclusive |
<>, =, >, all, any, exact | See list of valid department/affilation | no | |
departmentsingle |
<>, =, >, all, any, exact | See list of valid department/affilation | no | |
fulltext |
<>, =, exact | 1 | no | 1 if document has open access full text |
funder |
<>, =, all, any, exact | funder ID / free text | no | |
id |
<, <=, <>, =, >, >=, any, exact | ID of the record in LUP-SP | yes | |
isbn |
<>, =, >, any', exact | Valid ISBN | yes | |
issn |
<>, =, >, any, exact | Valid ISSN | yes | |
keywords |
<>, =, >, all, any, exact | any text | no | |
language |
<>, =, exact | three letter code. See the list of language codes | no | |
otheridentifier |
<>, =, exact | any text | no | |
popularabstract |
<>, =, all, any | any text | no | |
publication |
<>, =, >, all, any, exact | any text | yes | |
publicationidentifier |
<>, =, exact | any text | no | index of isbn, issn, otherPublicationIdentifier associated with the publication |
publishingyear |
<, <=, <>, =, >, >=, exact, within | valid year | yes | publishing year |
reportnumber |
<>, =, exact | any text | no | |
studentpapertype |
<>, =, any, exact | see the list of document types | yes | |
subject |
<>, =, all, any, exact | see the list of subjects | no | |
supervisor |
<>, =, all, any, exact | See person indexes | no | |
title |
<>, =, >, all, any, exact | any text | yes | Searches both the main title and the alternative title |
url |
<>, =, exact | any text | no |
Date-time indexes
Search term can be in the form of:
YYYY-MM-DD hh:mm:ss
(required to match using the 'exact' relation)
For other relations you have the option to specify just parts of the date-time to match:
YYYY-MM-DD hh:mm
YYYY-MM-DD hh
YYYY-MM-DD
YYYY-MM
YYYY
For the '=' relation you can use the wildcards * and ? anywhere in the string to match. For example: 'datecreated = *-07-*' will find all records created in July any year.
Person Indexes
Searches names and IDs associated with the person.
If 'exact' is used the search term should one of:
- "surname, given names" (used also for sorting)
- lucat-id
- orcid
List of values for specific fields
Document Types
Type | Description |
---|---|
h1 | Master's Degree (One Year) |
h2 | Master's Degree (Two Years) |
h3 | Professional qualifications (4 Years - ) |
l1 | 1st term paper (old degree order) |
l2 | 2nd term paper (old degree order) |
l3 | Miscellaneous, Projetcs etc. |
m1 | University Diploma |
m2 | Bachelor Degree |
m3 | Professional qualifications ( - 4 Years) |
Departments/Affiliations
A current LU organization tree with department numbers is possible to obtain in XML format here.
Languages
Languages, 3 letter code, subset of (iso639-2b), 'mis' is used for other languages.
Language code | Language name |
---|---|
ara | Arabic |
chi | Chinese |
dan | Danish |
eng | English |
fin | Finnish |
fre | French |
ger | German |
gre | Greek |
heb | Hebrew |
ice | Icelandic |
ita | Italian |
jpn | Japanese |
lat | Latin |
mis | Other |
nor | Norwegian |
pol | Polish |
por | Portuguese |
rum | Romanian |
rus | Russian |
spa | Spanish |
swe | Swedish |
tur | Turkish |
und | Unknown |
yid | Yiddish |
Subjects
Subject Code | Subject |
---|---|
afs | Agriculture and Food Sciences |
ara | Arts and Architecture |
bls | Biology and Life Sciences |
bue | Business and Economics |
che | Chemistry |
csc | Cultural Sciences |
ees | Earth and Environmental Sciences |
gew | General Works |
hia | History and Archaeology |
lal | Languages and Literatures |
lps | Law and Political Science |
mas | Mathematics and Statistics |
mhs | Medicine and Health Sciences |
pea | Performing Arts |
pha | Physics and Astronomy |
phr | Philosophy and Religion |
scg | Science General |
sos | Social Sciences |
tee | Technology and Engineering |
Example queries
Query | Description |
---|---|
abstract = nanotechnology | the abstract contains the word "nanotechnology" |
author all "eriksson nilsson" | author list contains both the words eriksson and nilsson |
author any "eriksson bergman" | author list contains either eriksson or nilsson |
author exact "Persson, Martin" | author has the given full name |
author exact fkv12fab | author has the given student account ID |
dateCreated = *-05-30 | the record was last changed in January 2019 or later |
dateCreated exact "2019-03-21 18:45:44" | the record was created at the specified date and time |
dateCreated= "*-01 00*" | the record was created the 1st of the month between 12 and 1 am. |
datelastChanged >= 2019-01 | the record was last changed in January 2019 or later |
department exact v1000601 and death | Records under v1000601 (Department of Biology) and death in any of the common fields. |
funder = "cent??" | Records with with words in funder name matching the supplied term (will match both 'centre' and 'center') |
funder exact F407 | Record with project matching the funder ID |
id any "1334179 1333689 1334134" | records with any the given IDs (LUP ID) |
issn any "1401-9191 0280-5316 0280-5316" | Records with the any of the supplied ISSNs |
keywords exact "war crimes" | keywords entry is exactly the phrase "war crimes" |
studentPaperType exact M2 | the document type is H2 (Bachelor Degree) |
subject all "hia gew" | with subjects both under "History and Archaeology" and "General Works" |
subject exact lal | with subject "Languages and Literatures" |
supervisor exact "Gabrielsson, Sara" | supervisor has the given full name' |
sweden | any common fields contain the word "Sweden" |
title=computer* and title <> games | title or alternative title contains words starting with "computer" but don't contain "games" |
Note that the maximum size of the URI should not reach more than 8190 bytes or you will get the "URI too long" server error. In order to avoid this error for large queries the request to the server can be sent as a POST request instead of a GET request.
Output format
For description (in Swedish) of the output format see: MODS applikationsprofil
See also mapping of LUP fields to MODS: LUP to MODS mapping .