(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=2020-09-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="2020-09-23 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="2020-09-23 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="2020-09-23 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",
);