Looker Studio (dříve Data Studio), je online BI nástroj společnosti Google pro převod a zpracování analýzy dat. Díky REST API rozhraní je možné získat data z ABRA Flexi a dále je v Looker Studiu zpracovat.
Napojení ABRA Flexi na Looker Studio jsme schopni zajistit formou služby (sazbu servisního zásahu naleznete v ceníku), níže v návodu však naleznete postup, jak napojení realizovat ze strany Vaší.
Looker Studio
Looker Studio naleznete na oficiálních stránkách společnosti Google.
Ke zprovoznění je nezbytné disponovat Google účtem. Doporučujeme si nastudovat veškeré podrobnosti ohledně vedení účtu na oficiálním webu. Na oficiálním webu naleznete rovněž manuál k použití.
Výběr dat z ABRA Flexi
V první řadě je potřeba si specifikovat, jaká data chceme z ABRA Flexi exportovat. Obvykle to mohou být účetní výstupy, sumace nad příslušnými evidencemi či vlastní, uživatelské dotazy.
Pokud chceme data z ABRA Flexi získat, lze tak učinit voláním příslušné URL adresy HTTP metodou GET. Níže naleznete návody, jak takovou URL adresu sestavit.
Pokud s REST API ABRA Flexi začínáte, doporučujeme nastudovat náš jiný návod, který vysvětluje základy práce s REST API rozhraním. Rovněž stojí opět za zmínku, že napojení na Looker Studio si můžete objednat jako službu z naší strany.
Pro ukázku napojení zvolíme možnost exportu analýzy prodeje. Jak přes API získat výstup analýzy prodeje popisuje detailně náš návod.
Naše URL adresa bude vypadat po 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
Zde si rozebereme jednotlivé části URL adresy:
jmeno:heslo
- jméno a heslo v basic HTTP autentizaciadresa-serveru:5434/c
- adresa a port serverufirma
- identifikátor společnostianalyza-prodeje
- endpoint.
json - formát výstupu?analyzovat=adresar&datumOd=2022-01-01&datumDo=2022-12-31&nekatalogovePolozky=true
- URL parametry
Pomocí výše popsané URL adresy dostaneme analýzu prodeje, která analyzuje obraty dle odběratelů v roce 2022 a vstupují do ní veškeré položky (nikoliv pouze katalogové - z ceníku).
Export dat z ABRA Flexi do aplikace Looker Studio
Jelikož Looker Studio nedisponuje svým vlastním API konektorem, zvolili jsme možnost využití JSON konektoru zdarma, jehož vývojářem je třetí strana (společnost Windsor.ai).
Jelikož konektor neumí pracovat s tzv. vnořený JSON, vytvořili jsme PHP skript, který upraví JSON dle potřeby. Skript je zdarma dostupný na našem webu.
Standardní URL adresa pro práci s REST API Flexi je zde hodnotou parametru URL parametru "url". Například tedy "https://www.flexibee.eu/admin/sandbox/flat/?url=xxx
", kdy "xxx" odpovídá příslušné URL adrese volající API rozhraní ABRA Flexi.
V aplikaci Looker Studio musíme nyní vytvořit zdroj dat s příslušnou URL adresou. Po přihlášení do aplikace a vytvoření nové pracovní plochy je zapotřebí přidat data.
Zde zvolíme konektor "JSON" od vývojáře Windsor.ai. Znovu připomínáme, že se jedná o aplikaci třetí strany, za její funkčnost tedy nejsme schopni ručit.
Poté, co vybereme konektor, vyplníme příslušnou URL adresu a potvrdíme přidání zdroje dat. Pole "Root Element" můžeme ponechat prázdné.
Pří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
Pomocí URL adresy výše můžeme získat analýzu prodeje. Dle použitých parametrů je analyzován prodej dle dle odběratelů za rok 2022, kde jsou započítávány i nekatalogové položky (resp. položky bez odkazu na ceník).
Po potvrzení přidání se nám veškeré zdroje dat, včetně zdroje nyní založeného, zobrazují v pravé části aplikace (sekce "Data").
Nezbývá než z načtených dat postavit požadovaný graf či tabulku. Učiníte tak pomocí tlačítka "Přidat graf" v hlavičce aplikace.
Pro analýzu prodeje může výsledná podoba nástěnky vypadat podobně, jako na screenshotu níže. V pravé části naleznete i příklad nastavení.
Příklad URL adresy č. 2:
U příkladu č. 1 jsem si vyzkoušeli, jak získat data již za použití parametrů pro omezení výběru dat pro export (viz parametr předchozí URL adresy: "?analyzovat=adresar&datumOd=2022-01-01&datumDo=2022-12-31
").
Nyní se však podíváme na druhou variantu, tedy jak vypsat veškeré data bez parametrů a jejich omezení pro jednotlivé tabulky a grafy nastavit a v rozhraní Looker Studia. Příklad si ukážeme na uživatelském dotazu vypisujícím výnosy a náklady.
URL adresa bude vypadat následovně:
https://www.flexibee.eu/admin/sandbox/flat/?url=https://jmeno:heslo@adresa-serveru:5434/c/testovaci_new/uzivatelsky-dotaz/288/call.json?limit=0
Jak pracovat s uživatelskými dotaz pomocí REST API rozhraní, naleznete v naší dokumentaci. Jediným použitým parametrem URL adresy je stránkování (díky použitému limitu se zobrazí naprosto všechny záznamy).
Na dané stránce v rámci Looker Studia můžeme přidat více grafů či tabulek, nastavit jim společný zdroj dat (v sekci nastavení, vždy pro každý graf či tabulku zvlášť).
Aktuální stav, za použití výše zmíněné URL adresy, je však takový, že jsou načtena naprosto všechna data. Tedy výnosy a náklady po měsících za všechna období.
Aby bylo možné jednoduše uživatelsky pracovat se vstupními parametry jednotlivých grafů a tabulek, přidáme si tzv. ovládací prvek.
V nastavení ovládacího prvku opět určíme zdroj dat (ten může být samozřejmě použit ve více grafech naráz) a nastavíme mu, jaké pole ovládacího prvku má ovlivňovat.
Uložením nastavení a upřesněním podmínky ovládacího prvku dojde k filtraci výsledku příslušného zdroje dat, tedy i jednotlivých grafů a tabulek.
Hodnoty pro jednotlivá pole, se kterými ovládací prvky pracují, je nezbytné zapisovat v datovém typu, v jakém jsou tato pole načtena zdrojem dat.
Aktualizace údajů
Vzniknou-li v ABRA Flexi nová data, která by měla být součástí již vytvořeného zdroje dat, je nezbytné načtená data aktualizovat. Aktualizací údajů v tomto případě dojde k novému volání použitých URL adres, čímž dojde k jejich načtení do Looker Studia.
Shrnutí
Máme-li vytvořeny zdroje dat, nezbývá než je zobrazit v požadované podobě grafů a tabulek. Samotný postup těchto operací není do detailu součástí tohoto návodu, tvorbu jednotlivých prvků si však můžete objednat z naší strany.
Nabízí se libovolné možnosti zobrazení výstupu v různých variantách grafů a tabulek. Nástroj umožňuje i konsolidaci dat za více firem. Meze se zde tedy nekladou.
ABRA Flexi samozřejmě není jedinou aplikací, kterou lze na Looker Studio napojit. Můžete zde porovnávat a spojovat výsledky různého reportingu z různých aplikací. Looker Studio je v tomto ohledu mocný BI nástroj.
Realizace napojení z naší strany
Jak již bylo v průběhu zmíněno, napojení ABRA Flexi a následnou vizualizaci dat v aplikaci Looker Studio jsme schopni zajistit z naší strany.
Zpracovat umíme výstupy standardní (např. analýza prodeje/nákupu či výstupy účetní), ale i výstupy zcela individuální (uživatelské dotazy). Neváhejte nás tedy kontaktovat s libovolným požadavek, jistě najdeme řešení.
Cena takové služby odpovídá hodinové sazbě servisního zásahu. Ceník je dostupný na našem webu.
Časovou náročnost nelze obecně určit, je vždy individuální s ohledem na požadavky zákazníka.
FAQ
Lze obdobným způsobem napojit ABRA Flexi i na PowerBI?
Ano, postup je popsán v našem jiném návodu.
Neumím s REST API rozhraním, jak dále postupovat?
V takovém případě Vám může být nápomocna API dokumentace. Nepodařilo-li by se napojení vytvořit za pomoci dokumentace, neváhejte se na nás obrátit.
Potřebujete poradit?
V případě dotazů k aplikaci nás kontaktujte na podporaflexi@abra.eu případně prostřednictvím chat okna v pravém dolním rohu.