Obálkyknih.cz - Jihočeská vědecká knihovna v Českých Budějovicích

Novinky

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

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.

Statické exporty jsou generovány 1x denně v noci a poskytovány ve formátu souborů XML (UTF-8 kódování).

Jako parametr při volání skriptů 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=2023-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.

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:

https://cache1.obalkyknih.cz/file/cover/755239/thumbnail - náhled obálky velikosti thumbnail (27x36px) záznamu s cover_id 755239 (server cache1.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/cover/755239/icon - náhled obálky velikosti icon (54x68px) záznamu s cover_id 755239 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/cover/755239/medium - náhled obálky velikosti medium (170x240px) záznamu s cover_id 755239 (server cache1.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/cover/755239/preview510 - náhled obálky velikosti preview510 (510x720px, pokud je dostupná tato velikost) záznamu s cover_id 755239 (server cache2.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/toc/472/thumbnail - náhled první stránky obsahu (170x240px) záznamu s toc_id 472 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/toc/472/pdf - PDF soubor s obsahem záznamu s toc_id 472 (server cache1.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/bib/2/thumbnail - náhled první stránky seznamu literatury (170x240px) záznamu s bib_id 193472 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/bib/2/pdf - PDF soubor se seznamem literatury záznamu s bib_id 2 (server cache1.obalkyknih.cz)

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álky, obsahy, seznam literatury, hodnocení
anotace
OCR obsahy
obálky - PHP array
výstup dokumentů volně přístupných a online dostupných děl z digitálních knihoven (DNNTO)
obálky DNNT - PHP ARRAY

OBÁLKA, OBSAH, SEZNAM LITERATURY, HODNOCENÍ

link: https://servis.obalkyknih.cz/export/okcz_ident.php
velikost soubor (plný export): 320.17 MB
datum posledního exportu: 2023-01-30 05:40:49
struktura XML - obálky,obsahy,seznam literatury,hodnocení:
- 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

ukázka XML - obálky,obsahy,seznam literatury:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2023-01-30 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>

ANOTACE

link: https://servis.obalkyknih.cz/export/okcz_annotation.php
velikost soubor (plný export): 530.51 MB
datum posledního exportu: 2023-01-30 05:40:27
struktura XML - anotace:
- 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

ukázka XML - anotace:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2023-01-30 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>

OCR OBSAHY

link: https://servis.obalkyknih.cz/export/okcz_toc.php?last_change=2023-01-01
exporty jsou rozděleny do souborů po 100 000 záznamech (plný export databáze):
okcz-toc-0.xml (487.65 MB), okcz-toc-1.xml (780.19 MB), okcz-toc-2.xml (1.07 GB), okcz-toc-3.xml (1.37 GB), okcz-toc-4.xml (1.03 GB), okcz-toc-5.xml (701.17 MB), okcz-toc-6.xml (326.79 MB), okcz-toc-7.xml (2.74 MB),
datum posledního exportu: 2023-01-30 05:46:52
struktura XML - OCR obsahy::
- 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

ukázka XML - OCR obsahy:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2023-01-30 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>

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.

link: https://servis.obalkyknih.cz/export/dump/ident-okcz.cz.php.tgz
velikost soubor (plný export): 18.88 MB
datum posledního exportu: 2023-01-30 05:40:06
struktura pole - obálky PHP array:

"KLÍČ:identifikátor" => "HODNOTA:cover_id",

ukázka PHP pole - obálky:

            
      $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",
    );

Výstup dokumentů volně přístupných a online dostupných děl z digitálních knihoven (DNNTO)

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.

link: https://servis.obalkyknih.cz/export/dnnt.php
parametry dotazu: full=1 ... export včetně anotace a fulltext obsahu, library=sigla ... export individuálního info popisku pro konkrétní knihovnu
exportuje se přímo z databáze, plný export včetně anotace a OCR obsahu cca 0,5 GB (120 000 záznamu dnnto a 30 000 public záznamů)
struktura XML:
- 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
      
      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

ukázka XML:

    <?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>

OBÁLKY DNNT - PHP ARRAY

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.

link: https://servis.obalkyknih.cz/export/dump/dnnt-okcz.cz.php.tgz
velikost soubor (plný export): 171 bytes
datum posledního exportu: 2023-01-30 05:40:06
struktura pole - obálky PHP array:

"ID obálky" => "HODNOTA:uuid",

ukázka PHP pole - obálky:

            
"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",

    );