Uživatelské nástroje

Nástroje pro tento web


katalogizace:oai-pmh_-_sklizeni_do_souborneho_katalogu

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze
Předchozí verze
katalogizace:oai-pmh_-_sklizeni_do_souborneho_katalogu [2019/01/06 20:53] – [Šablona XSLT] ecekatalogizace:oai-pmh_-_sklizeni_do_souborneho_katalogu [2023/01/19 14:23] (aktuální) – [Sklízení záznamů do souborného katalogu pomocí protokolu OAI-PMH.] ece
Řádek 1: Řádek 1:
-====== Sklízení záznamů do souborného katalogu pomocí protokolu OAI-PMH. ====== +====== Sklízení záznamů Evergreenu do Souborného katalogu ČR pomocí protokolu OAI-PMH. ====== 
-Na dokumentaci se pracuje+
  
  
Řádek 6: Řádek 6:
  
  
-[[https://www.caslin.cz/caslin/spoluprace/jak-prispivat-do-sk-cr/dodavani-dat/vyuziti-protokolu-oai-pmh|Informace o využití protokolu OAI-PMH pro sklízení do Souborného katalogu ČR +[[https://www.caslin.cz/caslin/spoluprace/jak-prispivat-do-sk-cr/dodavani-dat/vyuziti-protokolu-oai-pmh|Informace o využití protokolu OAI-PMH pro sklízení]] na stránkách Souborného katalogu
-]]+
  
  
  
 ===== OAI-PMH v Evergreenu ===== ===== OAI-PMH v Evergreenu =====
-Informace k [[https://github.com/IISH/Evergreen/blob/iish_master_rel_3_0_1/OAI2.md|obecné implemetaci OAI-PMH v Evergreenu]]+Informace k [[https://github.com/IISH/Evergreen/blob/iish_master_rel_3_0_1/OAI2.md|obecné implementaci OAI-PMH v Evergreenu]]
  
 +Při použití novější verze Perlu je třeba v souboru /usr/local/share/perl/<verze Perlu>/OpenILS/WWW/OAI.pm((Viz Informace k obecné implementaci OAI-PMH v Evergreenu.)) provést následující úpravu:
  
 +  * řádek 234 změnit na: \\ // %%foreach my $metadataPrefix (keys %{ $oai_metadataformats }) { %% //
 +  * řádek 253 změnit na: \\ // %%foreach my $key (keys %{ $oai_sets }) {%% //
  
  
-===== Nastavení OAI-PMH modulu pro sklízení záznamů ze souborného katalogu =====+===== Nastavení OAI-PMH modulu pro sklízení záznamů z Evergreenu do souborného katalogu =====
  
 ==== Definice záznamů pro sklízení ==== ==== Definice záznamů pro sklízení ====
  
-Aktuálně v Evergreenu nejsou k dispozici sety. Pro vyloučení záznamů, které se nemají dostat do Souborného katalogu v rámci sklizně, je používáno interní pole MARC $995, které pomocí XSLT šablony potlačí metadata těch záznamů, které se sklízet nemají. Výsledný výstup tudíž  obsahuje všechny identifikátory a časová razítka záznamů, které byly do katalogu přidány nebo byly aktualizovány v daném období,  neobsahuje však  žádná metadata těchto „nesklízených“ záznamů. +Aktuálně v Evergreenu nejsou k dispozici sety. Pro vyloučení záznamů, které se nemají dostat do Souborného katalogu v rámci sklizně, je používáno interní pole MARC $995, které pomocí XSLT šablony potlačí metadata těch záznamů, které se sklízet nemají. Výsledný výstup tudíž  obsahuje všechny identifikátory a časová razítka záznamů, které byly do katalogu Evergreenu přidány nebo byly aktualizovány v daném období,  neobsahuje však  žádná metadata těchto „nesklízených“ záznamů. 
  
 V praxi pak ve sklizeném souboru vypadá „nesklízený“ záznam  např. takto: V praxi pak ve sklizeném souboru vypadá „nesklízený“ záznam  např. takto:
Řádek 34: Řádek 36:
 </code> </code>
  
-==== Šablona XSLT ==== +==== Šablona XSLT pro zpracování OAI-PMH výstupu pro sklizeň ====
-{{ :katalogizace:oai2_sk.zip |}}+
  
-Šablonu rozbalte a nahrajte do adresáře /openils/var/xsl+<file xsl oai_skc.xsl> 
 +<xsl:stylesheet version="1.0" 
 +                xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
 +                xmlns:marc="http://www.loc.gov/MARC21/slim">
  
 +    <xsl:output omit-xml-declaration="yes"/>
 +
 +    <xsl:template match="node()|@*">
 +        <xsl:copy>
 +            <xsl:apply-templates select="node()|@*"/>
 +        </xsl:copy>
 +    </xsl:template>
 +
 +    <xsl:template match="*">
 +        <xsl:element name="marc:{name()}" namespace="http://www.loc.gov/MARC21/slim">
 +            <xsl:copy-of select="namespace::*"/>
 +            <xsl:apply-templates select="node()|@*"/>
 +        </xsl:element>
 +    </xsl:template>
 +    
 +    <xsl:template match="marc:datafield[@tag='901' or @tag='990']"/>
 +    <xsl:template match="marc:datafield[@tag='100' or @tag='110' or @tag='111' or @tag='700' or @tag='710' or @tag='711']/marc:subfield[@code='0']"/>
 +    <xsl:template match="marc:datafield[@tag='856']/marc:subfield[@code='9']"/>
 +    <xsl:template match="marc:datafield[@tag='910' and marc:subfield!='Sigla1' and marc:subfield!='Sigla2' and marc:subfield!='Sigla3' and marc:subfield!='Sigla4']"/>
 +    <xsl:template match="marc:record[count(marc:datafield[@tag='995'])=0]"/>
 +    <xsl:template match="marc:record[marc:datafield[@tag='995']/marc:subfield!='ska']"/>
 +    <xsl:template match="marc:datafield[@tag='995']"/>
 +</xsl:stylesheet>
 +
 +</file>
 +
 +Šablonu nahrajte do adresáře /openils/var/xsl. V šabloně je potřeba upravit siglu/sigly přispívajících knihoven na řádku 23.
  
 Zpracování výstupu pro sklizeň pomocí šablony XSLT obsahuje mj.: Zpracování výstupu pro sklizeň pomocí šablony XSLT obsahuje mj.:
-  - smazání  polí, která se nemají dostat do souborného katalou ($901 a $990  - viz řádek 20), +  - smazání  polí, která se nemají dostat do Souborného katalogu (viz řádek 20)  
-  - smazání podpolí, která se nemají dostat do souborného katalogu (podpole "0", které v Evergreenu propojuje bibliografický záznam s autoritním záznamem - viz řádek 21), +    * 901 a 990 
-  - definici sigly/sigel knihoven, jejichž záznamy se mají z evergreenového katalogu sklidit do Souborného katalogu (viz řádek 22), +  - smazání podpolí, která se nemají dostat do Souborného katalogu 
-  - definici pole a jeho obsahu, na základě které budou do sklizně zařazeny záznamy, které toto pole a zadanou hodnotu obsahují (v šabloně je takto použito pole $995 a hodnota "ska" pro zařazení do sklizně((použité pole i hodnotu lze v šabloně definovat i jinak)) - viz řádky 23 25).+    *  podpole $v polích 1XX  a 7XX, které v Evergreenu propojuje bibliografický záznam s autoritním záznamem - viz řádek 21,  
 +    * podpole $9  v poli 856, které Evergreen používá pro určení knihoven,v nichž se má v katalogu zobrazit elektronický zdroj bez připojených fyzických exemplářů - viz řádek 22), 
 +  - definici sigly/sigel knihoven, jejichž záznamy se mají z evergreenového katalogu sklidit do Souborného katalogu (viz řádek 23), 
 +  - definici pole a jeho obsahu, na základě které budou do sklizně zařazeny záznamy, které toto pole a zadanou hodnotu obsahují (v šabloně je takto použito pole 995 a hodnota "ska" pro zařazení do sklizně((použité pole i hodnotu lze v šabloně definovat i jinak)) - viz řádky 24 26).
  
 ==== Nastavení OAI-PMH v opensrf.xml ==== ==== Nastavení OAI-PMH v opensrf.xml ====
Řádek 50: Řádek 84:
 Parametry pro OAI-PMH je potřeba nastavit také v konfiguračním souboru  Parametry pro OAI-PMH je potřeba nastavit také v konfiguračním souboru 
 //**/openils/conf/opensrf.xml**// //**/openils/conf/opensrf.xml**//
 +
 Pro sklízení záznamů do Souborného katalogu ČR je v sekci **//<open-ils.oai>//**  nutné mj.: Pro sklízení záznamů do Souborného katalogu ČR je v sekci **//<open-ils.oai>//**  nutné mj.:
   * nastavit metadatový prefix **//"marc21"//**;    * nastavit metadatový prefix **//"marc21"//**; 
   * definovat, zda se do sklizně má dostat také informace o smazaných záznamech (viz dále).   * definovat, zda se do sklizně má dostat také informace o smazaných záznamech (viz dále).
  
-Příklad nastavení parametrů pro OAI-PMH ve Společném katalogu Evergreen (SPOK)+Příklad nastavení parametrů pro OAI-PMH ve Společném katalogu Evergreen (SPOK):
 <code> <code>
 <open-ils.oai> <open-ils.oai>
Řádek 111: Řádek 146:
  
 ==== Nastavení triggerů pro zaznamenání změn exemplářů==== ==== Nastavení triggerů pro zaznamenání změn exemplářů====
-Při sklízení záznamů do Souborného katalogu je využíváno časové razítko  vytvoření/editace záznamu, tj. trigery pro reflektování změn týkajících se půjčování a vracení exemlářů jsou vypnuté (viz kapitola 2.3.2 Optional, setting the datestamp v anglické dokumentaci k OAI-PMH). +Při sklízení záznamů do Souborného katalogu je využíváno časové razítko  vytvoření/editace záznamu, tj. trigery pro reflektování změn týkajících se půjčování a vracení exemlářů jsou vypnuté (viz kapitola 2.3.2 //Optional, setting the datestamp// v anglické dokumentaci k OAI-PMH). 
  
  
Řádek 133: Řádek 168:
 ==== Společné sklízení katalogu ==== ==== Společné sklízení katalogu ====
  
-Společné zasílání za celý katalog je nutné předem dohodnout s oddělením Souborných katalogů v NK je nutné nahlásit sigly všech přispívajících knihoven. V případě, že jednotlivé knihovny používají vlastní adresu rozhraní OPACu  Evergrenu, je nutné k jednotlivým siglám připojit také URL pro prolinkování do lokální báze jednotlivých knihoven.+Společné zasílání za celý katalog je nutné předem dohodnout s oddělením Souborných katalogů v NK. Zároveň je nutné nahlásit sigly všech přispívajících knihoven. V případě, že jednotlivé knihovny používají vlastní adresu rozhraní OPACu  Evergrenu, je nutné k jednotlivým siglám připojit také URL pro link záznamu v SK do lokální báze jednotlivých knihoven.
  
  
-==== Definice knihoven, jejichž záznamy se mají sklízet do Souborného katalogu ====+==== Definování knihoven, jejichž záznamy se mají sklízet do Souborného katalogu ====
 Sigly všech knihoven, které se mají sklízet, musí být uvedeny v XSLT šabloně (v řádku 22). Pokud sigla knihovny v XSLT šabloně uvedena není, tato knihovna se ve sklizni neobjeví. Sigly všech knihoven, které se mají sklízet, musí být uvedeny v XSLT šabloně (v řádku 22). Pokud sigla knihovny v XSLT šabloně uvedena není, tato knihovna se ve sklizni neobjeví.
  
 ==== Smazané záznamy ve společných katalozích ==== ==== Smazané záznamy ve společných katalozích ====
  
-V případě, že jsou do Souborného katalogu najednou sklízeny záznamy více knihoven, nelze zajistit, že bude sigla odstraněna v případě, že bude záznam smazán pouze v jedné knihovně ((u záznamů se statusem "deleted" nejsou uváděna žádná metadata, tj. tudiž není uvedena ani sigla)). Záznam je proto ze souborného katalogu odstraněn pouze v případě, že k němu již neexistují exempláře v žádné evergreenové knihovně a záznamy byl z Evergreenu zcela smazán. +V případě, že jsou do Souborného katalogu najednou sklízeny záznamy více knihoven, nelze zajistit, že bude sigla odstraněna v případě, že bude záznam smazán pouze v jedné knihovně ((u záznamů se statusem "deleted" nejsou uváděna žádná metadata,  tudíž nemůže být uvedena ani sigla knihovny)). Záznam je proto ze souborného katalogu odstraněn pouze v případě, že k němu již neexistují exempláře v žádné evergreenové knihovně a záznamy byl z Evergreenu zcela smazán ((Automatické smazání záznamu při smazání poslední jednotky lze nastavit v menu //Administrace > Lokální administrace > Nastavení knihovny//Lze zde také nastavit smazání záznamu v případě, že je v  akvizici smazána poslední požadovaná jednotka v objednávce nebo akvizičním seznamu.)) 
-V případě, že je ve společném katalogu využíváno odstranění smazaných záznamů ze Souborného  katalogu, je nutné nahlásit oddělení Souborných katalogů všechny sigly, které se mají smazat ze SK v případě, že má záznam při sklizni status "deleted".+ 
 +V případě, že chcete ve společném katalogu využívat odstranění smazaných záznamů ze Souborného  katalogu pomocí OAI-PMH, je nutné nahlásit oddělení Souborných katalogů všechny sigly, které se mají smazat ze SK v případě, že má záznam při sklizni status "deleted".
  
  
Řádek 151: Řádek 187:
 ===== Možnost dávkového přispívání do Souborného katalogu ČR ===== ===== Možnost dávkového přispívání do Souborného katalogu ČR =====
  
-Dávkové přispívání do souborného katalogu se v současné době v žádné knihovně nepoužívá, v případě zájmu je k dispozici starší [[knihovna_jabok:prispivani_do_skc|dokumentace k dávkovému přispívání do Souborného katalogu ČR]]+Dávkové přispívání do souborného katalogu se v současné době v žádné evergreenové knihovně nepoužívá. V případě zájmu je k dispozici starší [[knihovna_jabok:prispivani_do_skc|dokumentace k dávkovému přispívání do Souborného katalogu ČR]] 
 + 
 +===== Projekt VISK 3 ===== 
 ^Technické řešení a metodická doporučení byla vytvořena a rámci projektu Podpora sklízení záznamů prostřednictvím protokolu OAI-PMH z otevřeného knihovního softwaru Evergreen a zvýšení mobility služeb v Knihovně Jabok podpořeného z dotace[[ https://visk.nkp.cz/visk-3-informacni-centra-verejnych-knihoven-icekni|VISK3 2018]]^ ^Technické řešení a metodická doporučení byla vytvořena a rámci projektu Podpora sklízení záznamů prostřednictvím protokolu OAI-PMH z otevřeného knihovního softwaru Evergreen a zvýšení mobility služeb v Knihovně Jabok podpořeného z dotace[[ https://visk.nkp.cz/visk-3-informacni-centra-verejnych-knihoven-icekni|VISK3 2018]]^
/var/www/eg-wiki.osvobozena-knihovna.cz/data/attic/katalogizace/oai-pmh_-_sklizeni_do_souborneho_katalogu.1546804415.txt.gz · Poslední úprava: 2019/01/06 20:53 autor: ece