# e-manuscripta OAI

Basis-URL:

	https://www.e-manuscripta.ch/oai?

### OAI-Sets

Komplette Liste der verfügbaren Sets:<br>
<a href="https://www.e-manuscripta.ch/oai?verb=ListSets" target="_blank">https://www.e-manuscripta.ch/oai?verb=ListSets</a>

Jede Kollektion im e-manuscripta-GUI wie z.B. "Karten", "Briefe", "Bilder" hat im Hintergrund ein gleichnamiges OAI-Set (in lowercase, z.B. "karten"). Jede Kollektion hat eine eigene VLID (Systemnummer).

#### ZB-Sets

Neben den auch via GUI verfügbaren Kollektionen gibt es weitere OAI-Sets, die sich durch ihre Herkunft definieren. Für die ZB gibt es drei solche Sets.

##### emanuszuz 

Enthält Handschriften (z.B. Einzelbriefe), die in Alma erschlossen werden oder aus der Aleph-Handschriftendatenbank EBI04 migriert wurden: ZB-Ressourcen aus den Kollektionen "Briefe", "Texte" und "Varia".

##### emanuszuzneb 
Enthält Ressourcen, die in Alma erschlossen werden oder aus der bibliographischen Datenbank Aleph EBI01 migriert wurden: Alle digitalisierten ZB-Karten der Kollektion "Karten" sowie den Grossteil der digitalisierten ZB-Bilder aus der Kollektion "Bilder" (Bilder, die in der Graphischen Sammlung erschlossen wurden).

##### emanuszuzcmi 
Enthält Einzeldokumente aus Nachlässen, die in CMI Star erschlossen werden (Briefe, Bilder etc.).	

#### doi
<a href="https://www.e-manuscripta.ch/oai/?verb=ListRecords&metadataPrefix=oai_dc&set=doi">https://www.e-manuscripta.ch/oai/?verb=ListRecords&metadataPrefix=oai_dc&set=doi</a><br>
Set wird zum Import der Daten aus E-Manuscripta nach Primo / swisscovery verwendet.<br>
Anzeige aller importieren Daten aus E-Manuscripta in Primo:
<a href="https://uzb.swisscovery.slsp.ch/discovery/search?query=facet_source_code,contains,UZB_EManuscripta,AND&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&mode=advanced">https://uzb.swisscovery.slsp.ch/discovery/search?query=facet_source_code,contains,UZB_EManuscripta,AND&tab=LibraryCatalog&search_scope=MyInstitution&vid=41SLSP_UZB:UZB&mode=advanced</a>


### Verfügbare Metadaten-Formate

<a href="https://www.e-manuscripta.ch/oai?verb=ListMetadataFormats" target="_blank">https://www.e-manuscripta.ch/oai?verb=ListMetadataFormats</a>

Beispiel:  

		<metadataPrefix>oai_dc</metadataPrefix>

### Abfrage-Beispiele

- GetRecord (Identifier: VLID)<br>
<a href="https://www.e-manuscripta.ch/oai?verb=GetRecord&metadataPrefix=oai_dc&identifier=3071845" target="_blank">https://www.e-manuscripta.ch/oai?verb=GetRecord&metadataPrefix=oai_dc&identifier=3071845</a><br><br>

- ListRecords<br><br>
	- Nach Zeitraum:<br>
        <a href="https://www.e-manuscripta.ch/oai/?verb=ListRecords&metadataPrefix=oai_dc&set=emanuszuz&from=2021-09-01&until=2021-09-08" target="_blank">https://www.e-manuscripta.ch/oai/?verb=ListRecords&metadataPrefix=oai_dc&set=emanuszuz&from=2021-09-01&until=2021-09-08</a><br><br>
    - Alternativer URL-Aufbau (siehe Set):<br>
    	https://www.e-manuscripta.ch/emanuszuz/oai/?verb=ListRecords&metadataPrefix=oai_dc&from=2021-08-23&until=2021-08-29<br><br>
    - mit Resumption Token:<br>
        <a href="https://www.e-manuscripta.ch/emanuszuz/oai/?verb=ListRecords&resumptionToken=0x9a4e81f38f5a22a1a20daeee10ed1d0d-cursor_p_3D10_p_26from__p_3D2021-09-01T00_p_253A00_p_253A00Z_p_26metadataPrefix_p_3Doai_dc_p_26batch_size_p_3D11_p_26until_p_3D2021-09-09T23_p_253A59_p_253A59Z" target="_blank">https://www.e-manuscripta.ch/emanuszuz/oai/?verb=ListRecords&resumptionToken=0x9a4e81f38f5a22a1a20daeee10ed1d0d-cursor_p_3D10_p_26from__p_3D2021-09-01T00_p_253A00_p_253A00Z_p_26metadataPrefix_p_3Doai_dc_p_26batch_size_p_3D11_p_26until_p_3D2021-09-09T23_p_253A59_p_253A59Z</a><br><br>

    - Nach Set:<br>
    <a href="https://www.e-manuscripta.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&set=maps" target="_blank">https://www.e-manuscripta.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&set=maps</a><br><br>

- ListIdentifiers<br>
<a href="https://www.e-manuscripta.ch/oai/?verb=ListIdentifiers&metadataPrefix=oai_dc&set=emanuszuzneb" target="_blank">https://www.e-manuscripta.ch/oai/?verb=ListIdentifiers&metadataPrefix=oai_dc&set=emanuszuzneb</a><br><br>

- ListSets<br>
<a href="https://www.e-manuscripta.ch/oai?verb=ListSets" target="_blank">https://www.e-manuscripta.ch/oai?verb=ListSets</a><br><br>
mit Resumption Token:<br>
<a href="https://www.e-manuscripta.ch/oai?verb=ListSets&resumptionToken=cursor_p_3D10_p_26batch_size_p_3D11" target="_blank">https://www.e-manuscripta.ch/oai?verb=ListSets&resumptionToken=cursor_p_3D10_p_26batch_size_p_3D11</a><br><br>

- ListMetadataFormats<br>
[https://www.e-manuscripta.ch/oai?verb=ListMetadataFormats](https://www.e-manuscripta.ch/oai?verb=ListMetadataFormats)


### e-manuscripta Volltexte

Transkribierte Volltexte sind im OAI-Record im METS-Format im mets:fileGrp-Element: 

    <mets:fileGrp USE="FULLTEXT"> 
    
Beispiel-Ausschnitt aus dem OAI-Record: <br> 
<a href="https://www.e-manuscripta.ch/oai?verb=GetRecord&metadataPrefix=mets&identifier=1831287" target="_blank">https://www.e-manuscripta.ch/oai?verb=GetRecord&metadataPrefix=mets&identifier=1831287</a>:

    <mets:fileGrp USE="FULLTEXT">
        <mets:file MIMETYPE="text/markdown" CREATED="2020-02-24T09:55:44.821000Z" ID="TR1831288">
            <mets:FLocat xlink:href="https://www.e-manuscripta.ch/zuz/download/fulltext/raw/1831288" LOCTYPE="URL"/>
        </mets:file>
        <mets:file MIMETYPE="text/html" CREATED="2020-02-24T09:55:44.821000Z" ID="HTML1831288">
            <mets:FLocat xlink:href="https://www.e-manuscripta.ch/zuz/download/fulltext/html/1831288" LOCTYPE="URL"/>
        </mets:file>
    </mets:fileGrp>

Die beiden in mets:fileGrp verschachtelten Kind-Elemente mets:Flocat enthalten je einen Link zum Volltext - einmal in HTML und einmal in Markdown:<br/>
<a href="https://www.e-manuscripta.ch/zuz/download/fulltext/html/1831288" target="_blank">https://www.e-manuscripta.ch/zuz/download/fulltext/html/1831288</a><br>
<a href="https://www.e-manuscripta.ch/zuz/download/fulltext/raw/1831288" target="_blank">https://www.e-manuscripta.ch/zuz/download/fulltext/raw/1831288</a><br><br>