SRU Schnittstelle zum Online Archivkatalog des Stadtarchivs Zürich
Eine Anleitung zum Umgang mit der SRU Schnittstelle zum Online Archivkatalog des Stadtarchivs Zürich
Eine Anleitung zum Umgang mit der SRU Schnittstelle zum Online Archivkatalog des Stadtarchivs Zürich
Willkommen zur Anleitung für die Benutzung der SRU-Schnittstelle des Online Archivkatalogs des Stadtarchivs Zürich. Diese Anleitung soll Ihnen helfen, die vielfältigen Möglichkeiten der SRU-Schnittstelle zu verstehen und effektiv zu nutzen.
Der Online Archivkatalog des Stadtarchivs Zürich ist erreichbar unter https://amsquery.stadt-zuerich.ch/ und bietet eine umfangreiche Sammlung der Archivbestände des Stadtarchiv Zürich. Mit der SRU-Schnittstelle können Sie gezielt nach Informationen suchen und diese effizient abrufen.
Diese Anleitung richtet sich an Archivarinnen und Archivare, Forschende und alle, die mit dem Archivkatalog arbeiten möchten. Sie bietet sowohl eine Einführung in die grundlegenden Funktionen als auch detaillierte Anleitungen für fortgeschrittene Abfragen und die Fehlerbehebung.
Wir hoffen, dass diese Anleitung Ihnen dabei hilft, das volle Potenzial der SRU-Schnittstelle auszuschöpfen und Ihre Arbeit mit dem Online Archivkatalog des Stadtarchivs Zürich zu erleichtern.
SRU (Search/Retrieve via URL) ist ein standardisiertes Protokoll, das es ermöglicht, über das Internet auf Datenbanken zuzugreifen und gezielte Suchanfragen zu stellen. Es basiert auf XML und HTTP und bietet eine flexible und effiziente Methode, um Informationen aus verschiedenen Quellen abzurufen. Weitere Informationen finden Sie auf Wikipedia oder der offiziellen Dokumentation.
Die SRU-Schnittstelle wird in vielen Bereichen eingesetzt, um den Zugriff auf umfangreiche Datenbestände zu erleichtern. Im Kontext des Stadtarchivs Zürich ermöglicht SRU den Nutzern, spezifische Archivbestände und Datensätze schnell und präzise zu finden. Forschende können beispielsweise gezielte Abfragen durchführen, um relevante Archivmaterialien für ihre Studien zu identifizieren, während Archivarinnen und Archivare die Schnittstelle nutzen können, um den Katalog effizient zu durchsuchen.
Über die Webseite https://amsquery.stadt-zuerich.ch/ können Sie verschiedene Suchanfragen direkt im Browser erledigen. Über die Archivplansuche können Sie in einer Baumdarstellung durch die Hierarchie der Ablage klicken. Mit der Volltext, Feld- und Deskriptorensuche können auch komplexere Suchen, die bestimmte Parameter und Filter kombinieren, realisiert werden. Hier gibt es eine Anleitung zur Benutzung der Suche auf der Webseite. Ein Teil dieser Suchfunktionalitäten können auch direkt über die SRU Schnittstelle angesteuert werden.
Um die SRU-Schnittstelle des Online Archivkatalogs des Stadtarchivs Zürich zu nutzen, müssen Sie zunächst eine Verbindung herstellen. Folgen Sie diesen Schritten:
URL aufrufen: Öffnen Sie Ihren Webbrowser und geben Sie die URL der SRU-Schnittstelle ein: https://amsquery.stadt-zuerich.ch/sru.
Parameter festlegen: Definieren Sie die notwendigen Parameter für Ihre Abfrage. Ein einfaches Beispiel könnte wie folgt aussehen:
https://amsquery.stadt-zuerich.ch/sru?version=1.2&operation=searchRetrieve&query=schulpflege
Abfrage senden: Drücken Sie die Eingabetaste, um die Abfrage zu senden. Sie erhalten eine XML-Antwort mit den Suchergebnissen:
Hier sind einige einfache Beispielabfragen, um Ihnen den Einstieg zu erleichtern:
Suche nach einem bestimmten Begriff:
https://amsquery.stadt-zuerich.ch/sru?version=1.2&operation=searchRetrieve&query=Frauenstimmrecht
Diese Abfrage sucht nach allen Einträgen (Volltext), die den Begriff “Frauenstimmrecht” enthalten.
Suche nach einem bestimmten Begriff im Titel:
Diese Abfrage sucht nach Einträgen, die den Begriff “Abstimmungszeitung” im Titel enthalten.
Suche nach einem bestimmten Zeitpunkt:
Diese Abfrage sucht nach Einträgen, die am 1. Januar 1900 beginnen.
Volltextsuche:
Wenn bei der Abfrage SERVERCHOICE angegeben wird, wird die Volltextsuche verwendet. Das heisst, es werden alle Bestände und auch Anhänge (Findmittel und/oder Digitalisate) durchsucht. Diese Abfrage sucht zum Beispiel nach Einträgen, in welchen im Vollindex sowohl der Begriff Geschäftsbericht wie auch Pandemie vorkommt.
Diese grundlegenden Abfragen sollten Ihnen helfen, sich mit der Funktionsweise der SRU-Schnittstelle vertraut zu machen. Details zu Filtern und Parameteroptionen finden Sie im nächsten Kapitel.
Bitte beachten Sie, dass die Schnittstelle maximal 1500 Ergebnisse (records) zurückgeben kann. Falls es für eine Anfrage mehr Treffer geben sollte, werden nur die ersten 1500 angezeigt.
Um Ihre Abfragen weiter zu verfeinern, können Sie verschiedene Filter und Parameter verwenden.
Unterstützte ISAD(G)-Felder sind:
isad.title: Titel (Textfeld)isad.date: Entstehungszeitraum (Datumsfeld)isad.reference: Signatur (Textfeld)isad.descriptionlevel: Stufe (Textfeld)Verschiedene Suchkriterien können verknüpft werden. Zur Zeit werden diese Operatoren untersützt:
ANDNicht unterstützt werden:
ORNOTBei der Volltextsuche werden folgende Vergleichsoperatoren untersützt:
=, ==, exact, equal, adj: sind synonym und entsprechen der Volltextsuche “mit der genauen Wortgruppe”any: entspricht der Volltextsuche mit “mit irgendeinem der Wörter”all: entspricht der Volltextsuche mit “mit allen Wörtern”Bei der Textfeldsuche werden folgende Vergleichsoperatoren unterstützt:
= entspricht der Feldsuche mit Operator “enthält”==, exact: sind synonym und entsprechen der Feldsuche mit Operator “beginnt mit”Bei der Datumssuche werden folgende Vergleichsoperatoren unterstützt:
=, within und encloses: sind synonym und benötigen zwei Datumsangaben== und exact: sind synonym und benötigen eine DatumsangabeMit der SRU-Schnittstelle können Sie auch komplexere Abfragen durchführen, um spezifischere und detailliertere Ergebnisse zu erhalten. Hier sind einige Beispiele:
Suche nach mehreren Kriterien:
Diese Abfrage sucht nach Einträgen, die im Titel “Abstimmungszeitung” enthalten und das Datum zwischen 1960 und 1962 ist.
Suche nach einer bestimmten Signatur:
Diese Abfrage sucht nach Einträgen, deren Signatur mit “V.A.a.” beginnt.
Suche nach Dokumenten einer bestimmten Stufe:
Diese Abfrage sucht nach Einträgen der Stufe “Dossier”, die “Feuerpolizei” im Titel haben.
Suche mit Bereichsangaben:
Diese Abfrage sucht nach Einträgen, deren Enstehungszeitraum zwischen dem 1. Januar 1920 und dem 31. Dezember 1925 sich erstreckt.
Weitere Beispiele mit komplexen Abfragen finden Sie auch im Anhang weiter unten.
Möchten Sie viele verschiedene Abfragen machen oder Abfragen zu bestimmten Zeitpunkten wiederholen, kann es sinnvoll sein den Ablauf zu automatisieren. Das kann mit einer Vielzahl von Programmierwerkzeugen erledigt werden. Hier ein Beispiel mit der Programmiersprache Python. Um diese zu benutzen müssen Sie Python zuvor installieren. Mehr Informationen dazu finden Sie hier: https://www.python.org/about/gettingstarted/.
Da es sich bei SRU um ein XML-basiertes Protokoll handelt, gibt es dazu die Hilfsbilbiothek sruthi, die dabei hilft die Anfragen zu formulieren und die Antworten für Python nutzbar zu machen. Sruthi lässt sich einfach über die Kommandozeile installieren:
pip install sruthi
Abfragen können Sie so absetzen:
>>> import sruthi
>>> records = sruthi.searchretrieve(
... 'https://amsquery.stadt-zuerich.ch/SRU/',
... query="isad.reference = V.B.b.43.:1 AND isad.descriptionlevel = Dossier"
... )
>>> print(records)
SearchRetrieveResponse(sru_version='1.2',count=165,next_start_record=11)
>>> print(records[0]) # zeige ersten record
{'schema': 'isad', 'reference': 'V.B.b.43.:1.1.', 'title': 'Geschäftsbericht des Stadtrats', 'date': '1859', 'descriptionlevel': 'Dossier', 'extent': None, 'creator': None, 'extra': {'score': '1', 'link': 'https://amsquery.stadt-zuerich.ch/detail.aspx?Id=549636', 'beginDateISO': '1859-01-01', 'beginApprox': '0', 'endDateISO': '1859-12-31', 'endApprox': '0', 'hasDigitizedItems': '1'}}
Das Ergebnis ist ein iterierbares Python-Objekt. Sie können sich einzelne Einträge heraussuchen (z.B. records[0] für den ersten Eintrag, oder records[:5] für die ersten 5 Einträge). Oder das komplette Objekt in der Schleife durchgehen und z.B. alle Einträge in einer Tabelle als CSV speichern:
import sruthi
import csv
import sys
# Abfrage der SRU Schnittstelle
records = sruthi.searchretrieve(
'https://amsquery.stadt-zuerich.ch/SRU/',
query="isad.reference = V.B.b.43.:1 AND isad.descriptionlevel = Dossier"
)
# Erstelle CSV Writer
header = ['signatur', 'titel', 'jahr', 'link_query']
writer = csv.DictWriter(
sys.stdout, # Ergebnis im Ausgabefenster angezeigt
header,
delimiter=',',
quotechar='"',
lineterminator='\n',
quoting=csv.QUOTE_MINIMAL
)
writer.writeheader()
# Schleife über alle Einträge
for record in records:
row = {
'signatur': record['reference'],
'titel': record['title'],
'jahr': record['date'],
'link_query': record['extra']['link'],
}
writer.writerow(row)
Sruthi bietet noch eine Vielzahl weiterer Funktionalität. Weitere Beispiele finden Sie auch auf der Githubseite des Projektes.
Nun, da Sie einige Beispiel von Abfragen mit Python gesehen haben, ist es an der Zeit selbst eigene Abfragen zu machen. Wir haben für Sie ein Jupyter Notebook vorbereitet, mit dem Sie selbst Abfragen ausprobieren können. Wenn Sie keine Python-Installation auf Ihrem Computer haben, können Sie das Notebook im Browser öffnen (z.B. über Google Colab indem Sie hier klicken 
). Führen Sie dort die Codezellen von oben nach unten aus mit CTRL + Enter. Trauen Sie sich, sie können nichts kaputt machen!
Um die SRU-Schnittstelle des Online Archivkatalogs des Stadtarchivs Zürich optimal zu nutzen, beachten Sie die folgenden Tipps:
Basisabfrage
https://amsquery.stadt-zuerich.ch/SRU/?operation=searchretrieve&version=1.2&query=
Alle records (Verzeichnungseinheiten) deren Signatur (isad.reference) beginnt mit: “V.E.c.72.:1.2.1.”
Alle records (Verzeichnungseinheiten) deren Signatur beginnt mit: “V.E.c.72.:1.2.1.” und Titel ist “Tram”
Alle records (Verzeichnungseinheiten) deren Signatur beginnt mit: “V.E.c.72.:1.2.1.” und Titel ist “Tram” und Datum ist 1920
Alle records (Verzeichnungseinheiten) deren Signatur beginnt mit: “V.E.c.72.:1.2.1.” und Titel ist “Tram” und Datum ist zwischen 1920 und 1925
Volltextsuche auf der Detailseite:
Alle records (Verzeichnungseinheiten) deren Signatur beginnt mit: “VII.6.”:
Alle records (Verzeichnungseinheiten) welche mit der Signatur “VII.6.” beginnen und Stufe “Dossier” sind:
Alle records (Verzeichnungseinheiten) welche mit der Signatur “VII.” beginnen und im Volltext “theater” oder “griechen” vorkommt:
Alle records (Verzeichnungseinheiten) welche mit der Signatur “VII.” beginnen, Stufe “Dossier” sind und der Zeitraum 1950 ist:
)In dieser Anleitung haben wir die grundlegenden und erweiterten Funktionen der SRU-Schnittstelle des Online Archivkatalogs des Stadtarchivs Zürich behandelt. Sie haben gelernt, wie Sie einfache und komplexe Abfragen durchführen, verschiedene Filter und Parameter nutzen und häufige Probleme beheben können. Mit diesen Kenntnissen sind Sie nun in der Lage, die SRU-Schnittstelle effizient zu nutzen und gezielt im Online Archivkatalog des Stadtarchivs Zürich nach Einträgen zu suchen.
Wir hoffen, dass diese Anleitung Ihnen geholfen hat, die SRU-Schnittstelle besser zu verstehen und zu nutzen. Falls Sie noch Fragen zu dieser Anleitung oder zur Benutzung der Schnittstelle haben wenden Sie sich gerne an das Open Data Team. Bei inhaltlichen Fragen steht Ihnen das Team des Stadtarchivs zur Verfügung.