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