Version 1.1 by Jan Šimeček on 2024/07/16 14:03

Show last authors
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