Blog from June, 2014

During Open Culture 2014 conference I actually got a chance to follow up on the idea of Open Data in museums by giving a short talk at Open Data Unconference.

In this short summary, I publish my slides plus few additional notes.

Slides

Key points:

  • Investment: small
    • You're most probably already publishing data to general public (via your portal, Europeana, etc.)
    • With Web 2.0, you may already have an Open Data API (hint: AJAX)

    • If not, it's still easy to do (if the data already is in some database, CMS, etc.)

  • Contribution: much bigger than investment

    • Culture sector will benefit for sure: higher use/reuse of data already being published

    • Open Data will benefit too: apps and mash-up developers, ...

    • By extension society will benefit too, not just economically

  • Motivation: museum will benefit too

    • Wider use of your data => vider audience for your museum

    • Other museums can use you data too => better collaboration

Notes

I've asked the audience about who knows about Open Data: majority raised their hands. I've followed up with question about how many of them are actually publishing Open Data already: this time only minority raised their hand. So when it comes to Open Data in Culture sector, awareness seems to be there but we may say there's still a lot of work to e done.

But my key argument is that very little additional work is needed because:

  • I suspect many more are already publishing Open Data, they just not realize it and market it fully. For example some data gets published as Open through Europeana. Or as a by-product of existing nice Web 2.0 portals (which implement AJAX calls to so called back-end systems - I'm truly sorry for non-techies for this jargon: please talk to your IT guys, it's truly simple, just hidden from plain view).
  • And in cases when publishing is not being done yet, it can be done easily. For example CMS or collection management systems deployed at the museums can already do that or can be easily extended to do that.

Key-note speaker Sir Peter Bazalgette actually provided a very good introduction and few arguments in support for Open Data, Open Access:

  • those you lend to, lend back to you
  • database of oil paintings available as Open Access is already increasing visits
  • etc.

At the end I invited attendees to talk with their local Open Data activists in their countries so as to get help and guidance while solving lets say "few remaining issues" like:

  • documenting existing data and APIs
  • having that mentioned and linked in national data catalogs
  • making all that know with some press releases
  • etc.

Licensing, copyright

One question from audience was about licensing and who is owning copyrights. Well, I'm not a lawyer and it is very difficult topic. But, ...

Lots of such data (or, in this particular field it actually is a metadata about works of art and other objects) is already published on the web in human readable form "for free" and with some copyright notices at the bottom. I would thus argue that same "licensing scheme" can be reused for machine readable representation of same data/metadata.

So I think biggest part of the licensing is already solved. Or if not, it's not strictly limited to publication of Open Data, but is an issue of digital age as a whole. For example David Walsh sort of joked during his presentation, that in say 10 to 20 years this issue will be resolved ... or not. Along with some other difficulties troubling managers of digital collections. (smile)


Light side note: If I want to make complaint about missing space elevator, 27/29 South Lambeth Road, Vauxhall, London, SW8 1SZ might be one of the proper addresses.

Nadviažem na tému o Open Data API v SR (viď článoček OpenData API nemusí byť nič špeciálne). Tentoraz sa pozrieme na API portálu Register účtovných závierok, ktorý obstaralo Ministerstvo financií Slovenskej republiky. Obdobne ak v prípade portálu ZBGIS popíšem názorné ukážky toho, ako API použiť.

Upozornenie: Na rozdiel API portálu ZBGIS, ktoré vzniklo akoby náhodou, neplánovane a nechcene, API Registra účtovných závierok je jasne cielené na Open Data:

  1. existuje dokumentácia: http://www.registeruz.sk/cruz-public/static/api.html http://www.registeruz.sk/cruz-public/version/176425/static/api.html
  2. a špecificky sa v nej spomína: "Verejné RÚZ Open API poskytuje možnosť získať verejne dostupné údaje (t.j. všetko, čo je poskytované portálom registeruz.sk) v podobe vhodnej na spracovanie ..."

Takže k veci. Použitie API si ukážeme na veľmi jednoduchom praktickom príklade: Ako zistím či firma PosAm podala tohto roku účtovnú závierku?

Update k 6.6.2014: Ďalšie doplnkové čítanie: Aspoň jeden štátny IT projekt na európskej špici



Ako zistím či firma PosAm podala tohto roku účtovnú závierku?

Krok 0: zistenie IČO

Ako prvé si samozrejme preštudujeme už spomenutú dokumentáciu. Tam o.i. zistíme, že vyhľadávať možno napr. podľa IČO. Ale zatiaľ máme iba názov. Pomôžeme si Obchodným registrom: http://www.orsr.sk/vypis.asp?ID=8585&SID=2&P=0 -> 31365078 .

Krok 1: zistenie ID firmy podľa IČO

Zašleme na server požiadavku (pre potreby tohto návodu vkladáme URL rovno do browsera resp. naň klikáme a otvárame v novej záložke či novom okne):

http://www.registeruz.sk/cruz-public/api/uctovne-jednotky?zmenene-od=2014-01-01&max-zaznamov=100&ico=31365078

a získame odpoveď:

response
{"id":[156639],"pocetZostavajucichId":0}

Čiže ID je 156639.

Krok 2: zistenie ďalších atribútov k firme podľa ID

Požiadavka:

http://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id=156639

Odpoveď:

response
{"id":156639,"ico":"31365078","dic":"2020315440","nazovUJ":"PosAm, spol. s r.o.",
"mesto":"Bratislava - mestská časť Nové Mesto","ulica":"Odborárska 21","psc":"83102",
"datumPoslednejUpravy":"2014-01-29","datumZalozenia":"1994-01-03","pravnaForma":"112","skNace":"62010",
"velkostOrganizacie":"23","druhVlastnictva":"2",
"kraj":"1","okres":"103","sidlo":"529346","konsolidovana":false,"zdrojDat":"ŠÚSR",
"idUctovnychZavierok":[568588,993104,2054656,284076,1713768],
"idVyrocnychSprav":[1913909]}

Overili sme si, že teda áno, je to firma PosAm a že doteraz zaslala:

  1. účtovné závierky: dokumenty z ID 568588, 993104, 2054656, 284076 a 1713768
  2. výročnú správu: dokument s ID 1913909

Krok 3: zistenie podrobností o účtovnej závierke podľa jej ID

Tu preskočím prehľadávanie viacerých ID a rovno poviem, že tá uzávierka ktorá nás zaujíma má ID 2054656:

Požiadavka:

http://www.registeruz.sk/cruz-public/api/uctovna-zavierka?id=2054656

Odpoveď:

response
{"id":2054656,
"obdobieOd":"2013-01-01","obdobieDo":"2013-12-31","datumPodania":"2014-03-31",
"datumZostavenia":"2014-03-07","datumSchvalenia":"2014-03-26","datumPrilozeniaSpravyAuditora":"2014-03-31","datumPoslednejUpravy":"2014-05-13",
"zdrojDat":"FRSR","nazovUJ":"PosAm,spol.s r.o.","ico":"31365078","dic":"2020315440","idUJ":156639,"typ":"Riadna",
"idUctovnychVykazov":[4037605,4037606,4037603,4037604]}

Takže máme odpoveď: Áno, firma PosAm podala za rok 2013 účtovnú závierku a to dňa 31.3.2014.

Ale sme zvedaví, takže poďme ešte ďalej.

Krok 4: zistenie podrobností o konkrétnom účtovnom výkaze podľa jeho ID

Opäť trochu preskočím a poviem, že nás zaujíma výkaz s ID 4037605.

Požiadavka:

http://www.registeruz.sk/cruz-public/api/uctovny-vykaz?id=4037605

Odpoveď:

response
{"prilohy":[
{"id":3390918,"meno":"POD101_2020315440_IR_2013_201801_631789.pdf","mimeType":"application/pdf",
"velkostPrilohy":264961,"digest":"c8b2017f8e5af3200beae04d8c5db2f2914dccb931f6c319d8306749c2c80d60","pocetStran":0}],
"id":4037605,"idUctovnejZavierky":2054656,"idSablony":21,
"obsah":{"titulnaStrana":{"nazovUctovnejJednotky":"PosAm,spol.s r.o.","ico":"31365078","dic":"2020315440",
"adresa":{"ulica":"Odborárska","cislo":"21","psc":"83102","mesto":"Bratislava 3 - Nové Mesto"},
"skNace":"62010","typZavierky":"Riadna",
"obdobieOd":"012013","obdobieDo":"122013","predchadzajuceObdobieOd":"012012","predchadzajuceObdobieDo":"122012",
"datumSchvalenia":"26032014","datumZostavenia":"07032014"},
"tabulky":[
{"nazov":"Strana aktív","data":[...]},
{"nazov":"Strana pasív","data":[...]}]},
"kodDanovehoUradu":"100","datumPoslednejUpravy":"2014-05-13","zdrojDat":"FRSR"}

To je kopa údajov. Kto si to doštuduje podrobnejšie, zrejme zistí čo potrebuje.

Ale teraz sme predsa len ľudia, nie programy, takže skúsme ešte niečo.

Krok 5: Stiahnutie PDF verzie účtovného výkazu podľa jeho ID

Požiadavka na PDF generované portálom z údajov:

http://www.registeruz.sk/cruz-public/domain/financialreport/pdf/4037605

Odpoveď:

report_31365078_20140605_S.pdf

Požiadavka na PDF zaslané samotnou firmou, t.j. "originál" (3390918 je ID prílohy výkaz s ID 4037605):

http://www.registeruz.sk/cruz-public/domain/financialreport/attachment/3390918

Odpoveď:

POD101_2020315440_IR_2013_201801_631789.pdf

Tu už samozrejme prestáva stačiť, že vieme volať API a k slovu prichádzajú naše znalosti účtovníctva. A tým teda končím tento praktický príklad.

Záver

API je jednoduché a funkčné (s ohľadom na bázu údajov, s ktorou pracujeme) a okrem tohto malého príkladu je schopné efektívne poskytnúť údaje aj zložitejším aplikáciám, keďže (v súlade s Výnosom o štandardoch pre ISVS č. 55/2014 Z. z.) poskytuje aj možnosť filtrovať výsledky podľa dátumu poslednej zmeny (parameter 'zmenene-od') a stránkovať (parametre 'pokracovat-za-id' a 'max-zaznamov').

Neostáva iné než pochváliť. (smile)


p.s.: Prečo práve PosAm? Lebo dodávali realizáciu portálu. Viď napr. http://otvorenezmluvy.sk/documents/703913-datacentrum-bratislava-posam-s-r-o-zmluva-o-dielo-pre-fu?q=Register+%C3%BA%C4%8Dtovn%C3%BDch+z%C3%A1vierok .