OAI-MPH Provider (Souborný katalog SKC, Knihovny.cz)

Last modified by Martin Mahr on 2024/10/21 22:17

Důležité změny OAI provideru

26.8.2019 - Došlo k odstranění testovacích NKP setů.
27.8.2019 - Opravena chyba exportu víceřádkových polí 520
8.10.2020 - Přidány stavy PARTIALLY_DELIVERED a ADDITIONAL_ORDER_REQUEST

Nastavení OAI v Tritiu

Položka nastavení	Popis

OAI_PROVIDER_REPOSITORY_NAME|Název repozitáře, který se zobrazuje v identifikačních údajích OAI provideru.

OAI_PROVIDER_ADMIN_EMAIL|

Kontaktní email na administrátora, který se zobrazuje v identifikačních údajích OAI provideru.

OAI_PROVIDER_BASE_URL|

Základní URL OAI provideru, která se zobrazuje v identifikačních údajích. Pokud je prázdná, generuje se automaticky.

OAI_PROVIDER_DOMAIN|

Doména pro OAI identifikátory. Doména se používá v identifikátoru díla.

	NKP	Palmknihy
Název setu	NKP_<ID knihovny z Tritia>	PLM
Celý název	SK ČR	Palmknihy
Typ setu	COMMON - žádné speciální chování NATIONAL_LIBRARY_CZE - několik speciálních úprav pro SKC ( např. využití štítku N - Neodesílat )	COMMON
Stavy díla		;HARVESTED;
Podmínka	item.library_owner=<id knihovny> AND work.work_type in (-1) svazky vlastnící danou knihovnou typ dokumentu kniha	harvested_source=-3
Regulární výraz	[0-9]{3}[^9]{1}\|9.* (?!562)(?!563)(?!773)(?!774)[0-9]{3}[^9]{1} Vyloučení např. pole 910N: [0-8]{3}[^9]{1}\|9[0-9]{2}[^N] omezuje pole a podpole, které se mají exportovat je možnost zakázání/povolení exportování pole 993 se svazky.	(?!997)(001\|005\|856).{1}
Generovat NKP	Zapnout (zajistí že budou generována povinná pole 040 a 910)	NE
Vlastní sigla
Způsob získání sigly		Z definice knihovny

Příklady URL, které se posílají do NK a také se přes tyto odkazy může kontrolovat funkčnost OAI setů.

Podmínka OAI

Dříve OAI podmínka mohla obsahovat části, které zamezovaly zobrazování odstraněných děl. O to se nyní stará přímo algoritmus OAI provideru.

# Špatně
item.type="COMMON" and item.active=1 and (item.write_off_list is null) and work.work_type != -8
 
# Správně
 work.work_type != -8

Dále musí díla splňovat podmíky:

Stav díla: DELIVERED, PARTIALLY_DELIVERED, ADDITIONAL_ORDER_REQUEST, REMOVED, DELETED
Datum publikace vyplněný a v daném intervalu

Poskytovaná data (SQL dotaz pro načtení dat)

Načítají se jen data ve stavu:¨

DELIVERED
PARTIALLY_DELIVERED
ADDITIONAL_ORDER_REQUEST
REMOVED
DELETED

Viz.: Publikace díla

Odstraněné záznamy

Tritius implementuje nejvyšší úroveň podpory odstraněných záznamů (persistent). Záznamy jsou v OAI setu označené jako DELETED pro danou knihovnu, pokud:

Byly odepsány všechny svazky.
Titul byl odstraněn.

Nastavení pro souborný katalog SK ČR

Chcete-li přispívat do Souborného katalogu ČR (SKČR), pak musíte použít OAI-PMH provider, který je v Tritiu vestavěný.

Nastavení OAI setů pro SKC

Po založení knihovny v systému Tritius se automaticky vytváří set "NKP". Pro přispívání by tedy mělo být vše nachystáno.

# Stará nedoporučená podmínka
work.work_type = -1 AND item.active = 1 AND item.type = 'COMMON' AND item.library_owner = 1 AND work.date_created > DATE_SUB(NOW(), INTERVAL 3 MONTH)
 
# Doporučená podmínka pro OAI
# Knihy a články
work.work_type IN (-1, -11) AND item.library_owner = 1 AND work.date_created >= '2009-01-01 00:00:00' AND work.rules = "RDA"

Metoda GetRecord aktuálně neumí vracet stav DELETED, jelikož při požadavku GetRecord není k dispozici informace o knihovně.

Chybné záznamy

Tritius automaticky označuje záznamy, které nevyhovují pravidlům SKČR štítkem "E" jako "Error".

Další chyby jsou pak vraceny ze strany SK ČR při importu více viz: Vyhledání a oprava chybných záznamů posílaných do SK ČR

Knihovny.cz - CPK

Běžný postup zapojení

Vyplnění dotazníku
Analýza kvality záznamů, zpětná vazba
1. Je potřeba dodat adresu OAI serveru a název setu pro CPK
2. Název: CPK_X (X = ID knihovny))
3. Všechny dokumenty dohledatelné v katalogu
Administrativní záležitosti
Test NCIPu

Virtuální národní fonotéka

Pomocí protokolu OAI-MPH lze přispívat i do Virtuální národní fonotéka.