Alma und PrimoVE

Alma (Backend) und PrimoVE (Frontend, Discovery) sind die zentralen Softwarekomponenten unseres Bibliothekssystems. Das System wird von der Firma Ex Libris (Teil von ProQuest/Clarivate) betrieben. Die Zentralbibliothek ist Teil der Swiss Library Service Platform (SLSP).

Struktur

Innerhalb von SLSP bestehen mehrere "Zonen": Die SLSP-weite "Network Zone"(NZ) und etwa 30 kleinere "Institution Zones"(IZ). Die UZB ist eine dieser Institution Zones. In der Network Zone sind alle bibliographischen Daten aller Institution Zones abgelegt. Die Daten zu einzelnen Exemplaren wiederum befinden sich in den IZ.

Allgemeine Institution ID: 41SLSP_UZB
IZ Code: UZB

Schnittstellen

OAI, SRU, Linked Data, REST, z39.50

GUI Ansicht (PrimoVE)

Die so genannte "MMSID" ist die Alma-Systemnummer.

MMSID Suffix UZB: 5508
MMSID Suffix Networkzone: 5501

Permalink

Der Permalink für einen bestimmten Titel ist wie folgt aufgebaut:

https://uzb.swisscovery.slsp.ch/permalink/{institution}/{viewparameter}/alma{mmsid}

Leider handelt es sich dabei nicht um "echte" Permalinks. Bei einem Systemwechsel kann es sein, dass der Permalink nicht mehr funktioniert.

In dem viewparameter sind Angaben zu Einstellungen der Oberfläche codiert. Der Aufbau dieser Codierungsdetails ist nicht öffentlich bekannt.

Beispiel:
https://uzb.swisscovery.slsp.ch/permalink/41SLSP_UZB/4ep765/alma990060637490205508

DeepLink

Erstellung von «Deep Links» (Direkte Links) auf konkrete Objekte in PrimoVE

Format:

https://uzb.swisscovery.slsp.ch/discovery/fulldisplay?vid=41SLSP_UZB:UZB&docid=alma{MMSID}

Beispiel:
https://uzb.swisscovery.slsp.ch/discovery/fulldisplay?vid=41SLSP_UZB:UZB&docid=alma990106444570205508

Source Record anzeigen

Mit dem Link "Quelldaten anzeigen" in der Primo-Titelansicht kommt man auf das zugrundeliegende Marc-Record in Alma. Beispiel:
https://uzb.swisscovery.slsp.ch/discovery/sourceRecord?vid=41SLSP_UZB:UZB&docId=alma990109650930205508&recordOwner=41SLSP_NETWORK

Pnx Record anzeigen

Durch das ergänzen des Permalinks zu einer Aufnahme durch &showPnx=true am Ende kann das PNX-Record angezeigt werden. Das PNX-Record ist die Datengrundlage für die Suche in Primo.

Aus der Ex Libris Dokumentation:
For use in Primo VE, the source records are stored in the Primo VE normalized format. From the UI, you can view a normalized record in the JSON format by adding the &showPnx=true parameter to the end of the record's full display URL. This is useful to understand what metadata is being used in Primo VE and why information appears in the results.

Beispiel:
https://uzb.swisscovery.slsp.ch/discovery/fulldisplay?context=L&vid=41SLSP_UZB:UZB&docid=alma990060637490205508&showPnx=true

Erstellung von «Deep Links» auf vorbereitete Suchen in PrimoVE

Wichtige Such-Parameter und ihre Reihenfolge:

a. Basis-URL:

    https://uzb.swisscovery.slsp.ch/discovery/search?

b. QUERY - Abfrage

Simple Suche
```
query=any,contains,peter%20meier 
```
(hier Beispiel mit 2 Wörtern. Trennen mit %20 statt Leerschlag)
Mehrere Suchen verknüpfen (mehrere «query») query=any,contains,peter%20meier,AND&query=title,begins_with,interview,AND (hier Beispiel: Jedes Feld enthält: «peter meier» UND Titel beginnt mit: «interview»)

c. TAB / SEARCH_SCOPE - Suchbereich (zwingend auszuwählen):

&tab=41SLSP_UZB_DN_and_CI&search_scope=DN_and_CI = swisscovery (mit CDI)
&tab=41SLSP_UZB_DN&search_scope=DiscoveryNetwork = swisscovery (ohne CDI)
&tab=LibraryCatalog&search_scope=MyInstitution = ZB/UZH (ohne CDI)
&tab=41SLSP_UZB_MyInst_and_CI&search_scope=MyInst_and_CI = ZB/UZH (mit CDI)

d. VID - View (zwingend anzugeben): &vid=41SLSP_UZB:UZB

e. LANG - Oberflächensprache (optional):

&lang=de = Standard, kann man weglassen
&lang=en = alle anderen Sprachen zu definieren (Optionen: en, fr, it)

f. SORTBY - Sortierung (optional):

&sortby=rank = Relevanz (Standard, kann man weglassen)
&sortby=date_d = Datum neuestes
&sortby=date_a = Datum ältestes
&sortby=title = Titel
&sortby=author = Urheber

g. MODE – Erweiterte oder einfache Suche

&mode=advanced = zwingend bei erweiterter Suche (sollte letzter Parameter sein)
&mode=basic = optional bei einfacher Suche (sollte letzter Parameter sein)

Beispiel für Such-Parameter: Einfache Suche nach "test" im Suchbereich "swisscovery" (mit CDI):
https://uzb.swisscovery.slsp.ch/discovery/search?query=any,contains,test&tab=41SLSP_U ZB_DN_and_CI&search_scope=DN_and_CI&vid=41SLSP_UZB:UZB

Beispiel für erweiterte Such-Parameter: Jedes Feld enthält: «wagner» UND Titel beginnt mit: «tristan» im Suchbereich "swisscovery" (mit CDI):
https://uzb.swisscovery.slsp.ch/discovery/search?query=any,contains,wagner&title,begins_with,tristan,AND&tab=41SLSP_U ZB_DN_and_CI&search_scope=DN_and_CI&vid=41SLSP_UZB:UZB&mode=advanced

h. PFILTER / RTYPE / FACET / MFACET (Optional) Es können zur Einschränkung der Suche auch noch weitere Filter und Facetten definiert werden. Zum Herausfinden der möglichen Parameter und Optionen sollte man die gewünschte Suche über das «Erweiterte Suche»-Formular in PrimoVE testen und dann die angezeigte URL in der Adresszeile des Browsers analysieren/kopieren. Diese Herangehensweise empfiehlt auch ExLibris. Beispiel für erweiterte Suche: "Jedes Feld" "enthält": «meier» UND "Titel" "beginnt mit": «schweiz» UND "Materialart" gleich «Bücher» und "Sprache" gleich «deutsch» im Suchbereich "ZB / Universität Zürich (ohne CDI)":
https://uzb.swisscovery.slsp.ch/discovery/search?query=any,contains,meier,AND&query=title,begins_with,schweiz,AND&pfilter=lang,exact,ger,AND&pfilter=rtype,exact,books,AND&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&mode=advanced

Beispiel für erweiterte Suche: "Jedes Feld" "enthält": «data science» UND "Materialart" gleich «Bücher» und "Sprache" gleich «deutsch» im Suchbereich "ZB / Universität Zürich (ohne CDI)", nur mit Exemplaren der Bibliothek für Volkswirtschaft:
https://uzb.swisscovery.slsp.ch/discovery/search?query=any,contains,data%20science,AND&pfilter=lang,exact,ger,AND&pfilter=rtype,exact,books,AND&tab=LibraryCatalog&search_scope=MyInstitution&facet=library,include,5508%E2%80%93112051880005508&vid=41SLSP_UZB:UZB&mode=advanced

Beispiel für Suche nach «miller» mit Bibliotheksfilter RWI:
https://uzb.swisscovery.slsp.ch/discovery/search?query=any,contains,miller&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&mfacet=library,include,5508%E2%80%93112071640005508%2C1

Vordefinierte / «Gemerkte» Facette/Filter

Es ist möglich, eine Facette dauerhaft in einer vordefinierten Suchanfrage vorzudefinieren. Sie wird aber erst als «gemerkter Filter» anzeigt, wenn eine Suche durchgeführt wird. So ist es möglich, dem Kunden ein leeres Suchformular anzuzeigen, das aber bereits auf eine bestimmte Facette vordefiniert ist. Dieser Parameter wird allerdings in einem Cookie gespeichert, das macht das Testen schwierig.

Dazu an das Ende der Facette «,lk» (Komma kleines L, kleines K = für «Locked») anhängen. Beispiel für ein leeres Suchformular, bei dem versteckt bereits die Bibliothek «Slavisches Seminar» voreingestellt ist:
https://uzb.swisscovery.slsp.ch/discovery/search?vid=41SLSP_UZB:UZB&facet=library,include,5508%E2%80%93112071410005508,lk

Filter für die versteckte Facette Standort nutzen

Es gibt im Primo die Möglichkeit, nach einem Standort zu filtern per Link, obwohl die Standort-Facette nicht immer sichtbar ist. Dazu braucht es ein URL-Schnipsel:

 &facet=location_code,include,[Standort-Code]

Beispiel:

&facet=location_code,include,5508%E2%80%93112071180005508%E2%80%93mi

für den Standort «Milchbuck» der ZB Zürich.

Der lange Code vorne variiert von Bibliothek zu Bibliothek. Der Wert ganz hinten ist die Standort-Auswahl, hier also "mi" (Das ist der Standort-Code). Er kann einfach angepasst werden.

Diese Codes bleiben im Normalfall stabil (ausser vielleicht bei grossen Konfigurationsänderungen). Beispiele ausgewählter Codes pro Standort finden sich hier (im 2. Tab):
https://connect.uzh.ch/communities/service/html/communityview?communityUuid=350d0ed1-edae-462e-a52c-ebc1f5551275#fullpageWidgetId=Wba54c796caf2_4ba2_bac7_cae756e6343a&file=72397555-b855-49d5-b7d9-dcfadd206910

Um den Code für einen bestimmten Standort zu eruieren, kann man das Schnipsel über den Test-View https://slsp-uzb.primo.exlibrisgroup.com/discovery/search?vid=41SLSP_UZB:UZB_TEST&lang=en finden. Dort ist die Standort-Facette ganz unten eingeblendet und man kann nach dem Filtern den relevanten Code-Schnipsel aus der URL kopieren (nur den Schnipsel, nicht alles, weil dort ja auf den Test-View verwiesen wird).

Ein Beispiel mit Suche nach «test» und Filter Standort-Code MI im produktiven View, sähe dann so aus:
https://slsp-uzb.primo.exlibrisgroup.com/discovery/search?query=any,contains,test&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&facet=location_code,include,5508%E2%80%93112071180005508%E2%80%93mi&lang=en&offset=0

Ein Beispiel mit Suche nach «test» und Filter Standort-Code ULPSF:
https://slsp-uzb.primo.exlibrisgroup.com/discovery/search?query=any,contains,test&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&facet=location_code,include,5508%E2%80%93112046180005508%E2%80%93ulpsf&lang=en&offset=0

Mit "Remember all filters" kann man dann auch temporär darin weitersuchen. Um das via Link zu setzen, muss man noch ein ",lk" nach dem Filter einbauen:
https://slsp-uzb.primo.exlibrisgroup.com/discovery/search?query=any,contains,test&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&facet=location_code,include,5508%E2%80%93112046180005508%E2%80%93ulpsf,lk&lang=en&offset=0

Um alles von einem Standort zu finden, sucht man z.B. mit einem Fragezeichen (%3F):
https://slsp-uzb.primo.exlibrisgroup.com/discovery/search?query=any,contains,%3F&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&facet=location_code,include,5508%E2%80%93112046180005508%E2%80%93ulpsf,lk&lang=en&offset=0

Eine leere Seite ohne Suche, die aber dann auf etwas filtert, würde so aussehen:
https://uzb.swisscovery.slsp.ch/discovery/search?vid=41SLSP_UZB:UZB&facet=location_code,include,5508%E2%80%93112052110005508%E2%80%93ulssa,lk

Auflistung aller Bestände einer Bibliothek

Ein «%»-Zeichen als Platzhalter in die Suche mit einem aktiven Bibliotheks-Filter eingeben. Auch andere Sonderzeichen wie «+», «.» funktionieren (ausser «*» und «?»). Aber das ist wohl keine offizielle Funktion, wurde auch noch nicht ausreichend getestet, ob es wirklich alle Bestände zurückliefert. Es scheint auch nur zu funktionieren, wenn ein Filter aktiv ist.

Digital Representations

(gilt nur für digitale Repräsentationen, die in Alma/Primo direkt gespeichert sind und nicht auf externen Plattformen wie e-manuscripta, e-rara oder ZOP)

Dokumentation: https://developers.exlibrisgroup.com/alma/integrations/digital/almadigital/access/

Beispiel RepresentationID zum Testen: 12464211710005508

Standard AlmaViewer https://uzb.swisscovery.slsp.ch/view/delivery/41SLSP_UZB/{RepresentationID}
Universal Viewer https://uzb.swisscovery.slsp.ch/view/UniversalViewer/41SLSP_UZB/{RepresentationID}
BookreaderViewer https://uzb.swisscovery.slsp.ch/view/BookReaderViewer/41SLSP_UZB/{RepresentationID}
Representation Details als JSON https://uzb.swisscovery.slsp.ch/view/delivery/41SLSP_UZB/{RepresentationID}.json
IIIF manifest https://uzb.swisscovery.slsp.ch/view/iiif/presentation/{RepresentationID}/manifest
Thumbnail https://uzb.swisscovery.slsp.ch/view/delivery/thumbnail/41SLSP_UZB/{RepresentationID}
Redirect zu digitalem Objekt auf Amazon S3 https://uzb.swisscovery.slsp.ch/view/delivery/41SLSP_UZB/{MMSID}/{RepresentationID}

Z39.50

Network-Ebene (SLSP weit)

Host: slsp-network.alma.exlibrisgroup.com
Port: 1921
Database name: 41SLSP_NETWORK
Username: leave empty / not necessary
Password: leave empty / not necessary
Syntax: MARC21
Charset: UTF8
Supported search attributes: Term (1016, 1017), Author (1, 1003, 1004), Subject (21), Title (4), ISBN (7), ISSN (8), Date (31), Identifier (12), OCLC Number (1211)

https://slsp.ch/de/metadata/