ESO9 wiki

Výchozím formátem všech tiskových sestav v obecném klientovi je jazyk HTML. V klientovi pro Internet Explorer (IE) se v řadě případů navíc používaly pro tiskové výstupy různé ActiveX prvky, což samozřejmě v obecném klientovi možné není. Z toho vyplývají určité rozdíly oproti výstupům z klienta pro IE. Pro veškeré ukázky budou použity formulář a sestava faktury vydané. Všechny uvedené typy tiskových výstupů jsou použity v obecném klientovi beze změn oproti IE; cílem je tedy bezešvý provoz stejné aplikace v obou dostupných klientech.

Opis dat libovolné formy do textu je realizován stejně, jako v klientovi pro Internet Explorer, tj. otevře se nové okno obsahující textová data a tlačítko pro kopii dat do clipboardu:

Opis dat do XLS (MS Excel) probíhá v obecném klientovi do nového okna s tabulkovým zobrazením dat a možností exportu obsahu okna do Excelovského sešitu, který se uživateli nabídne ke stažení/otevření:

Běžný tisk sestavy Stimulsoft v obecném klientovi směřuje do výchozího prohlížeče, který vypadá a funguje podobně, jako výchozí prohlížeč známý z prostředí Internet Exploreru (pouze tím rozdílem, že se zobrazuje přímo v pracovním okně prohlížeče):

Z prohlížeče lze sestavu vytisknout, uložit do souboru nebo odeslat e-mailem. Pokud zvolíme přímý tisk na tiskárnu (ikona tiskárny v levém horním rohu), provede se na pozadí tisk do formátu PDF a výsledek se následně nabídne k tisku. Formát PDF zajistí tisk v podobě nejbližší definovanému vzhledu sestavy. Vlastní tiskový náhled se může v jednotlivých prohlížečích mírně lišit, takto vypadá např. v Google Chromu:

Pokud chceme sestavu na monitoru uložit do souboru, použijeme ikonu na nástrojové liště vlevo nahoře:

Sestavu lze uložit do formátů Adobe Reader (PDF), Microsoft Word (DOCX) a Excel (XLSX). V budoucnu mohou přibývat další formáty.
Při uložení sestavy lze ovlivnit další chování systémovým parametrem DMS_OtevritPrimo:

Pokud má parametr hodnotu „1“, pokusí se prohlížeč zobrazit daný soubor přímo bez použití software třetích stran. V daném případě to znamená, že namísto stažení PDF souboru a jeho otevření v Adobe Acrobat Readeru se PDF soubor otevře přímo v prohlížeči v pracovním okně ESO9:

Přímo z okna prohlížeče lze sestavu odeslat e-mailem. Opět k tomu slouží ikona na nástrojové liště vlevo nahoře a stejně jako v předchozím případě si lze i při odesílání sestavy vybrat mezi přílohou ve formátu PDF, Word nebo Excel. Vytištěná sestava se přiloží v e-mailu, který se ve formátu EML stáhne na klienta:
Stažený soubor lze otevřít v libovolném e-mailovém klientu (např. Microsoft Outlook na obrázku níže), kde lze doplnit adresu příjemce, předmět a text e-mailu nebo případně přidat další přílohy a e-mail odeslat.
Další variantou je automatické odesílání sestav e-mailem, v tom případě se však sestava vůbec netiskne na monitor a pro práci s ní se používají jiné mechanismy, které jsou popsány v dokumentaci pro implementátory.

Pokud si chceme stažený (EML) soubor rovnou automaticky otevřít, postačí u staženého souboru kliknout na tři tečky:
… a zaškrtnout volbu „Vždycky otevírat soubory tohoto typu“:

Jedná se o velmi užitečnou možnost při práci s Excelem (soubory .XLSX) či e-maily (soubory .EML), která ušetří minimálně jedno kliknutí.

E-mailový klient Thunderbird bohužel neumí zobrazit e-mail ve formátu EML tak, aby jej bylo možné přímo editovat. Tato chyba je popsána např. na https://bugzilla.mozilla.org/show_bug.cgi?id=166541. Chybu řešil Add-On (https://addons.thunderbird.net/en-US/thunderbird/addon/x-unsent-support/), který již ale není pro aktuální verzi Thunderbirdu funkční. Jediným řešením v je nyní volba Message - Edit As New Message (Ctrl + E). Doporučujeme tedy používat jiné e-mailové klienty.

Kromě sestav z generátoru jsou v ESO9 dostupné i tzv.IDC/HTX sestavy; jedná se v podstatě o běžné HTML sestavy vygenerované do pracovního okna prohlížeče. Jejich tisk je dostupný z kontextového menu (pravé tlačítko myši) pod volbou „Tisk“. Tisk se provede do nového okna prohlížeče, který naformátuje sestavu dle svých možností a nabídne ji k tisku.

IDC/HTX sestavy lze odesílat e-mailem stejným způsobem, jako sestavy z generátoru Stimulsoft (viz tedy výše). Odeslání je dostupné z kontextového menu (pravé tlačítko myši) pod volbou „Odeslat e-mailem“. Parametry použité k odesílání IDC/HTX sestav jsou stejné, jako v případě sestav z generátoru Stimulsoft.

Dalším typem sestav, které lze vytvářet přímo v aplikaci ESO9, jsou sestavy typu XLS (tj. tisk dat do Excelu). V obecném klientovi jsou tyto sestavy automaticky převedeny do stejného formátu, jako opis dat do XLS, tj. tabulka se vzhledem Excelu a možností na jedno tlačítko uložit data do sešitu MS Excelu. Vlastní data pro sestavu se berou z položky „Ruční SQL“ formuláře „Datový zdroj sestavy“.

Generátorové sestavy typu HTML jsou zobrazeny v obou klientech identicky, protože formát jazyka HTML interpretují všechny prohlížeče (zhruba) stejně.

Sestavy typu PIVOT slouží v obecném klientovi k zobrazení kontingenčních tabulek a grafů. Primárně se datové zdroje vytisknou do kontingenční tabulky:

V kontingenční tabulce lze obvyklým způsobem přehazovat dimenze či filtrovat jejich obsah. Kromě toho lze data zobrazit i v tzv.heatmaps (síla podbarvení buňky koresponduje s jejím datovým obsahem) nebo grafech několika typů.

Výsledný vzhled si lze uložit do uživatelských konfigurací.

Pokud sestava Stimulsoft kopíruje typicky některý z formulářů pro státní správu, používá k tomu naskenovaný obrázek formuláře na pozadí sestavy. Obrázek na pozadí nelze ve Stimulsoftu převést do (výchozího) formátu HTML, resp. při převodu dojde k jeho ztrátě. Pokud se tedy tiskne Stimulsoft sestava s obrázkem na pozadí, technologie to rozpozná a převede tuto sestavu do formátu PDF, ve kterém se sestava zobrazí korektně. V ESO9Start se jedná např. o výkaz DPH v odevzdatelném tvaru:

Při tisku Stimulsoft sestav do výchozího formátu dochází k jejich implicitnímu převodu do jazyka HTML. Vzhledem k jeho složitosti (cílem je zobrazit sestavu graficky co nejvěrněji předloze) však dochází při velkém počtu stránek (cca 50 a více) ke zpomalení práce se sestavou v klientském prohlížeči. Řešením je použít pouze řádkový formát sestavy bez grafiky - HTML2:

Pro pracovní tvar sestav (např. hlavní kniha nebo detaily jejích jednotlivých účtů) je takto vygenerovaná sestava a práce s ní podstatně rychlejší.

Stále přitom zůstává možnost i z pracovního tvaru HTML2 vygenerovat sestavu např. do PDF ikonou na záhlaví.

Pokud je cílovým formátem Stimulsoft sestavy jazyk HTML (STI/STIMHT), bude mít webový prohlížeč výkonový problém takovou sestavu zobrazit v případě, že bude obsahovat vyšší tisíce řádků (5-10 dle složitosti sestavy). Pro tyto případy je v aplikacích ESO9 parametr HTMLRepMaxDataRows, který zajistí automatické přepnutí sestavy do formátu PDF, překročí-li počet řádků sestavy hodnotu tohoto parametru. Formát PDF je binární a nezatěžuje svým zobrazováním webový prohlížeč tak, jako generování HTML kódu.

Pokud je cílovým formátem Stimulsoft sestavy PDF (nebo dojde k přepnutí formátu HTML na PDF vlivem parametru HTMLRepMaxDataRows), lze v rozumném čase (cca do 30 sekund) vygenerovat sestavu s cca 100 tis. řádky. Pokud bude počet tištěných řádků vyšší, je výhodnější takovou sestavu vytisknout do formátu XLSX (Excel), který sice nebude obsahovat vizuál, ale uživatel se požadovaným datům dostane významně rychleji. Aby nebylo nutné před tiskem sestavy přemýšlet, kolik řádků bude sestava obsahovat, existuje parametr PDFRepMaxDataRows, který říká, při jakém počtu tištěných řádků se formát PDF automaticky přepne na formát XLSX (Excel).

V případě, že je třeba na obrazovku zobrazit sestavu bez ovládacího toolbaru, je možné využít url parametr GENREPTOOLBAR=0.

Pro export velkého množství dat (cca 1+mil.řádků) z ESO9 je vhodnější použít např. MS SQL Server Integration Services, Reporting Services nebo jiný externí nástroj. Pokud však uživatelé potřebují získat data ihned (tj. „na kliknutí“), je řešením použít přímý export do CSV. Sestavy s typem výpisu CSV mohou mít více datových zdrojů, vlastní data pro sestavu se berou z položky „Ruční SQL“ formuláře „Datový zdroj sestavy“. Exportuje se celý výsledek datového zdroje (při tomto objemu řádku by přeskládávání sloupců zdržovalo). Sloupce jednotlivých datový zdrojů si lze uživatelsky pojmenovat ve formuláři „Sloupec datového zdroje sestavy“, sloupce, které zde nebudou vyjmenovány, se vyexportují s technickými jmény v záhlaví. Každý datový zdroj se bude exportovat do odděleného CSV souboru, všechny soubory se pak zaZIPují do jediného archivu, který se uploadne na klienta (velikost CSV souborů se pohybuje ve stovkách MB, komprimace je nutná pro přenos na klienta). Uvedený typ exportu je vhodný pro data v rozsahu řádově milionů řádků. Výsledek se uploadne na klienta ve formátu ZIP (velikost souborů se pohybuje ve stovkách MB, je nutné je zaZIPovat), ten pak obsahuje tolik souborů, kolik má sestava datových zdrojů.
Další parametry pro tisk do CSV (uvádějí se na odkazu):

• NOQUOT=1 - položky nebudou uzavřeny v uvozovkách
• DELIMITER=1/2/3 - volba oddělovače: 1=čárka, 2=středník nebo 3=tabulátor.
• NOZIP=1 - výsledek exportu se nebude zaZIPovávat, ale pošle se přímo jako CSV soubor. V případě, že má export více datových zdrojů, pošle se tímto způsobem pouze první. Pro větší počet vět (1+ mil.) může mít CSV soubor řádově stovky MB.