ObalkyKnih koncept citace ČSN ISO 690
- Menší knihovny s minimální možností úpravy svého katalogu. Nevyžaduje zložité úpravy. Postačuje na požadované místo stránekvložit IFRAME. Zdrojem dat pro generování textu citace jsou jiné katalogy, zejména NKP a knihovny zapojené do projektu jako přispívatelé. Nevýhodou je, že text citace nebude generovám pro všechny typy dokumentů a pro všechny záznamy.
- Pro knihovny, které požadují mít text citace generován vždy ze svých dat. A to jak pro monografie, seriály, hudebniny, kartografické dokumenty, ...
Jedná se o knihovny, které budou OKCZ posílat bibliografické záznamy a OKCZ následně bude generovat z těchto bibliografických záznamů text citace podle normy ČSN ISO 690. Bude se jednat o generování textu citace „na míru“ = právě z bibliografického záznamu dané knihovny. Bude možné získat text citace na teoreticky libovolný typ záznamu.
Workflow pro knihovny:
- Knihovna se dotáže na text citace (šipka č.1). V dotazu připojí SYSNO záznamu ve svém katalogu, kterého text citace požaduje a typ dokumentu.
- Svoji SIGLU do dotazu nepřipojuje, ta se získá z referera = URL adresy, z které je dotazované. OKCZ už v současné verzi obsahuje registrace URL adres knižních katalogů s vyjmenovanou siglou.
- V databázi na FE OKCZ se dohledá, jestli text citace pro klíč složený z SYSNO+SIGLA existuje. Pokud ano, je text vrácen.
- Pokud neexistuje dotážeme se knihovny na plný bibliografický záznam (šipka č.2).
- Ten může být získán (šipka č.3) pomocí HTTP/S protokolu ve formátu MARC XML, nebo pomocí Z39.50 protokolu (nejasná existence z39.50 knihovny pro Node.js).
- Z bibliografického záznamu je vygenerován text citace požadovaného typu dokumentu a zaslán jako odpověď API (šipka č.4).
- Text citace se poznačí do lokální databáze a při dalším dotazu na stejný dokument se už nebudeme dotazovat na bibliografický záznam, ale text citace bude dohledán a poskytnut z lokální databáze. Expirace platnosti lokálního záznamu cca 1 týden.
- Zároveň se vygenerovaný text uloží do pomocné kolekce v lokální databáze a dávkově se bude vygenerovaný text citace + identifikátory záznamu (isbn, issn, ean, nbn, oclc, sysno) zasílat na BE OKCZ (šipka č.5). Toto se vykoná pouze pokud byl vygenerován text citace, ne pokud byl text citace dohledán v DB.
Jedná se o knihovny, které nebudou OKCZ posílat bibliografické záznamy, ale budou čerpat z již před generovaných dat. Pokud před generovaný text citace neexistuje, bude zaslána jako odpověď API prázdný text. Nebude taky možné získat text citace pro všechny typy dokumentů. Workflow:
- Knihovna se dotáže na metadata OKCZ standardním způsobem (volání /api/books) pomocí standardní trojice identifikátorů (isbn, nbn, oclc).
- Pokud nalezený záznam před generovaný text citace obsahuje, bude tento text doplněn jako nový parametr meta datového objektu OKCZ. Pokud neobsahuje, bude parametr prázdný (prázdný text).
- V textu citace oproti předchozího případu bude uvedeno z jakého zdroje byl text citace vygenerován a kdy.
O před generování textu citace se budou starat na toto určené crawlovací (případ, kdy množina dat ke sklizení se nachází na zdroji) a harvestovací procesy (případ, kdy množina dat se nachází v lokální DB, typicky procházení zatím neaktuálních záznamů v lokální DB).
- Sklízecí procesy budou 1x denně procházet záznamy buďto na lokálním, nebo vzdáleném zdroji (podle toho jestli se jedná o harvester, nebo crawler)
- Získaný bibliografický záznam bude převeden na text citace. Pravidla pro převod se ale nebudou nacházet na BE (backendu), ale na FE (frontendech). Získaný bibliografický záznam se proto zašle na jeden z FE serverů a odpověď ve formě formátovaného textu se uloží do lokální MySQL databáze.
- K textu citace se připojí (pravděpodobně do závorek i název zdroje bibliografického záznamu a datum generování).
- Bude se počítat s prioritou zdrojů. Nejvyšší prioritu bude mít OAI-PMH crawler NKP.Ostatní zdroje budou mít stejnou prioritu, ale menší než zmíněný crawler NKP.
- Do lokální databáze se taktéž poznačí zdroj bibliografického záznamu, čas generování a poznačí se i čas příští možné aktualizace (co neplatí pro OAI-PMH zdroje).
- Typy zdrojů budou: OAI-PMH (crawler; sklízení všeho co bylo danou knihovnou vytvořeno/pozměněno daný den), MARC XML over HTTP/S (harvester; sklízení cca 1-10tis neaktuálních/neexistujících citací v lokální DB), Z39.50 (to samé jako předchozí případ).
Workflow pro knihovny s plným citačním API bude generovat texty citace z bibliografických záznamů knihoven používajících tento typ API na požádání. Generované texty citací je možné využít na naplnění BE OKCZ databáze a pomoci tím sklízecím procesům.
- Vygenerovaný text citace na FE OKCZ + identifikátory záznamu se uloží do pomocné kolekce.
- V pravidelných intervalech se bude script na BE OKCZ na nové vygenerované texty citace dotazovat a ukládat si je do DB.
- O spouštění scriptu v pravidelných intervalech na BE OKCZ se bude starat cron.
- Bude uplatněna priorita zdrojů popsaná výše, tj. už vygenerované citace ze zdroje NKP nebudou přepisovány.