SRU-Schnittstelle

SRU (Search/Retrieve via URL) ist ein Standardprotokoll für den Zugriff auf Datenbanken über URL-Abfragen. AGORA bietet eine SRU-Schnittstelle an, die es Plattformen wie Archives Online (opens new window) ermöglicht, Daten abzufragen.

Nutzung der SRU-Schnittstelle

Um die SRU-Schnittstelle zu nutzen, muss die URL bestimmte Query-Parameter enthalten:

http://[Ihre-Domain]/sru/ao?version=1.2&operation=searchretrieve&query=[Ihre-Abfrage]&maximumRecords=[Anzahl]

• version: Es wird nur die Version 1.2 des SRU-Protokolls unterstützt.
• operation: Es wird nur die Operation searchRetrieve unterstützt.
• query: Die Suchabfrage muss in SRU-konformer Syntax erfolgen und unterstützt nur die Suchkriterien serverchoice und isad.date.
  • Eine Abfrage mit serverchoice muss entweder den Schlüssel and oder any verwenden.
  • Eine Abfrage mit isad.date muss den Schlüssel within verwenden.
  • Mehrere Suchkriterien können mit and oder or verknüpft werden.
• maximumRecords: Optionaler Parameter. Standardmässig werden 100 Datensätze zurückgegeben.

Beispiele

• Serverchoice

https://dls.example.ch/sru/ao/?version=1.2&operation=searchretrieve&query=Serverchoice+all+%22Hund%22

• isad.date

https://dls.staatsarchiv.bs.ch/sru/ao/?version=1.2&operation=searchretrieve&query=isad.date+WITHIN+%222020%202021%22

• serverchoice AND isad.date

https://dls.staatsarchiv.bs.ch/sru/ao/?version=1.2&operation=searchretrieve&query=isad.date+WITHIN+%222020%202021%22+AND+Serverchoice+all+%22Hund%22

Beispielantwort

<searchRetrieveResponse xmlns="http://www.loc.gov/zing/srw/"
    xmlns:isad="http://www.expertisecentrumdavid.be/xmlschemas/isad.xsd"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ap="http://www.archivportal.ch/srw/extension/"
    xmlns:rel="info:srw/extension/2/relevancy-1.0"
    xsi:schemaLocation="http://www.loc.gov/zing/srw/ http://www.loc.gov/standards/sru/sru1-1archive/xml-files/srw-types.xsd">
    <script />
    <version>1.2</version>
    <numberOfRecords>100</numberOfRecords>
    <records>
        <record>
            <recordSchema>isad</recordSchema>
            <recordPacking>xml</recordPacking>
            <recordData>
                <isad:archivaldescription>
                    <isad:identity>
                        <isad:reference>BSL 1060b 2/1093</isad:reference>
                        <isad:title>Hundesport: Mann und Hund während einer Schutzhunde-Übung</isad:title>
                        <isad:date>1925-1935</isad:date>
                        <isad:descriptionlevel>Dokument</isad:descriptionlevel>
                        <isad:extent />
                    </isad:identity>
                    <isad:context>
                        <isad:creator />
                    </isad:context>
                </isad:archivaldescription>
            </recordData>
            <recordPosition>1</recordPosition>
            <extraRecordData>
                <rel:score>0.5</rel:score>
                <ap:link>https://dls.example.ch/records/1693581</ap:link>
                <ap:beginDateISO>1925-01-01</ap:beginDateISO>
                <ap:beginApprox>0</ap:beginApprox>
                <ap:endDateISO>1935-12-31</ap:endDateISO>
                <ap:endApprox>0</ap:endApprox>
                <ap:hasDigitizedItems>1</ap:hasDigitizedItems>
            </extraRecordData>
        </record>
        <record>
            <recordSchema>isad</recordSchema>
            <recordPacking>xml</recordPacking>
            <recordData>
                <isad:archivaldescription>
                    <isad:identity>
                        <isad:reference>Ausstellungen B 25</isad:reference>
                        <isad:title>Hundeausstellungen, Hundeschauen, Internationale
                            Hundeausstellungen</isad:title>
                        <isad:date>1895-1932</isad:date>
                        <isad:descriptionlevel>Serie</isad:descriptionlevel>
                        <isad:extent />
                    </isad:identity>
                    <isad:context>
                        <isad:creator />
                    </isad:context>
                </isad:archivaldescription>
            </recordData>
            <recordPosition>2</recordPosition>
            <extraRecordData>
                <rel:score>0.5</rel:score>
                <ap:link>https://dls.example.ch/records/271148</ap:link>
                <ap:beginDateISO>1895-01-01</ap:beginDateISO>
                <ap:beginApprox>0</ap:beginApprox>
                <ap:endDateISO>1932-12-31</ap:endDateISO>
                <ap:endApprox>0</ap:endApprox>
                <ap:hasDigitizedItems>0</ap:hasDigitizedItems>
            </extraRecordData>
        </record>
    </records>
</searchRetrieveResponse>