(datum poslední změny: 19.08.2020 11:49)
2020-08-18 |
Přidán nový výstup obálek titulů služby DNNT dostupných v Národní digitální knihovně NK ČR. |
2019-01-31 |
Do výstupu obálek, ... přidáno hodnocení titulů - parametry cached_rating_sum a cached_rating_count. (cached_rating_sum/cached_rating_count = procentní hodnocení titulu). |
2018-12-18 |
Možnost stažení nového výstupu - PHP pole s identifikátory dokumentů a ID obálky. Výrazně urychlí zjištění ID cover pro hromadné dotazy pomocí skriptů (např. generování seznamů novinek). |
Exporty z databáze projektu obálkyknih.cz pro hromadné importy dat do knihovních systémů či generování seznamů novinek, přehledů apod.
Výstupy jsou generovány 1x denně v noci a poskytovány ve formátu XML (UTF-8 kódování).
Jako volitelný parametr při volání skriptu lze použít parametr last_change.
Příklad: https://servis.obalkyknih.cz/export/okcz_annotation.php?last_change=2021-01-01
Výstup vrací poté pouze záznamy změněné či vytvořené po tomto datu (včetně uvedeného data). Formát datumu je dle vzoru YYYY-MM-DD. Výstupy jsou generovány online a tudíž trvají delší dobu (10-30s). Z důvodu zabránění zahlcení serveru jsou vypisovány záznamy změněné maximálně za poslední rok. Doporučujeme nastavit pravidelné stahováni - např. po týdnu - a raději v nočních hodinách.
Z výstupu pomocí hodnot cover_id, toc_id a bib_id lze vygenerovat URL k příslušným souborům dle vzoru:
https://server <cache1|cache2>.obalkyknih.cz/file/typ objektu <cover|toc|bib>/id <cover_id |toc_id|bib_id>/velikost náhledu či typ souboru <pdf|thumbnail|icon|medium|preview510>
Hodnoty cover_id, toc_id a bib_id se při aktualizacích záznamů mění. !!! XML exporty neslouží pro trvalé propojení knihovních záznamů se záznamy projektu obalkyknih.cz !!! Pro běžný provoz použijte funkce popsané v API projektu.
Příklady:
Ukázkové náhledy jsou dostupné jen v případě platné registrace URL nebo IP adresy pro konkrétní knihovnu. Více informací v API projektu.
Stahovat XML soubory je umožněno pouze registracím s právem k stahování příslušných dat (běžné registrace tuto možnost nemají).
Zájemci o stahování prosím kontaktujte správce projektu admin@obalkyknih.cz. Na stejný email posílejte i připomínky, návrhy na změny či zjištěné chyby.
Příklad stažení XML souboru:
wget -O okcz-annotation.xml --http-user=xxx@xxx.cz --http-passwd=xxx https://servis.obalkyknih.cz/export/okcz_annotation.php
obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
book ... sekce konkrétního titulu
bibinfo ... sekce s identifikátory titulu
ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
oclc ... OCoLC
cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
book_id ... ID záznamu na serveru obalkyknih.cz
book_metadata_change ... datum poslední změny záznamu
cover_id ... id obálky
toc_id ... id obsahu
bib_id ... id seznamu literatury
cached_rating_sum ... suma hodnocení titulu
cached_rating_count ... počet hodnocení titulu
<?xml version="1.0" encoding="UTF-8"?> <obalkyknih date="2021-01-28 00:01:01" last_change="all"> <book> <bibinfo> <ean13>9788090333383</ean13> <cnb>cnb001581391</cnb> <oclc>(OCoLC)63296281</oclc> </bibinfo> <book_id>110000002</book_id> <book_metadata_change>2018-04-18 16:10:17</book_metadata_change> <cover_id>2</cover_id> <toc_id>120596</toc_id> <bib_id>23456</bib_id> <cached_rating_sum>120</cached_rating_sum> <cached_rating_count>2</cached_rating_count> </book> <book> ... </book> </obalkyknih>
obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
book ... sekce konkrétního titulu
bibinfo ... sekce s identifikátory titulu
ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
oclc ... OCoLC
cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
book_id ... ID záznamu na serveru obalkyknih.cz
book_metadata_change ... datum poslední změny anotace
annotation ... vlastní anotace
<?xml version="1.0" encoding="UTF-8"?> <obalkyknih date="2021-01-28 00:01:01" last_change="all"> <book> <bibinfo> <ean13>9788024730479</ean13> <oclc>(OCoLC)428366326</oclc> </bibinfo> <book_id>110270750</book_id> <book_metadata_change>2018-02-12 07:08:25</book_metadata_change> <annotation>Cílem publikace je představit čtenářům charakteristiku open-source software a otevřených formátů. ...</annotation> </book> <book> ... </book> </obalkyknih>
obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
book ... sekce konkrétního titulu
bibinfo ... sekce s identifikátory titulu
ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
oclc ... OCoLC
cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
book_id ... ID záznamu na serveru obalkyknih.cz
book_metadata_change ... datum poslední změny anotace
toc ... vlastní text obsahu zpracovaný OCR
<?xml version="1.0" encoding="UTF-8"?> <obalkyknih date="2021-01-28 00:01:01" last_change="all"> <book> <bibinfo> <ean13>9788023946604</ean13> <oclc>(OCoLC)85543420</oclc> <cnb>cnb001527995</cnb> </bibinfo> <book_id>110256461</book_id> <book_metadata_change>2009-10-17 17:48:40</book_metadata_change> <toc>Ždánický les a Povltaví\r\nObsah\r\nÚvodní slovo (Ing. Jiří Slabotinský, CSc.) ...</toc> </book> <book> ... </book> </obalkyknih>
Export identifikátorů (ISBN, ISSN, ISMN, EAN, OCLC, č. ČNB, vlastní identifikátor) s parametrem cover_id (ID obálky titulu v projektu obalkyknih.cz). Export je ve formátu asociativního pole pro zpracování pomocí PHP. ISBN, ISSN a EAN je uvedeno v 13-ti místném tvaru.
Ukázku PHP funkce pro převod do tohoto formátu naleznete zde.
Výstup vznikl pro potřeby naší knihovny pravidelně generovat seznamy náhledů obálek jednotlivých druhů dokumentů (knihy, DVD, CD, e-knihy, periodika, hry, ...). Ukázka "reklamního systému" v našem katalogu. Dotazy přes klasické API projektu obalkyknih.cz trvalo u cca. 500 tisíc dokumentů 2-3 hodiny. Dotaz na stejný počet dokumentů pomocí asociativního pole trvá pouhých 20-30 vteřin.
"KLÍČ:identifikátor" => "HODNOTA:cover_id",
$identokcz=array( "9788090333383" => "2", "9788071785453" => "13", "9788024407210" => "18", "9788071785132" => "21", "(OCoLC)977969365" => "1912265", "(OCoLC)978015693" => "1667917", "(OCoLC)978253247" => "1675105", "(OCoLC)978261032" => "1685055", "cnb001801833" => "652552", "cnb001802620" => "652559", "cnb001801228" => "652563", "cnb001807474" => "652565", "cba001-0075434" => "653231", );
Export ID obálky titulu v projektu obalkyknih.cz obálky v systému OKCZ a uuid titulu v systému DNNT Národní digitální knihovny NK ČR. Export je ve formátu asociativního pole pro zpracování pomocí PHP.
Výstup vznikl pro potřeby naší knihovny generovat náhodně seznamy ukázek a pro zobrazení náhledů obálek vybraných titulu sluzby DNNT - viz ukázka.
"ID obálky" => "HODNOTA:uuid",
"59128" => "uuid:28714680-6c72-11e2-bb2a-005056827e51", "255870" => "uuid:cda69520-2d56-11e2-a8e5-005056827e52", "269698" => "uuid:07e48b90-510d-11e3-ae59-005056827e52", "280910" => "uuid:b48d5ad0-882f-11e3-bd09-005056827e51", );