Preskoči na glavno vsebino

Looker Studio a ABRA Flexi

Ako načítať dáta z ABRA Flexi do Google Looker Studia (predtým Data Studia)?

Avtor: Petr Pech

Looker Studio (predtým Data Studio) je online BI nástroj spoločnosti Google na spracovanie a analýzu dát. Vďaka REST API rozhraniu je možné získať dáta z ABRA Flexi a ďalej ich v Looker Studiu spracovať.

Napojenie ABRA Flexi na Looker Studio sme schopní zaistiť formou služby (sadzbu servisného zásahu nájdete v cenníku), nižšie v návode však nájdete postup, ako napojenie zrealizovať z Vašej strany.

Looker Studio

Looker Studio nájdete na oficiálnych stránkach spoločnosti Google.

Na sprevádzkovanie je nevyhnutné disponovať Google účtom. Odporúčame naštudovať si všetky podrobnosti ohľadom vedenia účtu na oficiálnom webe. Na oficiálnom webe nájdete tiež manuál na použitie.

Výber dát z ABRA Flexi

V prvom rade je potrebné si špecifikovať, aké dáta chceme z ABRA Flexi exportovať. Obvykle to môžu byť účtovné výstupy, sumácie nad príslušnými evidenciami či vlastné, užívateľské dotazy.

Ak chceme dáta z ABRA Flexi získať, možno tak urobiť volaním príslušnej URL adresy HTTP metódou GET. Nižšie nájdete návody, ako takúto URL adresu zostaviť.

Ak s REST API ABRA Flexi začínate, odporúčame naštudovať náš iný návod, ktorý vysvetľuje základy práce s REST API rozhraním. Rovnako opäť stojí za zmienku, že napojenie na Looker Studio si môžete objednať ako službu z našej strany.

Pre ukážku napojenia zvolíme možnosť exportu analýzy predaja. Ako cez API získať výstup analýzy predaja podrobne popisuje náš návod.

Naša URL adresa bude vyzerať podľa vzoru:

https://jmeno:heslo@adresa-serveru:5434/c/firma/analyza-prodeje.json?analyzovat=adresar&datumOd=2022-01-01&datumDo=2022-12-31&datumyUcetne=false&nekatalogovePolozky=true

Tu si rozoberieme jednotlivé časti URL adresy:

Pomocou vyššie popísanej URL adresy dostaneme analýzu predaja, ktorá analyzuje obraty podľa odberateľov v roku 2022 a vstupujú do nej všetky položky (nielen katalógové - z cenníka).

Export dát z ABRA Flexi do aplikácie Looker Studio

Keďže Looker Studio nedisponuje svojím vlastným API konektorom, zvolili sme možnosť využitia JSON konektora zdarma, ktorého vývojárom je tretia strana (spoločnosť Windsor.ai).

Keďže konektor nevie pracovať s tzv. vnoreným JSON, vytvorili sme PHP skript, ktorý upraví JSON podľa potreby. Skript je zdarma dostupný na našom webe.

Štandardná URL adresa pre prácu s REST API Flexi je tu hodnotou parametra URL parametra "url". Napríklad teda "https://www.flexibee.eu/admin/sandbox/flat/?url=xxx", kde "xxx" zodpovedá príslušnej URL adrese volajúcej API rozhranie ABRA Flexi.

V aplikácii Looker Studio musíme teraz vytvoriť zdroj dát s príslušnou URL adresou. Po prihlásení do aplikácie a vytvorení novej pracovnej plochy je potrebné pridať dáta.

Tu zvolíme konektor "JSON" od vývojára Windsor.ai. Znovu pripomíname, že sa jedná o aplikáciu tretej strany, za jej funkčnosť teda nie sme schopní ručiť.

Potom, čo vyberieme konektor, vyplníme príslušnú URL adresu a potvrdíme pridanie zdroja dát. Pole "Root Element" môžeme ponechať prázdne.

Príklad URL adresy č. 1:

https://www.flexibee.eu/admin/sandbox/flat/?url=https://jmeno:heslo@adresa-serveru:5434/c/firma/analyza-prodeje.json?analyzovat=adresar&datumOd=2022-01-01&datumDo=2022-12-31&nekatalogovePolozky=true

Pomocou URL adresy vyššie môžeme získať analýzu predaja. Podľa použitých parametrov je analyzovaný predaj podľa odberateľov za rok 2022, kde sú započítavané aj nekatalógové položky (resp. položky bez odkazu na cenník).

Po potvrdení pridania sa nám všetky zdroje dát, vrátane teraz založeného zdroja, zobrazujú v pravej časti aplikácie (sekcia "Data").

Nezostáva než z načítaných dát postaviť požadovaný graf či tabuľku. Urobíte tak pomocou tlačidla "Pridať graf" v hlavičke aplikácie.

Pre analýzu predaja môže výsledná podoba nástenky vyzerať podobne, ako na screenshote nižšie. V pravej časti nájdete aj príklad nastavenia.

Príklad URL adresy č. 2:

Pri príklade č. 1 sme si vyskúšali, ako získať dáta už za použitia parametrov na obmedzenie výberu dát na export (pozri parameter predchádzajúcej URL adresy: "?analyzovat=adresar&datumOd=2022-01-01&datumDo=2022-12-31").

Teraz sa však pozrieme na druhú variantu, teda ako vypísať všetky dáta bez parametrov a ich obmedzenie pre jednotlivé tabuľky a grafy nastaviť v rozhraní Looker Studia. Príklad si ukážeme na užívateľskom dotaze vypisujúcom výnosy a náklady.

URL adresa bude vyzerať nasledovne:

https://www.flexibee.eu/admin/sandbox/flat/?url=https://jmeno:heslo@adresa-serveru:5434/c/testovaci_new/uzivatelsky-dotaz/288/call.json?limit=0

Ako pracovať s užívateľskými dotazmi pomocou REST API rozhrania, nájdete v našej dokumentácii. Jediným použitým parametrom URL adresy je stránkovanie (vďaka použitému limitu sa zobrazia úplne všetky záznamy).

Na danej stránke v rámci Looker Studia môžeme pridať viac grafov či tabuliek, nastaviť im spoločný zdroj dát (v sekcii nastavenia, vždy pre každý graf či tabuľku zvlášť).

Aktuálny stav, za použitia vyššie zmienenej URL adresy, je však taký, že sú načítané úplne všetky dáta. Teda výnosy a náklady po mesiacoch za všetky obdobia.

Aby bolo možné jednoducho užívateľsky pracovať so vstupnými parametrami jednotlivých grafov a tabuliek, pridáme si tzv. ovládací prvok.

V nastavení ovládacieho prvku opäť určíme zdroj dát (ten môže byť samozrejme použitý vo viacerých grafoch naraz) a nastavíme mu, aké pole ovládacieho prvku má ovplyvňovať.

Uložením nastavenia a upresnením podmienky ovládacieho prvku dôjde k filtrácii výsledku príslušného zdroja dát, teda aj jednotlivých grafov a tabuliek.

Hodnoty pre jednotlivé polia, s ktorými ovládacie prvky pracujú, je nevyhnutné zapisovať v dátovom type, v akom sú tieto polia načítané zdrojom dát.

Aktualizácia údajov

Ak vzniknú v ABRA Flexi nové dáta, ktoré by mali byť súčasťou už vytvoreného zdroja dát, je nevyhnutné načítané dáta aktualizovať. Aktualizáciou údajov v tomto prípade dôjde k novému volaniu použitých URL adries, čím dôjde k ich načítaniu do Looker Studia.

Zhrnutie

Ak máme vytvorené zdroje dát, nezostáva než ich zobraziť v požadovanej podobe grafov a tabuliek. Samotný postup týchto operácií nie je do detailu súčasťou tohto návodu, tvorbu jednotlivých prvkov si však môžete objednať z našej strany.

Ponúkajú sa ľubovoľné možnosti zobrazenia výstupu v rôznych variantách grafov a tabuliek. Nástroj umožňuje aj konsolidáciu dát za viac firiem. Medze sa tu teda nekladú.

ABRA Flexi samozrejme nie je jedinou aplikáciou, ktorú je možné na Looker Studio napojiť. Môžete tu porovnávať a spájať výsledky rôzneho reportingu z rôznych aplikácií. Looker Studio je v tomto ohľade mocný BI nástroj.

Realizácia napojenia z našej strany

Ako už bolo v priebehu spomenuté, napojenie ABRA Flexi a následnú vizualizáciu dát v aplikácii Looker Studio sme schopní zaistiť z našej strany.

Spracovať vieme výstupy štandardné (napr. analýza predaja/nákupu či účtovné výstupy), ale aj výstupy úplne individuálne (užívateľské dotazy). Neváhajte nás teda kontaktovať s ľubovoľnou požiadavkou, iste nájdeme riešenie.

Cena takejto služby zodpovedá hodinovej sadzbe servisného zásahu. Cenník je dostupný na našom webe.

Časovú náročnosť nemožno všeobecne určiť, je vždy individuálna s ohľadom na požiadavky zákazníka.

FAQ

Je možné obdobným spôsobom napojiť ABRA Flexi aj na PowerBI?

Áno, postup je popísaný v našom inom návode.

Neviem pracovať s REST API rozhraním, ako ďalej postupovať?

V takom prípade Vám môže byť nápomocná API dokumentácia. Ak by sa nepodarilo napojenie vytvoriť pomocou dokumentácie, neváhajte sa na nás obrátiť.

Potrebujete poradiť?
V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu prípadne prostredníctvom chat okna v pravom dolnom rohu.

Ste s tem dobili odgovor na svoje vprašanje?