Funkcie pre MS Excel

Sada funkcií pre MS Excel umožňuje v reálnom čase pracovať s dátami čerpanými z informačného systému ABRA Gen v prostredí tohto tabuľkového procesoru. Ide o samostatne dodávané rozšírenie.

V prípade záujmu o viac informácií alebo predvedenie kontaktujte svojho obchodníka.

Nevyhnutnou podmienkou prevádzky je, aby táto časť systému bola ABRA Gen nainštalovaná a licencovaná.

  • Inštalácia:

    • Funkcie pre MS Excel sa inštalujú samostatne prostredníctvom dodávaného inštalátora, čo je excelový zošit s podporou makier (súbor s príponou XLSM). Funkcia inštalátora spočíva v automatizovanom skopírovaní celkovej potrebnej funkcionality do zvoleného vlastného excelového zošita s podporou makier, v ktorom chcete funkcie používať. Inštalátor je k dispozícii na stiahnutie, podrobnejší popis nájdete v sekcii Inštalácia a nastavenie.
    • Ďalej je potrebné mať nainštalovanú verziu systému ABRA Gen, ktorá má potrebnú funkcionalitu v rozhraní Web API implementovanú, tzn. 19.2 či vyššiu.
    • MS Excel je podporovaný vo verziách pre Windows i pre macOS.

  • Licencovanie:

    • Na prevádzku funkcií pre MS Excel je potrebné rozhranie Web API, ktoré je súčasťou licencie jadra s pokročilou automatizáciou a vizualizáciou. V prípade, že vaša licencia jadra toto rozšírenie neobsahuje, je potrebné licenciu rozšíriť. Pre viac informácií kontaktujte dodávateľa systému.

    • Funkcie pre MS Excel sú licencované samostatne - viď licencované celky. Každý užívateľ, ktorý bude funkcie pre MS Excel používať, potrebuje dve licencie:

      1. Pre prihlásenie nevizuálneho užívateľa API.

        Licenčný súbor LICENCE.CFG musí obsahovať kľúč s definíciou oprávnenia pre prihlásenie nevizuálnych užívateľov API. Počet uživatelů se zobrazuje v agendě Správa licencií na záložce Licencované moduly a vlastnosti jako součást informace o licencích k modulu Jádro systému.

        Hodnota obsiahnutá v kľúči určuje, koľkým užívateľom v agende Užívatelia budete môcť začiarknuť príznak Prihlásenie nevizuálneho užívateľa API. Prihlasovacie údaje týchto užívateľov neskôr použijete pri definícii pripojenia do Web API v jednotlivých excelových zošitoch, v ktorých budete funkcie pre MS Excel využívať.

        Viac užívateľov s príznakom Prihlásenie nevizuálneho užívateľa API si nadefinujte a následne používajte v prípadoch, kedy chcete jednotlivým excelovým zošitom resp. ich užívateľom prideliť rozdielne prístupové práva.

        V súčasnej dobe sa pri prístupe prostredníctvom API zohľadňujú len práva k chráneným objektom, do budúcnosti je plánované tiež zohľadňovanie práv k funkciám.

      2. Pre WebAPI doplnky.

        Licenčný súbor LICENCE.CFG musí obsahovať kľúč s definíciou oprávnenia pre modul Web API doplnky.

        Licencia umožňuje dopytovanie špeciálnych Web API zdrojov pre doplnky v MS Exceli. Vždy stačí jedna licencia - pokiaľ je súčasťou licenčného kľúča, môžu sa do týchto špeciálnych zdrojov dopytovať všetci užívatelia.

      Počet súbežne pracujúcich užívateľov nie je licenčne obmedzený. Môžete si tak napríklad vytvoriť ľubovoľný počet excelových zošitov so spomenutými funkciami a zo všetkých sa do Web API prihlasovať pod rovnakým užívateľom.

Pre úspešné používanie funkcií je potrebné postupne vykonať nasledujúce kroky:

  • Sprevádzkovať Web API.
  • Od dodávateľa systému získať licenciu k modulu WebAPI doplnky (tzn. licenčný súbor LICENCIA.CFG obsahujúci licenciu k tomuto modulu, podrobnosti viď aktuálne obchodné podmienky).
  • V agendě Správa licencií načíst získaný soubor LICENCE.CFG funkcí Aktivace. Úspešnou inštaláciou signalizuje symbol začiarknutia pri module Web API doplnky.

  • Vo vlastnostiach užívateľa, ktorý bude k dátam prostredníctvom Web API pristupovať, začiarknuť príznak Prihlásenie nevizuálneho užívateľa API a nastaviť mu potrebné oprávnenie (prostredníctvom rolí alebo skupín rolí). V súčasnej dobe sa zohľadňujú práva k chráneným objektom.

  • Stiahnuť si inštalátor.

  • Pripraviť si excelové zošity, v ktorých budete chcieť funkcie používať. Zošity môžu a nemusia byť prázdne. Do zvolených súborov je len doplnená nová funkcionalita, celkový obsah týchto súborov je zachovaný.

    I tieto zošity musia byť vo formáte XLSM - do zošitov vo formátoch XLSX, XLS, ODS a ďalších nie je možné funkcie nakopírovať.

  • V priebehu inštalácie je potrebné mať v MS Exceli začiarknutú voľbu Dôverovať prístupu k objektovému modelu projektu VBA:
    • Súbor → Možnosti → Prispôsobiť pás kariet: pokiaľ nemáte v sekcii Hlavné karty začiarknutú kartu Vývojár, začiarknite ju.
    • Na karte Vývojár kliknite na tlačidlo Zabezpečenie makier a v sekcii Nastavenie makier → Nastavenie makier pre vývojárov začiarknite túto voľbu.

    Po dokončení úpravy jednotlivých zošitov môžete voľbu opäť deaktivovať.

  • V aplikácii MS Excel otvorte inštalátor (stiahnutý XLSM súbor). Inštalátor obsahuje jediný list, do ktorého je vložený formulár umožňujúci nakopírovanie potrebnej funkcionality do vašich vlastných XLSM súborov.

  • Tlačidlom Browse vyvolajte štandardný dialóg operačného systému pre výber súboru. Vyberte z disku XLSM súbor, do ktorého chcete podporu funkcií doplniť.

  • Tlačidlom Install / Update spustite vlastnú inštaláciu (úpravu zvoleného zošitu). Inštalátor vykoná nasledujúce kroky:

    • Pokiaľ v upravovanom zošite neexistuje list nazvaný API (viď nasledujúci bod), inštalátor ho vytvorí a naplní východiskovými hodnotami. Pokiaľ už list s týmto názvom existuje, ponechá ho inštalátor bezo zmeny.

    • Pokiaľ v upravovanom zošite neexistuje modul AbraUtils, inštalátor ho vytvorí a nakopíruje do neho aktuálny obsah (jednotlivé funkcie). Pokiaľ modul v upravovanom zošite existuje, inštalátor ho aktualizuje (prepíše existujúce funkcie, prípadne doplní nové).

      Pokiaľ pomocou inštalátora aktualizujete už používaný zošit, aktualizujte najprv jeho kópiu a aktualizovaný zošit otestujte.

      Okrem AbraUtils inštalátor do zošita vkladá ešte niekoľko pomocných modulov.

  • Takto upravený súbor otvorte. Nájdete v ňom nový list nazvaný API obsahujúci tabuľku, do ktorej vyplňte pripojovacie údaje k Web API serveru:

    • URL - adresa Web API servera, vrátane prípadného portu a názvu spojenia

      Hodnota parametra bude závisieť na konkrétnej konfigurácii vášho Web API servera. URL môže a nemusí končiť lomkou. Napríklad:

      https://api.firma.cz:8089/data_cz
    • Username - užívateľské meno pre pripojenie do API (musí ísť o užívateľa systému ABRA Gen so začiarknutým príznakom Prihlásenie nevizuálneho užívateľa API).
    • Password - heslo užívateľa pre pripojenie do API.
    • Max. Timeout - maximálna doba v sekundách, po ktorú klient čaká na dokončenie každej z fáz požiadavky (Resolve, Connect, Send, Receive).
    • Max. Connection Timeout - maximálna doba v sekundách, po uplynutí ktorej pokus o nadviazanie spojenia skončí chybou.
  • Postup zopakujte pre všetky súbory, v ktorých chcete funkcie používať.

  • Podľa svojich individuálnych špecifických požiadaviek do zošitov doplňte vlastný obsah (tabuľky, grafy), ktorý prostredníctvom týchto funkcií čerpá dáta zo systému ABRA Gen. Popis dostupných funkcií nájdete v nasledujúcej kapitole.

    Pre inšpiráciu si môžete stiahnuť súbor so vzorovými príkladmi.

    Pokud převáděný nebo již dříve funkční převedený excelovský sešit přestane fungovat, nepřipojí se nebo vykazuje chyby je nutné pro jeho další možné používání jej nejdříve vyčistit od systémově nainstalovaných skriptů, zkontrolovat případné další uživatelské změny a následně znovu pomocí instalátoru převést.

    Vyčištění od systémově nainstalovaných skriptů

    Při novém převádění sešitu se kontroluje, zda vše níže uvedené v sešitu již existuje a pokud ano, tak je přeskočeno. Tímto krokem tedy zajistíme opětovné výchozí nastavení.

    Otevřete sešit v aplikaci MS Excel a z listu API si za zálohujte všechny přihlašovací údaje tak, aby je bylo možné po novém převedení sešitu znovu vyplnit.

    Odstraňte celý list API. (Skryté listy je možné zobrazit např.. po kliknutím pravým tlačítkem myši na jiný list a zvolením „Zobrazit…“)

    Přepněte se na záložku Vývojář a spusťte Visual Basic (případně pomocí klávesové zkratky Alt + F11) a zde odstraňte z VBAProject následující položky:

    • Modules – ABRAUtils
    • Modules – WebHelpers
    • Class Modules – Dictionary
    • Class Modules – HttpBasicAuthenticator
    • Class Modules – IWebAuthenticator
    • Class Modules – WebClient
    • Class Modules – WebRequest
    • Class Modules – WebResponse

    Výše vypsané body naleznete na této obrazovce. Tu spustíte v režimu Vývojář, viz popis výše.

    Kontrola uživatelských změn a maker

    Ve Visual Basic zvolte menu „Debug“ a zde funkci „Compile VBAProject“.

    Všechny skripty/makra musí být před převedením v daném sešitu Excelu zkompilované. Zde nejčastěji dochází k problémům mezi operačními systémy Windows a macOS, kdy sešit vytvořený na jednom operačním systému nebude fungovat na druhém a naopak. Nejlépe tedy mít, pokud je potřeba pro každý operační systém vlastní sešit.

Tato verze je k dispozici pouze pro MS Excel na Windows, a to jak v 32-bit, tak i v 64-bit variantě. Funguje i pro desktopový Excel z Office 365.

Nefunguje pro Excel na OS MAC. Tento Excel nepodporuje instalaci tohoto typu doplňku Pro MAC nadále zůstává jedinou možností instalace VBA skriptů.

Hlavní výhodou tohoto nového řešení je možnost spouštět výpočty ve více vláknech, a tudíž lze celý proces značně zrychlit. Oproti tomu původní verze (VBA skripty) fungují vždy jen v jednom vlákně, tudíž počítají jednotlivé buňky postupně po jedné.

 

Obecné informace k instalaci
Hlavní rozdíl mezi původní a novou verzí je v tom, že původní VBA skripty musejí být součástí každého excelového sešitu, aby bylo možné tyto funkce využívat. Naproti tomu tato nová verze je instalována přímo v Excelu, a tudíž lze otevřít nový prázdný sešit a rovnou lze používat ABRA funkce z doplňku.

Pokud dojde k situaci, že v Excelu je nainstalován nový doplněk a současně je otevřen sešit obsahující původní VBA skripty, pak by Excel měl upřednostnit nové funkce z nového doplňku.

Funkce i jejich parametry jsou totožné jak ve VBA skriptech, tak v novém doplňku, proto lze vyměnit pouze staré VBA skripty za nový doplněk a není třeba v excelových vzorcích nic upravovat.

Jediné, co bude třeba zkontrolovat / nastavit je možnost spouštět výpočty vzorců ve vláknech.

 

Instalace nových doplňků do Excelu

Soubor, zde volba Možnosti. Otevře se dialog, kde zvolíme možnost Doplňky. Dole vybereme možnost Spravovat – Doplňky Excelu a stiskneme tlačítko Přejít.

Následně se otevře okno:

Kde zvolíme možnost „Procházet“ a najdeme Doplněk, který chceme přidat. Dialog bude takto vypadat po přidání Doplňku, kdy tam doplněk je už vidět (První nahoře a je aktivovaný - označený). Zároveň je možné jej zde deaktivovat odoznačením.

Vybereme variantu doplňku – xxx64 je varianta pro 64-bitový Excel. Varianta bez čísla je pro 32-bitový Excel.

Adresář s potřebnými knihovnami je ke stažení ve formátu ZIP níže.

 

Nastavení přepočtu ve vláknech
Poslední věc, kterou je třeba nastavit pro zrychlení je povolení přepočtu ve vláknech.

Klikneme na Soubor -> Možnosti a zde volba Upřesnit a vpravo sekce Vzorce.

Nastavení „Využít všechny procesory v tomto počítači“ zde nedává moc smysl, protože funkce jsou volány na vzdálený API server. Je třeba rozumně nastavit počet vláken tak, aby nedocházelo k přetížení API serveru nebo SQL serveru.

 

Úplné odebrání doplňku.

MS Office Excel přímo nenabízí úplné odebrání doplňku. Jediná možnost, jak toho dosáhnout je zavřít Excel, odebrat adresář ve kterém se doplněk nachází. Poté spustit Excel a postupovat jako při přidávání doplňku. Ve chvíli, kdy otevřete dialog pro přidání doplňku.

Klikneme na zatržítko u AbraxcelAddIn doplňku. Excel zjistí, že příslušný soubor chybí a nabídne úplné odstranění doplňku ze seznamu.

Potom, ako vykonáte úvodnú inštaláciu a nastavenia, môžete v excelových zošitoch (upravených inštalátorom a doplnených o prihlasovacie údaje k Web API) začať používať nižšie popísané funkcie. Funkcie sa používajú úplne rovnako, ako bežné funkcie v Exceli. Na základe zadaných argumentov vracajú hodnoty získavané zo systému ABRA Gen.

V texte nižšie spomenieme všetky dostupné funkcie a zoznamy argumentov. Argumenty uvedené kurzívou sú voliteľné. Je možné uviesť len povinné argumenty, alebo povinné argumenty a prvých niekoľko voliteľných argumentov. Vždy je nutné dodržiavať poradie argumentov.

Pokiaľ neuvediete hodnotu argumentu zoznam firiem, získate hodnotu za všetky firmy.

Argumenty excelových funkcií sú ekvivalentom query parametrov zodpovedajúcich Web API zdrojov, pri jednotlivých funkciách sú preto uvedené odkazy na tieto zdroje, ktoré môžete využiť ako zdroj ďalších informácií.

Väčšina funkcií je k dispozícii v dvoch variantoch:

  • funkcie s názvami sprevádzanými prefixom Get- umožňujú použitie všetkých parametrov príslušného zdroja
  • funkcie s názvami sprevádzanými prefixom Abra- spravidla ponúkajú úspornejší zápis, kedy sú za časť parametrov dosadené východiskové hodnoty

Všetky funkcie vyžadujú zadanie hodnôt argumentov URL, meno a heslo pre prihlásenie k Web API. Pravdepodobne ich budete zadávať formou odkazu do buniek na liste API, ktorý do zošita vložil inštalátor. Z tohto predpokladu vychádzajú i všetky uvedené ilustračné príklady - argumenty URL;Username;Password; znamenajú nasledujúce:

  • na liste API je v konkrétnej bunke (C3) zadané URL Web API servera; táto bunka je pre jednoduchšie odkazovanie pomenovaná URL
  • V ďalšej bunke (C4) je zadané prihlasovacie meno do Web API; táto bunka je pomenovaná Username
  • V ďalšej bunke (C5) je zadané heslo tohto užívateľa; táto bunka je pomenovaná Password

Inými slovami, v príkladoch používaný zápis:

=AbraSale(URL;Username;Password;"a";"1.1.2019";"31.12.2019")

je ekvivalentom nasledujúceho zápisu:

=AbraSale(API!$C$3;API!$C$4;API!$C$5;"a";"1.1.2019";"31.12.2019")

Pokiaľ si nie ste istí presným názvom konkrétnej funkcie, množinou podporovaných argumentov alebo ich poradím, postupujte nasledovne:

  • V MS Exceli do riadka vzorcov vpíšte začiatok názvu funkcie, tzn.:
    =Abra
    alebo
    =Get
    Zobrazí sa vám zoznam dostupných funkcií začínajúcich zadaným reťazcom, podľa anglického názvu požadovanú funkciu vyberte (poklikajte na jej názov myšou).
  • Po poklikaní na názov funkcie sa do riadka vzorcov vloží celý názov funkcie vrátane otváracej zátvorky a systém očakáva zadanie argumentov:
    =AbraAsset(
    V tomto bode môžete stlačiť klávesovú skratku shift+ctrl+A, ktorá do riadka vzorcov k funkcii doplní zoznam argumentov a uzatváraciu zátvorku, prípadne ctrl+A, ktorá vyvolá dialóg, v ktorom je možné hodnoty jednotlivých argumentov zadať interaktívne.

Pokiaľ je argumentom určitej funkcie zoznam, je možné jednotlivé hodnoty oddeliť čiarkami a získať tak napríklad hodnotu za niekoľko vymenovaných stredísk.

=AbraBalance(URL;meno;heslo;výčet účtů;datum;výčet středisek)
=AbraBalance(URL;Username;Password;"6";"31.12.2019";"000,100,400")

  • Funkcia GetTurnover vracia obraty z účtovného denníka a voliteľne aj z účtovných žiadostí. Má celkom 16 argumentov. 

    =GetTurnover(URL;meno;heslo;zoznam účtov;započítať žiadosti áno/nie;dátum od;dátum do;zoznam stredísk;strediská vrátane podradených áno/nie;zoznam zákaziek;zákazky vrátane podradených áno/nie;zoznam obchodných prípadov;obchodné prípady vrátane podradených áno/nie;zoznam projektov;projekty vrátane podradených áno/nie;zoznam firiem)

  • K dispozícii je tiež zjednodušený variant AbraTurnover:

    =AbraTurnover(URL;meno;heslo;zoznam účtov;dátum od;dátum do;zoznam stredísk;zoznam zákaziek;zoznam obchodných prípadov;zoznam projektov;zoznam firiem)

    Namiesto argumentov, ktoré sú vo funkcii GetTurnover naviac, sa pri použití funkcie AbraTurnover dosadia východiskové hodnoty: započítať žiadosti áno, strediská, zákazky, obchodné prípady a projekty bez podradených.

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Obrat na účtu 22110 za roky 2005 až 2010 včetně účetních žádostí na střediscích 000 a 100 (bez podřízených), ale jen za firmu s kódem 00002:

    =AbraTurnover(URL;Username;Password;"22110";"1.1.2005";"31.12.2010";"000,100";;;;"00002")

    Pokiaľ by bolo potrebné zmeniť niektoré argumenty nahradené vo funkcii AbraTurnover východiskovými hodnotami (napr. Nezohľadňovať účtovné žiadosti alebo započítavať strediská vrátane podradených), bolo by nutné použiť variant GetTurnover.

    Pokiaľ potrebujete zistiť obrat len na jednej strane účtu, použite v argumente zoznam účtov postfix -A (MD) alebo -B (Dal):

    =AbraTurnover(URL;Username;Password;"22110A";"1.1.2005";"31.12.2010";"000,100";;;;"00002")

    Argument zoznam účtov vykoná dohľadanie všetkých účtov, ktorých kód začína zadaným reťazcom. Pokiaľ nás teda zaujímajú všetky výnosové účty (trieda 6), nemusíme ich explicitne vymenovávať, ale zavoláme funkciu s nasledujúcimi argumentami:

    =AbraTurnover(URL;Username;Password;"6";"1.1.2005";"31.12.2010";"000,100";;;;"00002")

  • Posledným variantom je funkcia GetTurnoverSimple:

    =GetTurnoverSimple(URL;meno;heslo;dátum od;dátum do;obmedzenie)

    Podrobnosti k argumentu obmedzenia viď parameter conditions v popise zdroja turnover-simple.

Implementácia excelových funkcií GetTurnover a AbraTurnover realizujú dopytovanie zdroja turnover, GetTurnoverSimple dopytuje zdroj turnover-simple. V popise týchto zdrojov nájdete tiež podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetBalance slúži na získavanie informácií o zostatkoch účtov k určitému dátumu (z účtovného denníka, prípadne tiež z účtovných žiadostí).

    =GetBalance(URL;meno;heslo;zoznam účtov;započítať žiadosti áno/nie;dátum;zoznam stredísk;strediská vrátane podradených áno/nie)

  • K dispozícii je tiež zjednodušený variant AbraBalance:

    =AbraBalance(URL;meno;heslo;zoznam účtov;dátum;zoznam stredísk)

    Účtovné žiadosti sa pri použití funkcie AbraBalance započítavajú vždy, podradené strediská sa naopak nezapočítavajú nikdy.

    Od verze 23.1. došlo ke změně funkčnosti. Funkce doposud vracela u některých účtů hodnoty s opačným znaménkem než reporty v ABRA Gen a někdy dokonce i rozdílná čísla. Od verze 23.1. zadaný datumový parametr se použije jako datum od i do. Tím se data spočítají od nejbližší uzávěrky a zohlední se ručně změněné počátky účtů(např. fúzí firem). Došlo k celkové opravě a čísla z této funkce se nyní shodují s čísly, které vrací ABRA Gen v agendě Účtovné reporty v reportu Hlavní kniha - agenda.

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celkový zůstatek na účtu 02100 ke dni 31. 12. 2018.

    =AbraBalance(URL;Username;Password;"02100";"31.12.2018")

    Podobne ako v prípade funkcie AbraTurnover, pokiaľ nechceme započítať účtovné žiadosti a/alebo chceme započítať podradené strediská, je potrebné použiť variant GetBalance.

    Argument zoznam účtov vykoná dohľadanie všetkých účtov, ktorých kód začína zadaným reťazcom. Pokiaľ nás teda zaujímajú všetky výnosové účty (trieda 6), nemusíme ich explicitne vymenovávať, ale zavoláme funkciu s nasledujúcimi argumentami:

    =AbraBalance(URL;Username;Password;"6";"31.12.2018")

Implementácie excelových funkcií GetBalance a AbraBalance realizujú dopytovanie zdroja balance, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetStock slúži na získavanie informácií o stave skladu (počet, cena) k určitému dátumu podľa zvolených kritérií.

    =GetStock(URL;meno;heslo;typ informácie;dátum;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov)

    Typ informácie môže nadobúdať hodnôt q (počet) alebo a (skladová cena).

  • K dispozícii je tiež variant AbraStock, ktorá sa volá s rovnakými argumentmi, ide teda o synonymá.

    =AbraStock(URL;meno;heslo;typ informácie;dátum;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celkové množství položek ze skladového menu HW ke dni 31. 12. 2018 na skladoch s kódmi 01 a 02.

    =AbraStock(URL;Username;Password;"q";"31.12.2018";"HW";;;"01,02")

Implementácie excelových funkcií GetStock a AbraStock realizujú dopytovanie zdroja stock, v ktorého popise nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetMoves slúži na získavanie informácií o skladových pohyboch (počet, cena) za určité obdobie podľa zvolených kritérií.

    =GetMoves(URL;meno;heslo;typ informácie;dátum od;dátum do;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov;zoznam stredísk;strediská vrátane podradených áno/nie;zoznam zákaziek;zákazky vrátane podradených áno/nie;zoznam obchodných prípadov;obchodné prípady vrátane podradených áno/nie;zoznam projektov;projekty vrátane podradených áno/nie;zoznam firiem)

    Typ informácie môže nadobúdať hodnôt q (počet) alebo a (skladová cena).

  • K dispozícii je tiež variant AbraMoves, pri použití ktorého sa do výpočtu nezahŕňajú podradené strediská, zákazky, obchodné prípady a projekty (pokiaľ ich potrebujete začiarknuť, použite variant GetMoves; to isté platí pre ostatné funkcie).

    =AbraMoves(URL;meno;heslo;typ informácie;dátum od;dátum do;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov;zoznam stredísk;zoznam zákaziek;zoznam obchodných prípadov;zoznam projektov;zoznam firiem)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celková skladová cena zásob všech položek na všech skladech, se kterými byly provedeny skladové pohyby v roce 2019.

    =AbraMoves(URL;Username;Password;"a";"1.1.2019";"31.12.2019")

Implementácie excelových funkcií GetMoves a AbraMoves realizujú dopytovanie zdroja moves, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetSales slúži na získavanie informácií o predajoch skladových položiek (počet, predajná cena bez DPH) za určité obdobie podľa zvolených kritérií.

    =GetSales(URL;meno;heslo;typ informácie;dátum od;dátum do;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov;zoznam stredísk;strediská vrátane podradených áno/nie;zoznam zákaziek;zákazky vrátane podradených áno/nie;zoznam obchodných prípadov;obchodné prípady vrátane podradených áno/nie;zoznam projektov;projekty vrátane podradených áno/nie;zoznam firiem)

    Typ informácie môže nadobúdať hodnôt q (počet) alebo a (predajná cena bez DPH).

  • K dispozícii je tiež variant AbraSales, pri použití ktorého sa do výpočtu nezahŕňajú podradené strediská, zákazky, obchodné prípady a projekty (pokiaľ ich potrebujete začiarknuť, použite variant GetSale; to isté platí pre ostatné funkcie).

    =AbraSales(URL;meno;heslo;typ informácie;dátum od;dátum do;zoznam skladových menu;zoznam skladových typov;zoznam skladových kariet;zoznam skladov;zoznam stredísk;zoznam zákaziek;zoznam obchodných prípadov;zoznam projektov;zoznam firiem)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celková prodejní cena bez DPH všech položek prodaných v roce 2019.

    =AbraSale(URL;Username;Password;"a";"1.1.2019";"31.12.2019")

Implementácie excelových funkcií GetSales a AbraSale realizujú dopytovanie zdroja sale, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetReceivable slúži na získavanie informácií o pohľadávkach - vracia sumu zvoleného typu vypočítanú podľa zvolených kritérií.

    =GetReceivable(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;dátum splatnosti od;dátum splatnosti do;zoznam firiem;mena)

    Typ informácie môže nadobúdať hodnoty t (celkom), p (zaplatené), np (nezaplatené) alebo c (dobropisované). V prípade uvedenia nepovinného argumentu mena sa zohľadní len doklady vystavené v tejto mene.

  • K dispozícii je tiež variant AbraReceivable, ktorá sa volá s rovnakými argumentmi, ide teda o synonymá.

    =AbraReceivable(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;dátum splatnosti od;dátum splatnosti do;zoznam firiem;mena)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Dosud neuhrazená částka pohledávek vystavených v roce 2011 pro firmu 00011, v lokální měně.

    =AbraReceivable(URL;Username;Password;"np";"1.1.2011";"31.12.2011";;;"00011")

Implementácie excelových funkcií GetReceivable a AbraReceivable realizujú dopytovanie zdroja receivable, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetPayable slúži na získavanie informácií o záväzkoch - vracia sumu zvoleného typu vypočítanú podľa zvolených kritérií.

    =GetPayable(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;dátum splatnosti od;dátum splatnosti do;zoznam firiem;mena)

    Typ informácie môže nadobúdať hodnoty t (celkom), p (zaplatené), np (nezaplatené) alebo c (dobropisované). V prípade uvedenia nepovinného argumentu mena sa zohľadní len doklady vystavené v tejto mene.

  • K dispozícii je tiež variant AbraPayable, ktorá sa volá s rovnakými argumentmi, ide teda o synonymá.

    =AbraPayable(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;dátum splatnosti od;dátum splatnosti do;zoznam firiem;mena)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celková částka závazků vůči firmě 00006 z dokladů vystavených v roce 2018, v lokální měně, bez ohledu na stav zaplacení.

    =AbraPayable(URL;Username;Password;"t";"1.1.2018";"31.12.2018";;;"00006")

Implementácie excelových funkcií GetPayable a AbraPayable realizujú dopytovanie zdroja payable, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetDepreciation slúži na získavanie informácií o záväzkoch - vracia celkovú výšku účtovných alebo daňových odpisov vypočítanú podľa zvolených kritérií.

    =GetDepreciation(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;zoznam druhov majetku;zoznam účtovných odpisových skupín;zoznam daňových odpisových skupín;zoznam umiestenia;umiestenie vrátane podradených áno/nie;zoznam zodpovedných osôb;zoznam evidenčných stredísk;evidenčné strediská vrátane podradených áno/nie)

    Typ informácie môže nadobúdať hodnoty a (účtovné odpisy) alebo t (daňové odpisy).

  • K dispozícii je tiež variant AbraDepreciation, pri použití ktorého sa do výpočtu nezahŕňajú podradené umiestenia a podradené evidenčné strediská (pokiaľ ich potrebujete zahrnúť, použite variant GetDepreciation; to isté platí pre ostatné funkcie).

    =AbraDepreciation(URL;meno;heslo;typ informace;datum dokladu od;datum dokladu do;výčet druhů majetku;výčet účetních odpisových skupin;výčet daňových odpisových skupin;výčet umístění;výčet odpovědných osob;výčet evidenčních středisek)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celková výše daňových odpisů za rok 2018 za střediska 01 a 02.

    =AbraDepreciation(URL;Username;Password;"t";"1.1.2018";"31.12.2018";;;;;;"01,02")

Implementácie excelových funkcií GetDepreciation a AbraDepreciation realizujú dopytovanie zdroja depreciation, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

Pokiaľ pri používaní Web API zdroja depreciation uvediete parameter date-from (resp. vo funkcii GetDepreciation alebo AbraDepreciation v prostredí MS Excelu použijete argument dátum dokladu od), zahrnú sa do výpočtu len odpisy, ktoré sú zaúčtované.

V opačnom prípade (pokiaľ dátum dokladu od neuvediete) sa započítajú všetky odpisy bez ohľadu na zaúčtovanie.

Pokiaľ chcete získať hodnotu všetkých zaúčtovaných odpisov od začiatku odpisovania, parameter resp. argument špecifikujúci začiatok intervalu použite, ale ako počiatočný dátum uveďte 1.1.1900 (MS Excel) resp. 1900-01-01 (Web API).

  • Funkcia GetAsset slúži na získavanie informácií o stave majetku - vracia vstupnú alebo zostatkovú cenu vypočítanú podľa zvolených kritérií.

    =GetAsset(URL;meno;heslo;typ informácie;dátum dokladu od;dátum dokladu do;zoznam druhov majetku;zoznam účtovných odpisových skupín;zoznam daňových odpisových skupín;zoznam umiestení;umiestenia vrátane podradených áno/nie;zoznam zodpovedných osôb;zoznam evidenčných stredísk;evidenčné strediská vrátane podradených áno/nie)

    Typ informácie môže nadobúdať hodnoty tb (daňová vstupná cena), ab (účtovná vstupná cena), tr (daňová zostatková cena) alebo ar (účtovná zostatková cena).

  • K dispozícii je tiež variant AbraAsset, pri použití ktorého sa do výpočtu nezahŕňajú podradené umiestenia a podradené evidenčné strediská (pokiaľ ich potrebujete zahrnúť, použite variant GetAsset; to isté platí pre ostatné funkcie).

    =AbraAsset(URL;meno;heslo;typ informace;datum stavu;výčet druhů majetku;výčet účetních odpisových skupin;výčet daňových odpisových skupin;výčet umístění;výčet odpovědných osob;výčet evidenčních středisek)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Daňová zůstatková cena majetku ke dni 31. 12. 2018 priradeného osobe s ID 4000000101.

    =AbraAsset(URL;Username;Password;"tr";"31.12.2018";;;;;"4000000101")

Implementácie excelových funkcií GetAsset a AbraAsset realizujú dopytovanie zdroja asset, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

  • Funkcia GetPayroll slúži na získavanie informácií z oblasti miezd a personalistiky - vracia informácie rôznych typov vypočítanú podľa zvolených kritérií.

    =GetPayroll(URL;meno;heslo;typ informácie;zoznam mzdových období;zoznam druhov pracovných pomerov;zoznam stredísk;strediská vrátane podradených áno/nie)

    Typ informácie môže nadobúdať hodnoty n (počet mzdových listov), d (úväzky v hodinách), f (fond pracovnej doby), t (odpracovaná doba) alebo g (hrubá mzda).

  • K dispozícii je tiež variant AbraPayroll, pri použití ktorého sa do výpočtu nezahŕňajú podradené strediská. (Strediskami sa rozumejú strediská, na ktorých sú evidované pracovné pomery.) Pokiaľ podradené strediská potrebujete začiarknuť, použite variant GetPayroll.

    =AbraPayroll(URL;meno;heslo;typ informácie;zoznam mzdových období;zoznam druhov pracovných pomerov;zoznam stredísk)

    Inštalátor vložil do zošitu list API, na ktorom sme do bunky C3 pomenovanej URL zapísali URL Web API servera, do bunky C4 pomenovanej Username prihlasovacie meno a do bunky C5 pomenovanej Password heslo. Zvyšné argumenty zaistia, že sa v bunke zobrazí nasledujúca hodnota: Celková odpracovaná doba v hodinách za mzdové období 2018/12, pouze HPP.

    =AbraPayroll(URL;Username;Password;"t";"2018/12";"HPP")

Do argumentu zoznam mzdových období je potrebné odovzdávať kódy mzdových období v rovnakom tvare, v ktorom sú zadané v systéme ABRA Gen, tzn. napr. 2019/03 (nie 2019/3 alebo 2019/003). Nejde o položku zloženú z roka, lomky a poradového čísla mesiaca, ale o kód obdobia (textový reťazec).

Implementácie excelových funkcií GetPayroll a AbraPayroll realizujú dopytovanie zdroja payroll, v popise ktorého nájdete podrobnejšie informácie k jednotlivým parametrom.

Ako je uvedené v sekcii Inštalácia a nastavenie, pri používaní funkcií pre MS Excel resp. príslušných Web API zdrojov sa zohľadňujú práva k objektom. Web API zdroj payroll (a teda i funkcie GetPayroll a AbraPayroll) vyžadujú právo Zobraziť pre používané rady dokladov čiastkových mzdových listov.

  • abra-utils-installer.xlsm - Inštalátor slúžiaci na doplnenie potrebnej funkcionality do vašich vlastných zošitov. Podrobnejšie informácie nájdete v časti Nastavenie a inštalácia.

  • abra-utils-template-simple.xlsm - Vzorový zošit slúžiaci pre inšpiráciu, akým spôsobom je možné jednotlivé funkcie využívať. Obsahuje konkrétne ukážky použitia všetkých podporovaných funkcií. (Podobné zošity si budete vytvárať sami, podľa svojich špecifických potrieb.)

    AbraExcelAddIn.zip - ZIP balíček obsahuje 32 bitové i 64 bitové verze knihoven pro Excel a dalších potřebných souborů. Tento balíček stahujte v případě, že instalujete doplněk bez VBA skriptů.

V rozhraní Web API je implementovaná sada špeciálnych zdrojov, ktoré umožňujú jednoduché získavanie najrôznejších údajov z účtovníctva, skladového hospodárstva, predaja, pohľadávok a záväzkov, evidencie a odpisov majetku alebo miezd a personalistiky.

Všetky zdroje z tejto skupiny akceptujú dopyty v podobe GET požiadaviek (s parametrami odovzdávanými v URL) a vracajú odpovede vo formáte prostého textu (konkrétne číselné hodnoty). Pokud API odpoví chybou, vytvoří se chybová buňka s názvem "Není k dispozici".

Web API serveru zašleme požiadavku v nasledujúcom tvare:

GET http://localhost:81/demodata/utils/stock?date-to=2019-10-15&stores=04&store-cards=G04101&information-type=q

Obratom obdržíme odpoveď:

Status: 200 OK 

20

Jednoduchým spôsobom sme tak zistili, že sa na sklade 04 ku dňu 15. 10. 2019 nachádzalo 20 kg jabĺk (skladová karta s kódom G04101).

Aby bolo možné podobné informácie získavať a pracovať s nimi i bez detailných znalostí rozhrania Web API, tzn. bez nutnosti zostavovať URL s požiadavkami a odpoveďami nejakým spôsobom spracovávať, súčasťou rozšírenia je predpripravená sada funkcií pre MS Excel, ktoré tieto činnosti vykonávajú na pozadí (funkcie se dopytujú do Web API zdrojov, vrátené hodnoty sa zobrazujú v bunkách v excelovom zošite).

Na plné využitie funkcionality tak užívateľom postačujú znalosti základov práce v MS Exceli (používanie funkcií).

Do verzie 19.1 vrátane bola so systémom ABRA Gen dodávaná staršia verzia funkcionality, ktorá umožňovala zisťovať obraty na účtoch, tiež priamo prostredníctvom Web API alebo na Web API naviazaných funkcií v Exceli.

Táto pôvodná funkcionalita bola vo verzii 19.2 plne nahradená (balíček funkcií inštalovaných inštalátorom zahŕňa i funkcie GetTurnover a AbraTurnover), avšak je stále plne funkčná a pokiaľ vám pôvodné riešenie vyhovuje, môžete ho používať i naďalej, nižšie nájdete jeho popis.

S prechodom na verziu 19.2 alebo novšiu nemusíte doplnok alebo súčasné zošity nijak upravovať, ale pre ich používanie budete po novom potrebovať licenciu k modulu WebAPI doplnky.

Rozdiely oboch riešení:

Vlastnosť ABRA Gen 19.1 a nižšia ABRA Gen 19.2 a vyššia Poznámka
Spôsob inštalácie XLA doplnok do MS Excelu (GetTurnoverAPI.xla) XLSM inštalátor upravujúci jednotlivé zošity -
Umiestenie funkcií v doplnku priamo v zošitoch, v ktorých sa funkcie používajú -
Použiteľnosť funkcií v zošitoch XLS, XLSX, XLSM XLSM -
Pokrytých oblastí 1 (obraty na účtoch) 10 -
Licenčné požiadavky Web API Web API + WebAPI doplnky Verzia 19.2 a novšie umožňujú využívanie pôvodnej verzie riešenia (s XLA doplnkom), ale i pre ňu je po novom potrebná licencia k modulu WebAPI doplnky (od verzie 19.2 sú licencované všetky súvisiace WebAPI zdroje pre funkcie v MS Exceli, vrátane zdrojov turnover a turnover-simple).

V kapitole Vecný obsah, základné pojmy - AbraOLE je popsán doplněk pro aplikaci Excel NxTurnover.xla, který umožňuje získávat výstupní účetní přehledy přes ABRA OLE rozhranie. Podobná funkcionalita (tiež vo forme doplnku pre aplikáciu MS Excel a zošitu s ukážkami použitia) je dostupná tiež vo verzii využívajúca rozhranie Web API.

Rovnako ako OLE variant slúži tento doplnok na vytváranie prehľadov o účtovných obratoch na základe dát získavaných zo systému ABRA Gen v reálnom čase. Funkčne sú obe verzie zhodné, pokiaľ doposiaľ ani jednu z nich nevyužívate a máte možnosť voľby, zvoľte si túto Web API verziu.

Čo je na prevádzku potrebné:

  • Pridať do MS Office doplnok GetTurnoverAPI.xla, ktorý je súčasťou nainštalovaného produktu ABRA Gen (nájdete ho priamo v koreňovej zložke).

    V MS Office 2013/2016 doplnok nainštalujete postupnou voľbou položiek menu/funkciou Súbor, Možnosti, Doplnky, Spravovať: Doplnky Excelu, Prejsť, Prechádzať. Následne vyberiete GetTurnoverAPI.xla zo zložky, v ktorej máte nainštalovanú aplikáciu ABRA Gen.

  • Sprevádzkovať Web API.
  • Získať licenciu k modulu WebAPI doplnky.
  • Užívateľovi, ktorý bude k dátam prostredníctvom Web API pristupovať, nastaviť potrebné oprávnenia.

Použitie je patrné z ukážkového súboru GetTurnoverAPIExample.xls. V súbore sú použité funkcie definované v spomenutom doplnku GetTurnoverAPI.xla, konkétne GetTurnover, GetTurnoverSimple, Real a AbraTurnover. Tieto funkcie sa pripájajú do systému ABRA Gen prostredníctvom Web API rozhrania a vracajú obraty z účtovníctva na základe odovzdaných parametrov.

  • Funkcia GetTurnover:

    Funkcia vracia obraty z agendy Účtovný denník a voliteľne i z agendy Účtovné žiadosti. Zodpovedá metóde GetTurnover objektu BookEntry z OLE. Má celkom 16 parametrov.

    =GetTurnover(URL;meno;heslo;zoznam účtov;započítať žiadosti áno/nie;dátum od;dátum do;zoznam stredísk;strediská vrátane podradených áno/nie;zoznam zákaziek;zákazky vrátane podradených áno/nie;zoznam obchodných prípadov;obchodné prípady vrátane podradených áno/nie;zoznam projektov;projekty vrátane podradených áno/nie;zoznam firiem)

  • Funkcia GetTurnoverSimple:

    Funkcia vracia obraty z agendy Účtovný denník a voliteľne i z agendy Účtovné žiadosti. Zodpovedá metóde GetTurnoverSimple objektu BookEntry z OLE. Vrátane prihlasovacích údajov má len 6 parametrov, všetky obmedzenia sa funkcii odovzdávajú posledným parametrom vo forme štrukturovaného reťazca.

    =GetTurnoverSimple(URL;meno;heslo;dátum od;dátum do;obmedzenie)

  • Funkcia Real:

    Funkcia vracia obraty z agendy Účtovný denník a voliteľne i z agendy Účtovné žiadosti. Zodpovedá zjednodušenej metóde GetTurnover objektu BookEntry z OLE. Ide o zjednodušený variant funkcie GetTurnover - podradené dimenzie sa nikdy nezapočítavajú, žiadosti sa započítavajú vždy.

    = Real(URL;meno;heslo;zoznam účtov;dátum od;dátum do;zoznam stredísk;zoznam zákaziek;zoznam obchodných prípadov;zoznam projektov;zoznam firiem)
  • Funkcia AbraTurnover je synonymom funkcie Real.

Funkcie v niektorých prípadoch neberú do úvahy účty, kde sú v analytike zadané znaky používané ako riadiace znaky danej funkcie, tzn. D alebo MD. Napr. ak by sme mali účty s kódmi 520BYT a 520DUM. Funkcia by pre účet 520DUM vrátila chybnú hodnotu, keďže nerozlišuje znak obsiahnutý v kóde analitiky od riadiaceho znaku D pre určenie obratu na strane Dal. Preto funkcie pre takéto účty nevyužívajte. Podobne, ak by mal účet názov napr. 520MdBYT a pod.

Pokiaľ je GetTurnoverAPI.xla pridávaný do aplikácie Excel na terminálovom serveri (tzn. GetTurnoverAPI.xla je načítaný zo siete), je nutné pri jeho inštalácii nekopírovať doplnok do lokálnej knižnice (na toto je užívateľ pri importe doplnku dotázaný). Pokiaľ by došlo k jeho skopírovaniu, nebude funkčný.

Použitie funkcií a možný spôsob zadania parametrov je zrejmý z nasledujúceho obrázka. Pri funkcii Real resp. TurnoverAbra nie je možné nastavovať započítanie žiadostí a výpis vrátane podradených, viď vyššie, čo je v príklade zvýraznené tým, že sú príslušné bunky s hodnotami započítať žiadosti a vrátane podradených tmavo podfarbené.

Všetky štyri funkcie pri tomto zadaní vráti rovnakú hodnotu, tzn. obrat za rok 2008 na strane D účtov 343 s obmedzením za stredisko 000 bez podradených, z denníka i žiadostí. Ak by pri funkcii GetTurnover bolo nastavené započítať žiadosti=False, príp. ak by pri strediskách atď. bolo nastavené vrátane podradených=True, mohli by byť výsledné hodnoty pri oboch funkciách s ohľadom na konkrétne dáta iné.

Červené zvýraznenie naznačuje, ako sa rieši prihlásenie do API - URL k API vrátane aliasu spojenia, meno a heslo sú uložené v samostatných bunkách a vo vzorci s funkciou GetTurnaround sú použité odkazy na tieto bunky. Funkčná ukážka je k dispozícii v spomenutom súbore GetTurnaroundAPIExample.xls.

Web API požiadavka, ktorým uvedené VBA funkcie implementované v doplnku GetTurnoverAPI.xla získavajú požadované hodnoty, vyzerá napríklad takto:

http://localhost:699/data/bookentries/turnover?date-from=2008-01-01&date-to=2008-12-31&accounts=343MD&divisions=000&include-requests=true

Více informací viz popis zdrojů turnover a turnover-simple v kapitole Web API zdroje pro funkce v MS Excelu.