(datum poslední změny: 20.05.2025 20:50)
|
2022-06-20 |
Přidán nový výstup dokumentů volně přístupných a online dostupných děl z digitálních knihoven (DNNTO) v rámci služby DNNT. |
|
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.
Statické exporty jsou generovány 1x denně v noci a poskytovány ve formátu souborů XML (UTF-8 kódování).
Při volání některých skriptů (anotace, ocr_obsahy) lze použít parametr last_change pro výstup posledních záznamů.
Příklad: https://servis.obalkyknih.cz/export/okcz_annotation.php?last_change=2025-07-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.
U OCR obsahů je kompletní export databáze rozdělen po 100 000 záznamech na jeden exportní soubor. Dat je příliš mnoho ...
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
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="2025-07-12 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="2025-07-12 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="2025-07-12 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 popisných dat, anotací, fulltext obsahů dokumentů volně přístupných a online dostupných děl z digitálních knihoven (DNNTO) - po přihlášení čtenáře pomocí systému eduID. Data dostupná v rámci služby DNNT
Export je dostupný ve formátu XML. Výstup vznikl pro potřeby importu dokumentů do katalogů knihovnen.
Data pochází z databáze projektu obálkyknih.cz a systému SDDNT - Seznam děl nedostupných na trhu.
obalkyknih
record ... sekce konkrétního titulu
okcz ... sekce s data projektu obálkyknih.cz
id_book ... id titulu
modified ... poslední změna záznamu
id_cover ...id obálky na serveru obálkyknih.cz
id_toc ...id obsahu na serveru obálkyknih.cz
id_marc ...id marc záznamu na serveru obálkyknih.cz
ident ... sekce s identifikátory
uuid ... uuid titulu
ean13 ... ISBN
nbn ... číslo čnb
issn ... ISSN
oclc ... oclc
book ... sekce s popisným daty titulu
nazev ... název titulu
autor ... autor titulu
autor_id ... id autority v systému národních autorit
jazyk ... jazyk dokumentu
nakladatel ... nakladatel titulu
vydani ... vydání titulu
dnnt ... sekce s odkazy na online verzi titulu, u public dokumenů je k dispozici více zdrojů (pokud exstují) dle sigly
name ... název knihonvy
public ... 0 - dostupné po přihlášení, 1 - dostupné volně
status ... dnnto - dostupné po přihlášení, public - dostupné volně
url ... url
vydani ... vydání titulu
anotace ... anotace titulu
toc_fulltext ... OCR fulltext obsahu titulu
access ... vlastní libovolný text dle konkrétní knihovny
<?xml version="1.0" encoding="UTF-8"?>
<obalkyknih>
<record>
<okcz>
<id_book>128458802</id_book>
<modified>2021-08-30 13:48:20</modified>
<id_cover>2503992</id_cover>
<id_toc>651693</id_toc>
<id_marc>1194776</id_marc>
</okcz>
<ident>
<uuid>uuid:6705e9a0-edac-11ea-87fa-005056827e52</uuid>
<nbn>cnb000903376</nbn>
</ident>
<book>
<nazev>Stavitelství silniční</nazev>
<autor>Špaček Karel</autor>
<rok>1919</rok>
<autor_id>jk01130808</autor_id>
<nakladatel>V Praze : Česká Matice technická</nakladatel>
</book>
<dnnt>
<BOA001>
<name>Moravská zemská knihovna</name>
<public>1</public>
<status>public</status>
<url>https://www.digitalniknihovna.cz/mzk/view/uuid:6705e9a0-edac-11ea-87fa-005056827e52</url>
</BOA001>
<DNNT>
<name>Národní digitální knihovna</name>
<public>1</public>
<status>public</status>
<url>https://ndk.cz/view/uuid:6705e9a0-edac-11ea-87fa-005056827e52</url>
</DNNT>
</dnnt>
<toc_fulltext>OBSAH.\r\nStrana\r\ni. Přehled vývoje ...</toc_fulltext>
<access>Plny text dostupny po prihlášení čtenářskými údaji KNAV.</access>
</record>
<record>
...
</record>
</obalkyknih>
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",
);