Interface SRU

SRU (Search/Retrieve via URL) est un protocole standard pour accéder aux bases de données via des requêtes URL. AGORA propose une interface SRU qui permet à des plateformes comme Archives Online (opens new window) d'interroger des données.

Utilisation de l'interface SRU

Pour utiliser l'interface SRU, les requêtes doivent être formulées selon le format suivant :

http://[Votre-Domaine]/sru/ao?version=1.2&operation=searchretrieve&query=[Votre-Requête]&maximumRecords=[Nombre]

• version : Seule la version 1.2 du protocole SRU est supportée.
• operation : Seule l'opération searchRetrieve est supportée.
• query : La requête de recherche doit être conforme à la syntaxe SRU et ne supporte que les critères de recherche serverchoice et isad.date.
  • Une requête avec serverchoice doit utiliser soit la clé and soit la clé any.
  • Une requête avec isad.date doit utiliser la clé within.
  • Plusieurs critères de recherche peuvent être combinés avec and ou or.
• maximumRecords : Paramètre optionnel. Par défaut, 100 enregistrements sont renvoyés.

Exemples

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

• 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

Réponse possible :

<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>