** Popis zahŕňa manuálne vytvorenie udalosti, download a kontrolu obsahu. **

===== Manuálne vloženie udalosti do SQL databázy =====
Na testovacie účely sa využíva databáza centrum na serveri Ares.

=== Blokovacia udalosť ===
Príklad blokovacej udalosti v tabuľke zuc_Udalosti:

{{dev_doc:udalost_blokovanie.png|}}

=== Vklad na elektronickú peňaženku ===
Príklad udalosti vkladu na EP v tabuľke zuc_Udalosti:

{{dev_doc:udalost_vklad.png|}}

  * do stĺpca CisloUdalosti treba zadať hodnotu o 1 väčšiu ako je zapísaná na karte.
  * do stĺpca Hodnota sa zadáva suma vkladu na EP v najmenšej jednotke meny, t.j. v centoch

=== Zápis časového lístka ===
Pre zápis časového lístka je potrebné vytvoriť dva záznamy. Jeden v tabuľke zuc_Udalosti a druhý v tabuľke zuc_PrepaidTicket.

Príklad udalosti pre zápis časového lístka:

Záznam v tabuľke zuc_Udalosti

{{dev_doc:udalost_pcl.png|}}

Záznam v tabuľke zuc_PrepaidTicket

{{dev_doc:udalost_pcl_zucprepaidticket.png|}}

  * UdalostID - v tomto stĺpci musí byť kvôli spárovaniu rovnaká hodnota ako v stĺpci UdalostID v tabuľke zuc_Udalosti\\
  * PrepaidTicketTypeID - pre lístky IDS BID sa zadáva hodnota 2, pre ostatné hodnota 1\\
  * TariffZone - riadok cenníka\\
  * ProductID - číslo tarifného lístka\\
  * TariffZones - zoznam zón oddelený čiarkami, v prípade celosieťového časového lístka sa zadáva hodnota -999\\

===== Stiahnutie udalostí z web služby do súboru =====
Na vygenerovanie a download binárneho súboru s udalosťami sa používa testovacia web-aplikácia na adrese [[http://eshop.dopravnakarta.test/Tools/]].\\
Po spustení je potrebné zadať prihlasovacie údaje.\\
** Email: ** admin\\
** Heslo: ** admin\\

{{dev_doc:webapp_login.png|}}

Po úspešnom prihlásení sa zobrazí okno aplikácie.

{{dev_doc:webapp.png|}}

Pred spustením generovania (tlačidlo "Vygeneruj prírastkový udalostný súbor") je nutné zadať vstupné parametre. 

  * ** Výber závodu ** - Povinný parameter, bez ktorého aplikácia nevygeneruje súbor. Závod sa vyberá označenim riadku v preddefinovaných závodoch (niečo na spôsob rýchlej voľby) alebo výberom z databázy všetkých závodov.

  * ** Výber web-služby ** - Povinný parameter.
    * ** EmcardWebService URL ** - služby v tejto časti generujú binárny súbor, ktorý používajú aplikácie v palubných počítačoch, autobusových čítačkách, revízorských čítačkách Telefunken a M3 a v samoobslužných automatoch. Na testovacie účelz sa používa služba označená na obrázku.
    * ** TDEvents Generator URL ** - služby v tejto časti generujú súbor vo formáte json, ktorý používa revízorská aplikácia na platforme Android.

  * ** Posledné UdalostID ** - Povinný parameter. Defaultne ponúka program hodnotu 0, vtedy vygeneruje z databázy všetky udalosti pre vybratý závod, ale je možné (napr. kvôli veľkosti súboru) zadať ľubovoľné ID udalosti.

  * ** SNR zariadenia ** - Povinný parameter. Neovplyvňuje generovanie súboru. Slúži iba na identifikáciu zariadenia, ktoré posiela službe požiadavku na generovanie súboru.

  * ** SNR karty ** - Nepovinný parameter. Používa sa vtedy, ak je potrebné vygenerovať udalosti pre konkrétnu kartu.

Po nastavení všetkých parametrov sa na vygenerovanie a stiahnutie súboru použije podľa potreby príslušné tlačidlo.

  * ** Vygeneruj prírastkový udalostný súbor ** - vygeneruje súbor pre všetky karty podľa vybratého dopravcu od zvoleného id udalosti. Aby aplikácia vygenerovala súbor, musí byť vybratá niektorá zo služieb v časti EmcardWebService URL.

  * ** Vygeneruj súbor pre kartu ** - vygeneruje súbor pre konkrétnu kartu podľa zvoleneho id udalosti a vybratého dopravcu. Aby aplikácia vygenerovala súbor, musí byť vybratá niektorá zo služieb v časti EmcardWebService URL.

  * ** Vygeneruj nový JsonGzip udalostný súbor ** - vygeneruje súbor vo formáte json pre revízorskú aplikáciu na platforme Android. Aby aplikácia vygenerovala súbor, musí byť vybratá niektorá zo služieb v časti TDEvents Generator URL.

===== Obsah udalostného súboru - prehliadač EventViewer =====

Program je uložený na: \\hades\Dokumentacia\WinAD_SOFT\InterneEXE\IFC

Prehliadač pracuje iba s binárnym súborom, nedokáže spracovať json súbor. Aby bolo možné prezerať udalosti, musí sa súbor z web-služby rozdeliť na dve časti (.idx a .dat). Po načítaní .idx súboru sa zobrazi zoznam všetkých vygenerovaných udalostí.

  * ** Rozdelenie súboru: **
- pre rozdelenie treba zadať voľbu ** split ** z menu ** Tools **.\\
{{dev_doc:eventviewer_splitmenucommand.png|}}\\
- zobrazí sa okno pre zadanie cesty k vstupnému súboru. Je tu tiež možnosť zvoliť názov výstupného súboru, predvolený je "events".\\
{{dev_doc:eventviewer_splitparams.png|}}\\
- po úspešnom rozdelení sa súbory uložia do rovnakého priečinka, z ktorého sa spúšťa program a zobrazí sa potvrdzovací message-box\\

  * ** Prehliadanie udalostí: **
- pre zobrazenie zoznamu udalostí treba zadať voľbu ** open event file ** z menu ** File **\\
{{dev_doc:eventviewer_openmenucommand.png|}}\\
- po načítaní súboru sa v ľavej časti okna zobrazí zoznam udalostí\\
{{dev_doc:eventviewer_loadedevents.png|}}\\
- označením niektorej z udalostí v zozname sa v pravej časti zobrazia detaily\\
- pre zobrazenie udalostí iba pre konkrétnu kartu sa dá použiť filtrovanie ** Filter by SNR ** - textbox v pravej časti okna