Výstupy z databáze pro strojové zpracování

(datum poslední změny: 20.10.2019 23:08)

Novinky

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).


Popis

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=2019-12-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.

Přístup

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

Seznam výstupů



OBÁLKA, OBSAH, SEZNAM LITERATURY, HODNOCENÍ



ANOTACE



OCR OBSAHY



OBÁLKY - PHP ARRAY

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.









© 2013-2019 Jihočeská vědecká knihovna v Českých Budějovicích, admin@obalkyknih.cz