Version 2.1 by Jan Šimeček on 2024/07/16 14:05

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
14 |(% colspan="1" %)
15
16 {{{OAI_PROVIDER_ADMIN_EMAIL}}}|
17
18 {{{Kontaktní email na administrátora, který se zobrazuje v identifikačních údajích OAI provideru.}}}
19
20 |(% colspan="1" %)
21
22 {{{OAI_PROVIDER_BASE_URL}}}|
23
24 {{{Základní URL OAI provideru, která se zobrazuje v identifikačních údajích. Pokud je prázdná, generuje se automaticky.}}}
25
26 |(% colspan="1" %)
27
28 {{{OAI_PROVIDER_DOMAIN}}}|
29
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
75 |
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
117 |
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
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]]
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
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]].
150
151 = Knihovny =
152
153