Parametre spustenia (predtým Pomenované skripty)

Parametry spuštění (dříve tzv. Pojmenované skripty) jsou definice běžných ABRA výrazů (expressions), které mají přiřazeno určité jméno. Jsou definované v rámci definic tisk. sestav či exportů. Jedná sa v zásade o nejaký výraz, ktorý sa v rámci spracovania výstupu vyhodnotí a vráti nejaký výsledok. Výsledkem může být např. jméno souboru, název tiskové sestavy, ale i např. adresa firmy použité v hlavičce tištěného dokladu, e-mailová adresa, na kterou má být výstup zaslán apod. Příslušný výsledek se použije při zpracování konkrétního tiskového výstupu.

Existují 2:

  • S defaultní hodnotou - tyto jsou nadefinované přímo v programu a platí pro všechny tisk. sestavy/exporty, přičemž není nutné je přímo v definici tisk.sestavy/exportu definovat. Např. FILENAME, BASENAME.

    Ak však v definícii zostavy resp. definovateľného exportu je definovaný parameter spustenia s rovnakým menom, tak táto definícia "prebije" definíciu defaultnú.

  • Bez defaultní hodnoty - ostatní, které nejsou výrobcem určené pro nějaké konkrétní použití a tudíž nemají dodávanou defaultní hodnotu. Tyto musí být nadefinované v definici konkrétní tisk. sestavy/exportu a platí jen pro daný tiskový výstup. Napr. EMAIL, EMAIL_SUBJECT a. i.

    Tieto je možné definovať:

Napr.:

  • Pri odosielaní výstupu e-mailom

    Pri odosielaní výstupu e-mailom sa výsledky parametrov spustenia (pomen. skriptov) pre daný výstup môžu odovzdávať ako parameter e-mailovému klientovi (napr. e-mailová adresa, na ktorú sa výsledok tlače posiela, meno súboru prílohy a pod.)
     

  • V příkazové řádce

    V príkazovom riadku je možné použiť tzv. "divoké premenné". Pro každou takovou proměnnou musí existovat parametr spuštění (pojmenovaný skript) téhož jména, jako je jméno divoké proměnné (buď to může být parametr spuštění (pojm. skript) s defaultní hodnotou nebo to musí být parametr spuštění (pojm. skript) definovaný v sestavě resp. exportu). Hodnota, ktorá vznikne po vyhodnotení daného parametra spustenia (pomen. skriptu), sa potom dosadí za príslušnú divokú premennú:

    c:\Program Files\Adobe\Reader 11.0\Reader\AcroRd32.exe %FileName%

    Príklad príkazového riadka s príkazom zadaným pred exportom s divokou premennou FILENAME. Spôsobí otvorenie aplikácie Notepad z definovanej cesty a v nej potom súboru s dátami, ktoré budú výsledkom zvoleného def. exportu

    V příkazové řádce lze jako divoké proměnné použít i parametry spuštění defaultně dodávané pro odesílání na e-mail (jako např. EMAIL).

Ide o parameter spustenia (pomenovaný skript) s defaultnou hodnotou.

Pokud se chcete v rámci zadávaného příkazu odvolat na vytvořený soubor, musíte se odvolat na toto jméno.Každý tvořený soubor (např. uložením tiskového výstupu či zpracováním def. exportu) musí mít definováno jméno. Meno tohto súboru je defaultne generované systémom do dočasného adresára tak, aby bolo jednoznačné. Pro akci odvolání se na jméno takového dočasného souboru v příkazu je určen právě parametr spuštění FILENAME, který jako hodnotu vrací právě defaultně přidělené jméno souboru, které přiděluje ABRA Gen (pro generování defaultního jména ABRA Gen používá interní identifikátor GUID).

Objasníme na príklade:

U dokladů Faktúra vydaná si nastavíme, že po uložení chceme Tisknout rovnou do souboru (např. formátu pdf). Po uložení do súboru ale ešte budeme chcieť vyvolať prehliadač *.pdf súborov Acrobat Reader na vizuálnu kontrolu výstupu. Potom môže príkaz vyzerať napr. nasledovne:

c:\Program Files\Adobe\Reader 11.0\Reader\AcroRd32.exe %FileName%

Potom sa po uložení dokladu tento uloží do dočasného adresára Windows (napr. c:\users\jan.novak\appdata\local\temp\)) a vyvolá sa prehliadač pdf súborov, kde sa vytlačený doklad zobrazí.

Pokiaľ chcete mať súbor uložený pod iným názvom, môžete to urobiť napr. tak, že si v príkaze vyvoláte nejakú dávku (*.bat), ktorej ako parameter pridáte defaultne generovaný názov súboru a v ktorom si nadefinujete premenovanie daného súboru, napr. na súbor iného typu, uloženie do zadanej cesty a pod.

Pri faktúrach vydaných si nastavíme, že po uložení chceme Tlačiť priamo do súboru (napr. do formátu pdf). Po uložení do súboru ale ešte budeme chcieť, aby sa premenoval a uložil inam. Potom môže príkaz vyzerať napr. nasledovne:

c:\rename.bat %FileName%

Pričom *.bat dávka môže definovať

@echo off
set MenoSuboru=%1
echo Toto je vytvorene meno suboru: %MenoSuboru%
pause
copy %JMenoSuboru% c:\report\faktura.pdx

Pak se po uložení dokladu tento uloží do dočasného adresáře Windows (např. c:\users\jan.novak\appdata\local\temp\) a soubor s fakturou se uloží do adresáře c:\report pod názvem "faktura.pdx".

Pokud byste chtěli, aby systém ABRA Gen ukládal rovnou soubor do jiného formátu a cesty, pak si do dané tisk. sestavy můžete jednoduše nadefinovat svůj vlastní parametr spuštění FILENAME tak, aby se generovalo jméno souboru dle vašich potřeb. Tato definice pak pro danou sestavu resp. export "přebije" parametr spuštění FILENAME defaultně dodávaný. (Viz výše Parametry spuštění sdefaultní hodnotou.)

Objasníme na príklade:

Do zostavy si nadefinujeme parameter spustenia (pomen. skript) s menom FILENAME s jednoduchou definíciou:

'c:\report\zaloha.pdf'

Do príkazového riadka v rámci Nastavenia tlače do súboru po uložení príkaz:

c:\Program Files\Adobe\Reader 11.0\Reader\AcroRd32.exe %FileName%

Potom sa teda po uložení dokladu vyvolá tlač danej tlač. zostavy do súboru, tlač sa uloží do súboru C:\report\zaloha.pdf a vyvolá sa prehliadač pdf súborov, kde je vytlačený doklad k dispozícii.

Ide o parameter spustenia (pomenovaný skript) s defaultnou hodnotou.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání názvu přiloženého souboru, ke kterému se připojí přípona odpovídající zvolenému formátu. Tisk se v tomto případě provádí do souboru náhodného jména, který se následně přejmenovává na jméno dané definicí parametru spuštění BASENAME.

Pokud tisk. sestava odesílá opakovaně (např. pro různé doklady), pak vzniká opakovaně soubor téhož jména. V takom prípade je pôvodný súbor (z predchádzajúcej tlače) nahradený novým. Tzn. ak súbor s daným menom už existuje (premenovanie sa nepodarilo), prebehne prekopírovania a následne odstránenie kopírovaného súboru. Istá nevýhoda tohto riešenia je v tom, že pokiaľ sa súbor nepodarí prekopírovať (napr. ak je otvorený nejakou aplikáciou), tak systém nahlási chybu a nie je možné v tlači pokračovať.

Pokud není parametr spuštění BASENAME v rámci dané tisk. sestavy/exportu definován, použije se defaultně vrácená hodnota.

Defaultní hodnota záleží na výběru možnosti z dialogu Zvolte co tisknout:

  • Aktuální záznam - DisplayName tohoto záznamu, tj. například "FV-1_2018.pdf" (lomítko je nahrazené podtržítkem, protože lomítko není možné používat v názvech souborů)
  • jiná možnost - název tiskové sestavy doplněný zprava o řetězec s datem a časem vzniku souboru ve formátu "-yyyy_mm_dd hh-nn". Např. výtisk faktur vydaných posílaných e-mailem se bude jmenovat "Formulář faktury vydané-2017_12_20 18-05.pdf".

Istá nevýhoda tohto riešenia spočíva v tom, že sa v dočasnom adresári  "množia" odosielané súbory.

Ide o parameter spustenia (pomenovaný skript) bez defaultnej hodnoty, takže musí byť definovaný v rámci definície tlač. zostavy/exportu. exportu.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání adresy příjemce, kterému má být zaslán e-mail.

V rámci některých defaultně dodávaných tiskových sestav (např. tisk dokladu Faktúra vydaná) je již předdefinován od výrobce. Využívá QuickReports funkci "NxGetDefaultEmail", která přihlíží k hodnotě firemního parametru Pořadí pro určení e-mailu při odeslání dokladů a podle toho vrací e-mail sídla firmy z hlavičky dokladu nebo z provozovny či osoby zadané na dokladu příp. dle hodnot parametru zobrazí dialog Kontakty dle omezení pro výběr e-mailové adresy na základě Firmy, Provozovny a Osoby a uživatel si vybere interaktivně.

Vystavené faktúry budeme chcieť tlačiť do súboru a odosielať klientom e-mailom, e-mailovú adresu chceme zisťovať z údajov prevádzkarne firmy uvedenej na doklade. Pre maximálnu automatizáciu celého procesu si v agende faktúr vydaných vo funkcii Nastavenie tlače po uložení definujeme, že po uložení faktúry sa má Odoslať výstup mailom, zvolíme formát, napr. pdf a zvolíme príslušnú tlačovú zostavu. V rámci vlastností tlač. zostavy, ktorú pre tlač dokladu budeme používať, musí byť definovaný skript s menom EMAIL, ktorý bude danú adresu zisťovať:

Príklad nadefinovaného skriptu na vrátenie e-mailovej adresy.

Ako náhrada za funkciu "NxGetDefaultEmail" by sa do pomenovaného skriptu EMAIL mohla využiť priamo QuickReports funkcia "NxEmailAddressesDialog", ktorá zobrazuje dialóg Kontakty podľa obmedzenia na výber e-mailovej adresy interaktívne (čo je to isté správanie, ako keď má parameter Poradie pre určenie e-mailu pri odoslaní dokladov hodnotu Interaktívne). Túto možnosť môžete využiť vtedy, pokiaľ by ste nechceli mať všeobecne v danom parametri hodnotu Interaktívne (aby sa dialóg neponúkal vždy), ale aby sa pritom ponúkol napr. iba pri odosielaní vybraných tlač. zostáv a pod.

Rovnaký skript ale môže byť samozrejme využitý aj v rámci použitia príkazov pre náhradu divokých premenných (viď vyššie Použitie pomenovaných skriptov). Príkladom môže byť aj odoslanie výstupu e-mailom, ktoré ale budeme realizovať zadaným príkazom pri uložení Tlače do súboru v rámci funkcie Nastavenie tlače po uložení. Pokiaľ teda máte k dispozícii nástroj, ktorý dokáže odoslať mail na definovanú adresu s vytvoreným súborom ako prílohou, môžete si do príkazu nadefinovať spustenie takéhoto nástroja s divokou premennou %EMAIL%.

Skript nadefinovaný vyššie môžeme využiť aj na nahradenie divokej premennej rovnakého mena v príkazovom riadku. Môžeme tak zaistiť iný spôsob odoslania e-mailu. Potom musíme mať k dispozícii nejaký program, ktorý dokáže odoslať mail na definovanú adresu s vytvoreným súborom ako prílohou. Využiť môžete napr. aplikáciu BLAT.exe alebo aplikáciu MAPISend.exe, ktoré sú zdarma dodávané ako súčasť inštalácie, ale môžete využiť aj ľubovoľný iný svoj vlastný. Pokiaľ použijete Blat.exe a máte ho už správne nakonfigurovaný, môže príkaz vyzerať napr. nasledovne:

blat c:\email.txt -to %Email% -attach %FileName%

Ďalšie príklady viď popis aplikácie Blat.exe a popis aplikácie MAPISend.exe.

Ide o parameter spustenia (pomenovaný skript) bez defaultnej hodnoty, takže musí byť definovaný v rámci definície tlač. zostavy/exportu. exportu.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání adresy příjemce, kterému má být zaslána kopie e-mailu.

Ide o parameter spustenia (pomenovaný skript) bez defaultnej hodnoty, takže musí byť definovaný v rámci definície tlač. zostavy/exportu. exportu.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání adresy skrytého příjemce, kterému má být zaslána kopie e-mailu.

Ide o parameter spustenia (pomenovaný skript) s defaultnou hodnotou.

Defaultně vrací název tiskové sestavy/exportu.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání textu do položky "Předmět" nového vytvářeného e-mailu.

Ide o parameter spustenia (pomenovaný skript) bez defaultnej hodnoty, takže musí byť definovaný v rámci definície tlač. zostavy/exportu. exportu.

Je určený na odosielanie výstupu e-mailom. Slouží pro získání "těla" nového vytvářeného e-mailu, typicky nějakého textu.

Není-li parametr použit, tělo mailu se získává z položky Výchozí text v nastavení e-mailového účtu (je-li vyplněna).

V systéme sa podľa potreby môžu vyskytnúť ešte ďalšie parametre spustenia (pomenované skripty). Napr.:

  • CommDocDescription - Musí byť definovaný v rámci definície tlač. zostavy resp. def. exportu. Je určený na predvyplnenie položky Popis v rámci tvorby Dokumentu z definovateľného exportu.
  • CommDriver - Určený na špecifikáciu ovládača, ktorý sa má použiť na spracovanie daného exportu. Musí byť preto definovaný priamo v rámci daného exportu.

Využíval sa do v. 9.02 vrátane, kde sa z definovateľného exportu tvoril tzv. Doklad komunikácie a kde bolo nutné podľa typu exportu zvoliť príslušný ovládač. Aby mohol užívateľ jednoduchšie vybrať správny ovládač pre daný typ exportu príspevkov DDS ovládač pre DDS príspevky), bol v definíciách exportov nastavený ovládač, ktorý sa má pre daný export použiť (predvyplniť) pomocou parametra spustenia (pom. skriptu) "CommDriver". (Ovládače sú vnútorne identifikované pomocou CLSID triedy drivera, meno drivera zobrazované užívateľovi sa odvodzuje z jeho registrácie v repository.)

Od v. 9.03 bola agenda Doklady komunikácie zrušená a nahradená agendou Dokumenty. Z daného exportu je teda možné vytvoriť dokument do agendy "Dokumenty" a to dokument zvolenej kategórie. Ďalšie spracovanie dokumentu s daným exportom opäť zabezpečuje príslušný ovládač (driver), viď Spracovanie dokumentov, ale ten je určený už v rámci definície zvolenej kategórie dokumentu. Užívateľ teda pred tvorbou dokumentu nevolí priamo ovládač, ale volí kategóriu dokumentu, pričom kategória dokumentu sa predvypĺňa podľa toho, ako je zadaná v položke Kategória dokumentu v definícii exportu.