Zdrojový kód wiki OAI-MPH Provider (Souborný katalog SKC, Knihovny.cz)
Naposledy změněno Martin Mahr 2024/10/21 22:17
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
1.1 | 1 | = Důležité změny OAI provideru = |
| 2 | |||
| 3 | * 26.8.2019 - Došlo k odstranění testovacích NKP setů. | ||
| 4 | * 27.8.2019 - Opravena chyba exportu víceřádkových polí 520 | ||
| 5 | * 8.10.2020 - Přidány stavy PARTIALLY_DELIVERED a ADDITIONAL_ORDER_REQUEST | ||
| 6 | |||
| 7 | = Nastavení OAI v Tritiu = | ||
| 8 | |||
| 9 | |=Položka nastavení|=Popis | ||
| |
2.1 | 10 | | |
| |
1.1 | 11 | |
| 12 | {{{OAI_PROVIDER_REPOSITORY_NAME}}}|Název repozitáře, který se zobrazuje v identifikačních údajích OAI provideru. | ||
| 13 | |||
| |
2.1 | 14 | |(% colspan="1" %) |
| |
1.1 | 15 | |
| |
2.1 | 16 | {{{OAI_PROVIDER_ADMIN_EMAIL}}}| |
| 17 | |||
| |
1.1 | 18 | {{{Kontaktní email na administrátora, který se zobrazuje v identifikačních údajích OAI provideru.}}} |
| 19 | |||
| |
2.1 | 20 | |(% colspan="1" %) |
| |
1.1 | 21 | |
| |
2.1 | 22 | {{{OAI_PROVIDER_BASE_URL}}}| |
| 23 | |||
| |
1.1 | 24 | {{{Základní URL OAI provideru, která se zobrazuje v identifikačních údajích. Pokud je prázdná, generuje se automaticky.}}} |
| 25 | |||
| |
2.1 | 26 | |(% colspan="1" %) |
| |
1.1 | 27 | |
| |
2.1 | 28 | {{{OAI_PROVIDER_DOMAIN}}}| |
| 29 | |||
| |
1.1 | 30 | {{{Doména pro OAI identifikátory. Doména se používá v identifikátoru díla.}}} |
| 31 | |||
| 32 | |||
| 33 | |=(% colspan="1" %) |(% colspan="1" %)**NKP**|(% colspan="1" %)**Palmknihy** | ||
| 34 | |=Název setu|NKP_<ID knihovny z Tritia>|(% colspan="1" %)PLM | ||
| 35 | |=Celý název|SK ČR|(% colspan="1" %)Palmknihy | ||
| 36 | |=(% colspan="1" %)Typ setu|(% colspan="1" %)((( | ||
| 37 | 1. COMMON - žádné speciální chování | ||
| 38 | 1. NATIONAL_LIBRARY_CZE - několik speciálních úprav pro SKC ( např. využití štítku N - Neodesílat ) | ||
| 39 | )))|(% colspan="1" %)COMMON | ||
| 40 | |=(% colspan="1" %)Stavy díla|(% colspan="1" %) |(% colspan="1" %);HARVESTED; | ||
| 41 | |=Podmínka|((( | ||
| 42 | item.library_owner=<id knihovny> AND work.work_type in (-1) | ||
| 43 | |||
| 44 | * svazky vlastnící danou knihovnou | ||
| 45 | * typ dokumentu kniha | ||
| 46 | )))|(% colspan="1" %)harvested_source=-3 | ||
| 47 | |=(% colspan="1" %)Regulární výraz|(% colspan="1" %)((( | ||
| 48 | [0-9]{3}[^9]{1}|9.* | ||
| 49 | |||
| 50 | |||
| 51 | (?!562)(?!563)(?!773)(?!774)[0-9]{3}[^9]{1} | ||
| 52 | Vyloučení např. pole 910N: [0-8]{3}[^9]{1}|9[0-9]{2}[^N] | ||
| 53 | |||
| 54 | |||
| 55 | * omezuje pole a podpole, které se mají exportovat | ||
| 56 | * je možnost zakázání/povolení exportování pole 993 se svazky. | ||
| 57 | )))|(% colspan="1" %)(?!997)(001~|005~|856).{1} | ||
| 58 | |=(% colspan="1" %)Generovat NKP|(% colspan="1" %)Zapnout (zajistí že budou generována povinná pole 040 a 910)|(% colspan="1" %)NE | ||
| 59 | |=(% colspan="1" %)Vlastní sigla|(% colspan="1" %) |(% colspan="1" %) | ||
| 60 | |=(% colspan="1" %)Způsob získání sigly|(% colspan="1" %) |(% colspan="1" %)Z definice knihovny | ||
| 61 | |||
| 62 | Příklady URL, které se posílají do NK a také se přes tyto odkazy může kontrolovat funkčnost OAI setů. | ||
| 63 | |||
| 64 | * [[https:~~/~~/demo.tritius.cz/tritius/oai-provider?verb=ListRecords&from=2018-01-01&until=2018-05-01&metadataPrefix=marc21&set=NKP_1>>url:https://demo.tritius.cz/tritius/oai-provider?verb=ListRecords&from=2018-01-01&until=2018-05-01&metadataPrefix=marc21&set=NKP_1]] | ||
| 65 | * [[https:~~/~~/demo.tritius.cz/tritius/oai-provider?verb=ListRecords&from=2018-01-01&until=2018-05-01&metadataPrefix>>url:https://demo.tritius.cz/tritius/oai-provider?verb=ListRecords&from=2018-01-01&until=2018-05-01&metadataPrefix=marc21&set=NKP_1]][[=marc21&set=NKP_1>>url:https://demo.tritius.cz/tritius/oai-provider?verb=ListRecords&from=2018-01-01&until=2018-05-01&metadataPrefix=marc21&set=NKP_1]] | ||
| 66 | * [[https:~~/~~/jaromer.tritius.cz/tritius/oai-provider?verb=ListRecords&resumptionToken=38772dea-d87b-4d95-a273-4cd84dbd8b08>>url:https://jaromer.tritius.cz/tritius/oai-provider?verb=ListRecords&resumptionToken=38772dea-d87b-4d95-a273-4cd84dbd8b08]] | ||
| 67 | * [[https:~~/~~/demo.tritius.cz/tritius/oai-provider?verb=GetRecord&metadataPrefix=marc21&identifier=280427>>url:https://demo.tritius.cz/tritius/oai-provider?verb=GetRecord&metadataPrefix=marc21&identifier=280427]] | ||
| 68 | ResumptionToken: | ||
| 69 | [[https:~~/~~/iispp.npu.cz/dftest/oai-provider?verb=ListRecords&resumptionToken=9385c541-5eb7-4f10-a5c6-4857e5894943>>url:https://iispp.npu.cz/dftest/oai-provider?verb=ListRecords&resumptionToken=9385c541-5eb7-4f10-a5c6-4857e5894943]] | ||
| 70 | |||
| 71 | == Podmínka OAI == | ||
| 72 | |||
| 73 | 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. | ||
| 74 | |||
| |
2.1 | 75 | | |
| |
1.1 | 76 | |
| 77 | {{{# Špatně | ||
| 78 | item.type="COMMON" and item.active=1 and (item.write_off_list is null) and work.work_type != -8 | ||
| 79 | |||
| 80 | # Správně | ||
| 81 | work.work_type != -8}}} | ||
| 82 | |||
| 83 | |||
| 84 | Dále musí díla splňovat podmíky: | ||
| 85 | |||
| 86 | * Stav díla: DELIVERED, PARTIALLY_DELIVERED, ADDITIONAL_ORDER_REQUEST, REMOVED, DELETED | ||
| 87 | * Datum publikace vyplněný a v daném intervalu | ||
| 88 | |||
| 89 | = Poskytovaná data (SQL dotaz pro načtení dat) = | ||
| 90 | |||
| 91 | Načítají se jen data ve stavu:¨ | ||
| 92 | |||
| 93 | * DELIVERED | ||
| 94 | * PARTIALLY_DELIVERED | ||
| 95 | * ADDITIONAL_ORDER_REQUEST | ||
| 96 | * REMOVED | ||
| 97 | * DELETED | ||
| 98 | |||
| 99 | Viz.: [[Publikace díla>>doc:uzivatelsky-manual.Pro-spravce.Publikace-dila.WebHome]] | ||
| 100 | |||
| 101 | = Odstraněné záznamy = | ||
| 102 | |||
| 103 | 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: | ||
| 104 | |||
| 105 | * Byly odepsány všechny svazky. | ||
| 106 | * Titul byl odstraněn. | ||
| 107 | |||
| 108 | = Nastavení pro souborný katalog SK ČR = | ||
| 109 | |||
| 110 | Chcete-li přispívat do [[Souborného katalogu ČR>>url:http://www.caslin.cz/]] (SKČR), pak musíte použít OAI-PMH provider, který je v Tritiu vestavěný. | ||
| 111 | |||
| 112 | == Nastavení OAI setů pro SKC == | ||
| 113 | |||
| 114 | 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. | ||
| 115 | |||
| 116 | |||
| |
2.1 | 117 | | |
| |
1.1 | 118 | |
| 119 | {{{# Stará nedoporučená podmínka | ||
| 120 | 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) | ||
| 121 | |||
| 122 | # Doporučená podmínka pro OAI | ||
| 123 | # Knihy a články | ||
| 124 | 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"}}} | ||
| 125 | |||
| 126 | |||
| 127 | |Metoda GetRecord aktuálně neumí vracet stav DELETED, jelikož při požadavku GetRecord není k dispozici informace o knihovně. | ||
| 128 | |||
| 129 | == Chybné záznamy == | ||
| 130 | |||
| 131 | Tritius automaticky označuje záznamy, které nevyhovují pravidlům SKČR štítkem "E" jako "Error". | ||
| 132 | |||
| |
2.1 | 133 | 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>>doc:uzivatelsky-manual.obecne.Vyhledani-a-oprava-chybnych-zaznamu-posilanych-do-SK-CR.WebHome]] |
| |
1.1 | 134 | |
| 135 | = Knihovny.cz - CPK = | ||
| 136 | |||
| 137 | Běžný postup zapojení | ||
| 138 | |||
| 139 | 1. Vyplnění dotazníku | ||
| 140 | 1. Analýza kvality záznamů, zpětná vazba | ||
| 141 | 11. Je potřeba dodat adresu OAI serveru a název setu pro CPK | ||
| 142 | 11. Název: CPK_X //(X = ID knihovny)//) | ||
| 143 | 11. Všechny dokumenty dohledatelné v katalogu | ||
| 144 | 1. Administrativní záležitosti | ||
| 145 | 1. Test NCIPu | ||
| 146 | |||
| 147 | = Virtuální národní fonotéka = | ||
| 148 | |||
| |
2.1 | 149 | Pomocí protokolu OAI-MPH lze přispívat i do [[Virtuální národní fonotéka>>doc:uzivatelsky-manual.Pro-spravce.Virtualni-narodni-fonoteka.WebHome]]. |
| |
1.1 | 150 | |
| 151 | = Knihovny = | ||
| 152 | |||
| 153 |