Naposledy změněno Martin Mahr 2024/10/21 22:17

Hide last authors
Jan Šimeček 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
Jan Šimeček 2.1 10 |
Jan Šimeček 1.1 11
12 {{{OAI_PROVIDER_REPOSITORY_NAME}}}|Název repozitáře, který se zobrazuje v identifikačních údajích OAI provideru.
13
Jan Šimeček 2.1 14 |(% colspan="1" %)
Jan Šimeček 1.1 15
Jan Šimeček 2.1 16 {{{OAI_PROVIDER_ADMIN_EMAIL}}}|
17
Jan Šimeček 1.1 18 {{{Kontaktní email na administrátora, který se zobrazuje v identifikačních údajích OAI provideru.}}}
19
Jan Šimeček 2.1 20 |(% colspan="1" %)
Jan Šimeček 1.1 21
Jan Šimeček 2.1 22 {{{OAI_PROVIDER_BASE_URL}}}|
23
Jan Šimeček 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
Jan Šimeček 2.1 26 |(% colspan="1" %)
Jan Šimeček 1.1 27
Jan Šimeček 2.1 28 {{{OAI_PROVIDER_DOMAIN}}}|
29
Jan Šimeček 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
Jan Šimeček 2.1 75 |
Jan Šimeček 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
Jan Šimeček 2.1 117 |
Jan Šimeček 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
Jan Šimeček 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]]
Jan Šimeček 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
Jan Šimeček 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]].
Jan Šimeček 1.1 150
151 = Knihovny =
152
153