Dokumentace HELIOS Mobile - Příspěvky uživatele [cs]

Konfigurace v HELIOS Green

2021-05-26T14:17:21Z

Pnedoma: /* Výrazy */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''None''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami. (Jen směrem z položky na hlavičku - prefix '''M.'''xxx)
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy. (Také už není úplně pravda, umíme se odkazovat třeba na dynamické vztahy.)

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje. Další vhodné použití je pro konstantní hodnoty.

{{Sample|Příklad - Aktuální měsíc jako číslo (bez nuly na začátku):}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2021-05-26T14:16:00Z

Pnedoma: /* Výrazy */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''None''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami. (Jen směrem z položky na hlavičku - prefix '''M.'''xxx)
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje. Další vhodné použití je pro konstantní hodnoty.

{{Sample|Příklad - Aktuální měsíc jako číslo (bez nuly na začátku):}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2021-05-04T09:53:15Z

Pnedoma: /* Podporované parametry XML tagu column */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''None''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje. Další vhodné použití je pro konstantní hodnoty.

{{Sample|Příklad - Aktuální měsíc jako číslo (bez nuly na začátku):}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-05-31T09:03:13Z

Pnedoma: /* Výraz */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje. Další vhodné použití je pro konstantní hodnoty.

{{Sample|Příklad - Aktuální měsíc jako číslo (bez nuly na začátku):}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-05-31T09:02:27Z

Pnedoma: /* Výraz */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje. Další vhodné použití je pro konstantní hodnoty.

{{Sample|Příklad:}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-05-31T06:22:44Z

Pnedoma: /* Parametr MobileDefault */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozí hodnoty atributu pro nové záznamy a položky.

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

=====Aktuální čas=====

Datumové a časové atributy jsou v HELIOS Mobile ukládány jako řetězec ve formátu ''yyyy-MM-ddTHH:mm:ss''. Hodnota ''24.12.2018 21:23'' bude v tomto formátu vypadat takto: ''2018-12-24T21:23:00''.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

=====Výraz=====
Zápis výrazu je shodný jako v případě parametrů Expr, Invisible a Protect, jen musí být uzavřený do složených závorek. Není možné používat hodnoty atributů a vztahů. Tento zápis slouží tedy převážně ke speciálním případům, např. když potřebujeme získat z aktuálního času číslici aktuálního měsíce, což výše uvedený zápis neumožňuje.

{{Sample|Příklad:}}
<code text>
MobileDefault="{CONVERT(SUBSTRING([:NOW:],6,2),System.Int32)}"
</code>

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-04-05T12:15:23Z

Pnedoma: /* Výrazy (filtrace, přiřazení hodnot) */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Je podporováno pět nových operátorů:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozího časového údaje.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-03-27T14:29:05Z

Pnedoma: /* Výrazy (filtrace, přiřazení hodnot) */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Jsou podporovány tři nové operátory:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'' (stejné vyhodnocení pro filtraci), ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozího časového údaje.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-03-27T14:26:11Z

Pnedoma: /* Výrazy */

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy (filtrace, přiřazení hodnot)=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Jsou podporovány tři nové operátory:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'', ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozího časového údaje.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2018-03-27T14:24:53Z

Pnedoma: /* Výrazy */ Operátory := a :>

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Jsou podporovány tři nové operátory:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).
** ''':=''' - Podobný operátor jako ''=:'', ale k propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Také směr přiřazení operátoru je opačný (levá strana je zapsána do pravé).
** ''':>''' - Funkce propsání levé strany operátoru do pravé, nemá vliv na filtraci (vždy hodnota ''TRUE''). K propsání hodnoty dochází pouze při založení nového záznamu z editoru vztahů, po navázání záznamu k propsání hodnoty nedochází. Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozího časového údaje.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Konfigurace v HELIOS Green

2017-09-26T13:25:05Z

Pnedoma: /* UDF atributy */ TOP problém

==HELIOS Green==
Mobilního klienta {{HELIOSMobile}} lze chápat jako funkční a datovou podmnožinu systému {{ProductFullName}}. Klient je schopen pracovat prakticky se všemi agendami/funkcemi a WorkFlow {{ProductFullName}}.

Vzhledem k omezeným zobrazovacím, paměťovým a přenosovým schopnostem mobilních zařízení je však nutné agendy, funkce a data pro tato zařízení na míru optimalizovat.

'''Konfigurace mobilních klientů''' je plně vytvářena v {{ProductFullName}} za pomoci standardních nástrojů, jako je [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon] nebo [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder].

'''Základními kroky konfigurace jsou''':
* [[#Vytvoření inicializace mobilních zařízení|Vytvoření inicializace mobilního zařízení]]
** [[#Přidání pořadače do inicializace mobilních zařízení|Přidání pořadačů do inicializace]]
** [[#Systémové přehledové šablony|Vygenerování systémových šablon]]
** [[#UDF šablony|Vygenerování UDF šablon]]
** [[#Přehledové šablony|Vygenerování přehledových šablon]]
** [[#Dynamické vztahy|Připojení dynamických vztahů]]
** [[#Funkce|Připojení potřebných funkcí]]
** [[#Externí dokumenty|Připojení externích dokumentů]]
** [[#Tiskové sestavy|Připojení tiskových sestav]]
** [[#Gadgety|Připojení výchozích gadgetů na dashboard]]
* [[#Konfigurace uživatelů|Vytvoření mobilních uživatelů]]
** [[#Konfigurace uživatelů|Výběr pořadačů z inicializace]]
** [[#Filtry|Vygenerování filtrů]]
** [[#Vzorové záznamy|Vygenerování vzorových záznamů]]

==Inicializace mobilních zařízení==
'''Inicializace''' definuje funkční a datovou strukturu, kterou si mobilní klient stáhne z aplikačního serveru pomocí webové služby, aby si následně vytvořil v mobilním zařízení její kopii.

Inicializace jsou v podstatě na míru připravené konfigurace, s nimiž budou moci mobilní zařízení pracovat.

===Hlavičkové atributy===

; ''Uživatelské jméno a heslo''
: kterým se mobilní zařízení hlásí k webové službě během procesu inicializace (kopírování funkční a datové struktury systému {{ProductFullName}} do mobilní aplikace).

; ''Režim provozu''
: který definuje operace, pro které bude mobilní aplikace využívat konkrétního uživatele, přihlášeného na zařízení.
* '''Přihlášení pro Workflow a Dashboard''' je základní režim, který využívá účet přihlášeného uživatele jen pro vykonávání workflow jeho jménem a mapování gadgetů na domovské stránce aplikace (dashboard). Zápis a čtení se provádí pod globálním uživatelem (viz [[#Konfigurace_webov.C3.A9_slu.C5.BEby|WebConfig]]).
* '''Přihlášení pro zápis''' je režim, který využívá účet přihlášeného uživatele navíc také pro zápis změn provedených v aplikaci na server HELIOS Green.
* '''Přihlášení pro zápis a čtení''' je nejnáročnější z nabízených režimů, který krom zápisu jménem přihlášeného uživatele provádí také načítání synchronizovaných dat z HELIOS Green do aplikace. Tento režim umožňuje otevírat synchronizované pořadače ve stejném módu jako v prostředí HELIOS Green, s využitím permanentních filtrů a dalších podporovaných individuálních nastavení.

===Položkové atributy===
Seznam tříd a pořadačů s kterými bude moci mobilní klient pracovat.

; ''Třída''
: Třída pořadače, s kterým bude moci mobilní klient pracovat

; ''Pořadač''
: Pořadač, s kterým bude moci mobilní klient pracovat

; ''Systémová šablona''
: [[#Systémové přehledové šablony|Systémové šablony]] pro potřeby interní komunikace mezi webovou službou a aplikačním serverem během synchronizace.

; ''Přehledová šablona''
: [[#Přehledové šablony|Přehledové šablony]] pro výpis záznamů v pořadači (není-li zvolena žádná šablona, vypíšou se v přehledu automaticky všechny atributy z formuláře).

; ''UDF hlavička''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci se záznamem v mobilním klientovi

; ''UDF položky''
: [[#UDF_šablony|Uživatelsky definované formulářové šablony]] pro práci s položkami záznamu v mobilním klientovi

; ''Ikona''
: '''Ikonku''', pod kterou se bude v mobilním klientovi prezentovat.

; ''Pouze pro čtení''
: Určuje zda bude formulář editovatelný nebo jen pro čtení.

; ''Zákaz mazání''
: Zákaz mazání záznamů pořadače na mobilním zařízení

; ''Skrytý''
: Označit pořadače jako [[#Skryté třídy|skrytého]]. Pořadač se nezobrazí v levém navigačním panelu aplikace.

; ''Workflow''
: Povolit vykonávání [[#Workflow|workflow]] nad záznamy pořadače. Pokud workflow využívá funkce, musí být tyto k pořadači přivázány v dynamickém vztahu Funkce.

===Vztahy===
K jednotlivým formulářům je možné také přivázat:
; [[#Dynamické vztahy|'''Dynamické vztahy''']]

; [[#Funkce|'''Funkce''']]

; [[#Tiskové šablony|'''Tiskové šablony''']]

; [[#Externí dokumenty|'''Vztahy příloh''']]

; [[#Záložky|'''Záložky''']]

===Vytvoření inicializace mobilních zařízení===
V pořadači ''Inicializace mobilních zařízení'' je třeba přidat nový záznam a vyplnit ''ID Inicializace'', ''Uživatelské jméno'' a ''Heslo'' pro inicializaci v mobilním zařízení.

[[Soubor:Init.jpg]]

====Přidání pořadače do inicializace mobilních zařízení====
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Formulář'' přidat novou položku.
# Pro novou položku vybrat příslušný pořadač. Odpovídající třída se vyplní sama.
# Vybrat nebo vytvořit ''Systémovou šablonu'' (viz níže).
# Vybrat šablony pro ''Přehled'', ''UDF Hlavičku'' a ''Položky''.
# Přiřadit ikonu pro položku nabídky v mobilním zařízení - ikony pro android klienty začínají '''(A)'''.
# Zvolit potřebné nastavení práv pro formulář (''Pouze pro čtení'', ''Zakázat mazání'', ''Skrytý'', ''WorkFlow'').
# Volitelné lze také v pravé horní části okna připojit ''Dynamické vztahy'', ''Funkce'' a ''Vztahy příloh''.

Povinné položky v záznamu formuláře jsou zvýrazněny červeně.

===Systémové přehledové šablony===
Systémová přehledová šablona slouží k optimalizaci přenosů a objemů dat mezi mobilním zařízením a systémem {{HELIOSMobile}}.

# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít zvolený pořadač.
# ''Otevřít přehled s produkčními daty'' (''Ctrl + O'').
# Pomocí ''F5'' otevřít výběr přehledové šablony a kliknout na ''Nový''.
# Na záložce ''Obecné'' vyplnit název systémové šablony (doporučený tvar: ''MobileSyncSystem <volitelna_cast_nazvu>'').
# Na záložce ''Výběr atributu'' vybrat položku ''Výraz...'' (poslední položka ve sloupci ''Dostupné atributy''). Typ hodnoty nastavit na '''Číslo'''. Text '''expression''' v textovém poli změnit na '''CONVERT(BIGINT, lcs.subjekty.timestamp)''' (v případě nonsubjektů použijte místo lcs.subjekty název tabulky nonsubjektu, v případě, že sloupec timestamp tabulka nonsubjektu neobsahuje, je nutné jej vytvořit).
# V záložce ''Vlastnosti atributu'' změnit alias atributu ''Výraz...'' na '''timestamp'''.

[[Soubor:System2.jpg]]

[[Soubor:System3.jpg]]

Po uložení systémové šablony je ještě třeba v její definici zrušit kontrolu počtu záznamů.
# Ze záznamu formuláře v inicializaci mobilního zařízení otevřít právě vytvořenou systémovou šablonu.
# Volbu ''Bez kontroly počtu záznamů'' nastavit na '''ANO'''.

[[Soubor:System4.jpg]]

===Přehledové šablony===
Přehledové šablony slouží k výpisu záznamů pořadače.

V případě mobilního klienta lze do přehledové šablony zahrnout pouze ty atributy a statické vztahy, které jsou součástí UDF šablon a žádné jiné! V přehledových šablonách lze použít také dynamické vztahy, definované pro daný pořadač v inicializaci.

Definice přehledové šablony není v inicializaci povinná. Není-li pro třídu/pořadač žádná konkrétní přehledová šablona vybrána, automaticky se v přehledu vypisují všechny atributy z formuláře hlavičky.

====Vytvoření přehledové šablony====
Jak už je v {{ProductFullName}} zvykem, existuje více cest k jednomu cíli. Následující postup se doporučuje jako nejjednodušší:
# Ve formuláři pro definici inicializace mobilního zařízení '''otevřít pořadač''', k němuž se bude přehledová šablona vytvářet.
# Z okna zvoleného pořadače '''otevřít přehled s produkčními daty''' (Ctrl+O).
#: [[Soubor:Prehled-1.jpg]]
# V okně přehledu s produkčními daty '''pomocí klávesy ''F5'' otevřít výběr přehledové šablony'''.
# V okně pro výběr přehledové šablony kliknutím na '''tlačítko ''Nový''''' otevřít '''Generátor šablon'''.
#: [[Soubor:Prehled-2.jpg]]
# Podrobný popis práce s Generátorem šablon lze najít v článku [https://public.helios.eu/green/doc/cs/index.php?title=Gener%C3%A1tor_%C5%A1ablon_-_popis_ovl%C3%A1d%C3%A1n%C3%AD Generátor šablon - popis ovládání].

====Odlišnosti a specifika přehledových šablon pro mobilní zařízení====
* Přehledová šablona pro {{HELIOSMobile}} může obsahovat '''pouze ty atributy, které jsou obsaženy v [[#UDF_šablony|UDF šablonách]]''', které jsou v inicializaci pro stejnou třídu/pořadač vybrány (pro UDF hlavičku a UDF položky).
* '''UDF atributy''' se v přehledové šabloně musejí definovat '''pomocí atributu Výraz'''.

====Přidání UDF atributů do přehledové šablony====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře. V textovém poli ''Šablona XML:'' zjistit název požadovaného UDF sloupce.
#: [[Soubor:Xml-udf.jpg]]
# V [[Generátor šablon - popis ovládání|Generátoru šablon]] na záložce ''Výběr atributu'' přidat do ''Vybraných atributu'' ze sloupce ''Dostupné atributy'' poslední položku, ''Výraz...''. Výraz se nevyhodnocuje, může obsahovat cokoliv (např. číslo 1)
#: [[Soubor:Generator.jpg]]
# Na záložce ''Vlastnosti atributu'' v Generátoru šablon, v záznamu tohoto přidaného atributu ''Výraz...'' nastavit jako ''Nadpis atributu'' název požadovaného UDF sloupce (viz bod 1.).

''Syntaxe pro Nadpis atributu'':
<code text>
<nazev_udf_sloupce>;<nadpis_sloupce>
</code>

{{Sample|''Příklad''}}
<code text>
$udf_im_karta_budovy_adrobec;Město
</code>

{{Important|Pro '''přidání UDF atributu položky''' je třeba vyměnit znak $ za znak €.}}
<code text>
€udf_test_polozka;Test
</code>

{{Important|Pokud jsou součástí přehledové šablony také položkové atributy, zobrazí se v přehledu záznamy opakovaně vždy pro všechny položky, bez ohledu na položkový uživatelský filtr. Pro odfiltrování záznamů nechtěných položek je nutné použít rychlý filtr na přehledové šabloně.}}

====Vlastnosti atributů====

[[Soubor:Generator-vlastnosti.jpg]]

* Na záložce '''''Vlastnosti atributů''''' je ve sloupci '''''Nadpis atributu''''' možno '''přejmenovat názvy sloupců''', pokud je výchozí název nevyhovující. Název sloupce lze přejmenovat pouze jiným než výchozím názvem.
* Na stejné záložce se rovněž definuje '''šířka sloupců v přehledu''' pořadače. Šířku sloupce lze definovat buď číselně, nebo metodou drug-and-drop roztažením sloupce myší na vzorovém přehledu ve spodní části záložky ''Vlastnosti atributů'' (viz obrázek).

===UDF šablony===
UDF šablony, neboli '''šablony uživatelsky definovaných formulářů''', jsou povinným prvkem inicializace a základním uživatelským rozhraním pro práci s konkrétním záznamem.

Současně určují, s jakými atributy - potažmo daty - bude možno v mobilní aplikaci pracovat.

UDF šablony musejí reagovat na zobrazovací schopnosti mobilního zařízení, a proto je vhodné definovat zvlášť tzv. jednosloupcové šablony pro použití v chytrých telefonech a zvlášť formulářové šablony pro tablety, které většinou umožňují zobrazení i dvousloupcových layoutů.

'''UDF šablony existují dvojího typu:'''
* UDF šablona '''hlavičky'''
* UDF šablona '''položek'''

{{Important|U položkových šablon je povinný atribut '''Číslo řádku'''! Tento atribut může být invisible.}}
<code text>
<column Name="cislo_radky" Label="Č.r." Width="25" Invisible="True"></column>
</code>

====Vytvoření UDF šablony====
# Ve výpisu pořadače, pro který je třeba vytvořit novou formulářovou šablonu, otevřít libovolný záznam.
# Pomocí ''F5'' otevřít výběr formuláře a zvolit ''Nový''.
# Jako generátor vybrat [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka ''FormBuilder''] a zvolit část formuláře, pro kterou se bude nová šablona generovat (''Hlavicka'' nebo ''Položky'').

Podrobná příručka, jak používat FormBuilder, je k dispozici v článku [https://public.helios.eu/green/doc/cs/index.php?title=FormBuilder_-_p%C5%99%C3%ADru%C4%8Dka FormBuilder - příručka].

====Úprava Šablony formuláře v XML====
# Ve výpisu pořadače ''Šablony formulářů'' otevřít záznam odpovídajícího formuláře.
# Na záložce ''Data'' se v textovém poli ''Šablona XML:'' nachází zdrojový kód formulářové šablony v XML, který lze nadále upravovat dle potřeby (viz [https://public.helios.eu/green/doc/cs/index.php?title=%C5%A0ablony_pro_formul%C3%A1%C5%99e_-_popis Popis Šablony pro formuláře]).
# Pro pohodlnější editaci lze dvojklikem na zdrojový XML kód otevřít externí editační okno (viz obrázek).
#: [[Soubor:Xml.jpg]]

=====Funkce Uprav pro Mobile=====
Funkce usnadňuje úpravu šablony formuláře pro použití v HeM.
* '''Vložit NestedTemplate''' - Aplikace HELIOS Mobile nepodporuje tag NestedTemplate. Aby se předešlo chybám inicializace a bylo možné bez větších zásahů použít existující formuláře, je možné touto volbou provést tranformaci, při které dojde ke vložení kódu odkazovaného formuláře do kódu aktuálního.
* '''Doplnit popisky položek formuláře''' - Formuláře vytvořené form builderem v základu neobsahují v XML popisek atributů a vztahů v případě, že se shodují s názvy v definici atributů. Pokud je spuštěna funkce s touto volbou, dojde k dohledání těchto názvů v databázi HeG a k jejich doplnění do atributu ''Label''.
** '''Přepsat existující''' - Pokud není tato volba zvolená, funkce přeskakuje položky formuláře, které již obsahují atribut ''Label''. Pozor, v případě použití této volby, dojde k přepsání všech hodnot atributu ''Label'', včetně odkazů na překladovou šablonu. <code>fm(...)</code>
* '''Vyčistit překladovou šablonu''' - Tato volba má za následek odstranění všech položek ''Překladové šablony XML'', které nejsou odkazovány z ''Formulářové šablony XML''. Na mobilního klienta pak nejsou zbytečně při inicializaci přenášena zbytečná data.

[[Soubor:Upravprohem.png]]

====Podporované parametry XML tagu column====
; ''Name''
: Název sloupce v tabulce nebo dotazu z databáze, povinná položka.
: Hodnota nesmí obsahovat tečky!!! (U UDA atributů nutno ručně '''změnit na podtržítka'''.)

; ''Label''
: Nadpis atributu, nezadá-li se, bude jako nadpis atributu použit obsah atributu ''name'', podporuje překlady (msg).

; ''LabelPos''
: Mobilní klient podporuje pouze hodnotu '''none''' (žádný label se nezobrazí).

; ''InputType''
: Podporované hodnoty - label (popisek), checkbox (A/N), textarea; pokud parametr chybí, předpokládá se ''text''.

; ''LinkType (nebo MobileLink)''
: Interakce atributu s externími aplikacemi (EMAIL, PHONE, URL), viz odstavec [[#Parametr LinkType|Parametr LinkType]].

; ''MobileDefault''
: Výchozí hodnota atributu pro nový záznam, viz odstavec [[#Parametr MobileDefault|Parametr MobileDefault]].

; ''MobileBarcode''
: Čtení čárových/QR kódů, viz odstavec [[#Parametr MobileBarcode|Parametr MobileBarcode]].

; ''MobileBarcodeSearch''
: Vyhledávání záznamů/položek pomocí čtečky čárových kódů, viz odstavec [[#Parametr MobileBarcodeSearch|Parametr MobileBarcodeSearch]].

; ''TabIndex''
: Parametr určuje pořadí v jakém se předává focus během editace formuláře.

; ''MobileLocation''
: GPS pozice, viz odstavec [[GPS_Souřadnice#Definice statického vztahu pro GPS souřadnice na UDF šabloně|Parametr MobileLocation]].

; ''Width''
: Šířka atributu, procento nebo absolutní hodnota.
: Procento se odvíjí od ColSpan a zaokrouhluje se matematicky na počet sloupců!!! (Např.: ColSpan=3 Width=70%, šířka bude 2 sloupce).

; ''Height''
: Výška atributu, hodnota, používá se pouze ve spojení s InputType=textarea.
: Výška řádku je 15 a zaokrouhluje se dolů. (Např.: InputType=textarea Height=160, textové pole bude vysoké na 10 řádků.)

; ''ColSpan''
: Počet sloupců layoutu.

; ''ReadOnly''
: True/False, nepodporuje podmíněné chování a výrazy.

; ''Invisible''
: True - mobilní klient atribut na formuláři nezobrazí.
: Podporuje [[#Výrazy|výrazy]].
: Využívá se pro zobrazení atributu pouze v přehledu (na formuláři bude skrytý).

; ''Protect''
: True/False
: Podporuje [[#Výrazy|výrazy]].

; ''Required''
: True/False
: Atribut/vztah je povinný a bude na formuláři zvýrazněn červeným rámečkem, pokud je nevyplněný.

; ''EditMask''
: '''Formátování čísla'''
: Př.: EditMask="L10;D2;T1;Z1"
: L celková délka, D desetinná místa, T oddělovač tisíců (0/1), Z doplnit nulami (0/1)

; ''EditStyle''
: '''Formátování času'''
: Slouží ke zobrazení času z údajů typu datum
: EditStyle="HH:MM"¨

; ''Expr''
: [[#Výrazy|Výraz]] sloužící pro výpočet hodnoty na základě ostatních atributů.

; ''RelationParams''
: Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Více viz [[#Parametr RelationParams|Parametr RelationParams]].

====Výrazy====
Definice výrazů se řídí pravidly popsanými na stránce [https://msdn.microsoft.com/en-us/library/system.data.datacolumn.expression(v=vs.100).aspx DataColumn - Expression].

Podpora výrazů funguje analogicky jako v HELIOS Green s následujícími výjimkami a odlišnostmi:
: - Nepodporuje operátory BETWEEN, CHILD a PARENT.
: - Je podporována dynamická hodnota generováná na základě zápisu [[#Parametr MobileDefault|prametru MobileDefault]].
:: - Zápis: <code>[:''MobileDefault'':]</code>, tedy například <code>[:NOW-1M+1d:]</code>.
: - Nepodporuje operace s údaji typu datum.
:: - Datum je ale ukládáno ve formě řetězce ve formátu ''MM-ddTHH:mm:ss'' (reálně tedy např.: 9. srpna 2016 08:02 se uloží jako 2016-08-09T08:02:00).
:: - Na datumových atributech je tedy možné využívat stejné operace jako nad řetězci (<,>,=,<>,SUBSTRING), které se ve spojení s výše zmíněným zápisem [[#Parametr MobileDefault|prametru MobileDefault]] stávají silným nástrojem.
: - Výrazy lze definovat pouze v rámci jednoho řádku databázové tabulky (hlavička nebo jedna položka).
: - Nepodporuje výrazy mezi hlavičkou a položkami.
: - Nepodporuje agregace.
: - U vztažených sloupců nevyžaduje parametr RegisterItemChange, změny si hlídá automaticky.
: - Ignoruje parametr ExprType, typ je zjištěn automaticky na základě výrazu.
: - Kromě použití v [[#Parametr RelationParams|RelationParams]] není možné pracovat se vztahy.

====Parametr RelationParams====
Ačkoliv je syntaxe podobná jako v případě [[#Definice vztahů|definice vztahů]] v parametrických oknech funkcí, je použití RelationParams na formulářích záznamů odlišné. RelationParams ve formulářích záznamů vztah nedefinují, ale umožňují staticky omezit množinu vztahem nabízených pořadačů a dále filtrovat záznamy nabízené záznamy a to i dynamicky, na základě dat atkuálně zobrazeného záznamu.

{{Sample|Příklad:}}
<code text>
RelationParams="c(22),f(110),expr[c24](organizace=R.cislo_organizace)"
</code>
Tento zápis omezuje nabízené pořadače pouze na pořadače třídy 22 (Zaměstnanec) a na pořadač 110 (Kontaktní osoby). Zároveň specifikuje filtrační výraz pr všechny pořadače třídy 24 (Kontakní osoba) - v našem případě tedy pouze na pořadač č. 110. Více se jenotlivým notacím parametru RelationParams věnují následující podsekce.

=====Filtrace pořadačů=====
Klientská aplikace automaticky nabízí veškeré pořadače, které odpovídají definici vztahu a jsou součástí inicializace (a dostupné aktuálnímu uživateli). Parametr Relationparams nám umožnňuje dále tuto nabídku omezit. Pro filtraci je využíván podobný zápis jako v případě použití v HeG. Notace '''f(''##'')''' značí pořadač a '''c(''##'')''' třídu. Narozdíl od použití pro definici vztahů zde neplatí žádné priority a výčet tříd a pořadačů se sjednocuje. <code>c(24),f(110)</code> tedy neznamená pouze pořadač č. 110, ale všechny pořadače kontaktních osob (třída 24). Notace podporuje stejný formát zápisu jako na straně HeG. Více tříd je tedy možné zpsat jako <code>c(12;24)</code> nebo jako <code>c(12),c(24)</code>.

=====Filtrace záznamů=====
V některých případech je žádoucí filtrovat záznamy, které jsou nabízeny pro navázání. Typickým příkladem je situace, kdy máme například na záznamu již vyplněnou organizaci a do dalších vztahů chceme navázat expozituru této organizace, nebo kontakt v rámci organizace. Na straně HeG je toto řešeno instanční logikou v metodách <code>RelationFill</code> nebo <code>RelationData</code>. Jelikož instanční logika není přenositelná na mobilního klienta, pomáhá si v těchto případech HELIOS Mobile výrazy. Dále je možné pomocí výrazů simluovat některé akce metody <code>RelationFillAfter</code> - například kopírování atributů z navázaného záznamu do aktuálního.

{{Sample|Příklad ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
expr[c24](organizace=R.cislo_organizace)
</code>

Syntaxe notace '''expr''' je následující:
<code text>
expr[''<vymezení platnosti výrazu>''](''<výraz>'')
</code>

=====Vymezení platnosti výrazu=====
Definuje, pro jaké pořadače bude výraz aplikován. Je možné uvést třídu '''c''##''''' nebo pořadač '''f''##''''' v libovolném počtu opakování oddělených čárkou. Např.: <code>expr[c24](...)</code> nebo <code>expr[f110,f10038](...)</code>. Platnost není nutné vymezovat, zápis <code>expr(...)</code> pak platí pro všechny pořadače, pro které nebyl zadán specifičtější filtrační výraz.

Pro jeden vztah může být zadefinováno několik filtračních výrazů, aplikace pak volí nejvhodnější výraz podle těchto priorit:
# číslo pořadače,
# číslo třídy,
# obecný výraz.

{{Sample|Příklad:}} <code>expr[f110](''<výraz1>''),expr[c24](''<výraz2>''),expr(''<výraz3>'')</code> ''<výraz1>'' se vždy použije pouze pro pořadač č. 110, ''<výraz2>'' se použije pro všechny pořadače Kontaktních osob s výjimkou pořadače č. 110 a ''<výraz3>'' se pak použije pro všechny pořadače ostatních tříd.

Vymezení platnosti je důležité s ohledem na různé (a různě pojmenované) atributy a v ztahy v jednotlivých pořadačích. Záznamy kontaktních osob například chceme filtrovat podle organizace, u třídy Zaměstnance by ale tato filtrace končila chybou, protože nemají žádný takový vztah.

=====Výrazy=====
Syntaxe filtračních výrazů v RelationParams je stejná jako v případě ostatních [[#Výrazy|výrazů]] používaných na fromulářích, přídává ale několik dalších možností:
* Je možné pracovat se statickými vztahy.
* Je možné (a většinou nutné) rozlišit stranu, které daný atribut či vztah náleží. Slouží k tomu notace '''L.'''''sloupec'' či '''R.'''''sloupec'', kde '''L.''' značí levou stranu vztahu a '''R.''' pravou stranu vztahu. Záleží tedy vždy na definici vztahu, u statických záznamů je navazovaný záznam vždy na pravé ('''R.''') straně. U dynamických vztahů to může být ale i naopak. Notace '''L.''' je nepoviná, pokud není uvedena žádná notace, předpokládá se automaticky levá strana vztahu. Výraz <code>organizace=R.cislo_organizace</code> je tedy identický jako výraz <code>L.organizace=R.cislo_organizace</code>. Oba vyjadřují filtrační podmínku, kde (u statického vztahu) navazovaný záznam musí mít ve vztahu ''cislo_organizace'' uvedený stejný záznam, jako má uvedený aktuální záznam ve vztahu ''organizace''.
* Jsou podporovány tři nové operátory:
** '''=?''' - Podmínka musí být splněna pouze pokud levá strana operace není NULL. Pro názornost, výraz <code>organizace=?R.cislo_organizace</code> by se pomocí SQL zapsal jako <code>organizace=R.cislo_organizace OR organizace IS NULL</code>. Pokud tedy není na levé straně vyplněn vztah organizace, jsou na pravé straně nabízeny všechny záznamy.
** '''=:''' - Stejná funkce jako ''=?'' ale navíc je po navázání záznamu propsána pravá strana operátoru do levé. (Například navážu kontaktní osobu na záznam, kde doposud nebyla vyplněna organizace, tak dojde k jejímu vyplnění podle organizace navázané kontaktní osoby.
** '''<:''' - Funkce propsání pravé strany operátoru do levé, nemá vliv na filtraci (vždy hodnota ''TRUE''). Do výrazu operaci umisťujemem pomocí logických operátorů (AND a OR).

{{Sample|Kompletní příklad výrazu ze třídy Servisní tiket(1400000), pro statický vztah kontakt_nahlasil:}}
<code text>
RelationParams="expr[c24](organizace=:R.cislo_organizace AND email_kontakt<:R.e_mail AND telefon_kontakt<:ISNULL(R.telefon_mobil,R.telefon_prace))
</code>
* Filtrační výraz se uplaťnuje pouze pro pořadače třídy Kontaktní osoba.
* Pokud máme na tiketu vyplněnou organizaci, filtrujeme podle ní. Pokud není vyplněná, zobrazí aplikace všechny záznamy. Operace ''<:'' nemají vliv na filtraci nabízených záznamů.
* Po navázání záznamu:
** Dojde k vyplnění ''organizace'', pokud nebyla vyplněna.
** Dojde k propsání atributu ''e_mail'' z navázané KO do atributu ''email_kontakt''.
** Dojde k propsání atributu ''telefon_mobil'', nebo atributu ''telefon_prace'' (pokud je mobil prázdný) z navázané KO do atributu ''telefon_kontakt''.

====Parametr MobileDefault====
Do XML kódu sloupce lze přidat parametr MobileDefault s definicí výchozího časového údaje.

{{Sample|Příklad:}}
<code text>
MobileDefault="NOW[d]+2M-3h"
</code>

Syntaxe:
<code text>
MobileDefault="NOW[''<zaokrouhlení dolu na časovou jednotku>'']
+/-''<počet><časová jednotka>''+/-''<počet><časová jednotka>''+/-...."
</code>

Časové jednotky:
* m - minuta
* h - hodina
* d - den
* M - mesíc
* y - rok

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileDefault umaže!}}

====Parametr LinkType====
Do XML kódu sloupce lze přidat parametr LinkType, který umožní interakci formulářového prvku s dalšími aplikacemi.

Možnosti:
<code text>
LinkType="EMAIL"
LinkType="PHONE"
LinkType="URL"
</code>

====Čárové kódy====

Klient HELIOS Mobile podporuje vyplňování polí formuláře (''MobileBarcode'') a dohledávání záznamů a položek (''MobileBarcodeSearch'') pomocí čtečky čárových kódů. Jsou podporovány jak klasické hardwarové čtečky čárových kódu, tak i softwarové čtení čárového kódu pomocí kamery zařízení. Oba parametry podporují výčet konfiguračních voleb, nebo hodnotu ''True/False'', kdy pro ''True'' jsou použity výchozí hodnoty konfiguračních voleb. Hodnota ''False'' je ekvivalentní absenci parametru.

=====Parametr MobileBarcode=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcode'', který umožní načtení čárového/QR kódu do atributu, případně navázání statického záznamu dohledaného na základě čárového/QR kódu.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcode="instantScan;scanMode=sw;type=1d;
targetFolder=91;targetField=reference_subjektu;moveToNext" TabIndex="1" Label="Název" />
<column Name="pocet" Label="Množství" TabIndex="2"></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcode umaže!}}

=====Parametr MobileBarcodeSearch=====

Do XML kódu sloupce atributu či statického vztahu lze přidat parametr ''MobileBarcodeSearch'', který označuje pole, na základě kterého je možné z přehledu pořadače po sejmutí kódu najít odpovídající záznam. Pokud je parametr uveden na UDF šabloně položek, označuje pole podle kterého je možné najít sejmutím kódu odpovídající položku v rámci formulářového zobrazení jednoho záznamu.

Parametr MobileBarcodeSearch lze na formuláři použít jen jednou. V případě položkové třídy lze použít parametr na hlavičce i na položce.

{{Sample|Příklad (XML kód šablony formuláře):}}

<code xml>
<column Name="zdroj_nazev" MobileBarcodeSearch="type=1d" Label="Zdroj" />
<column Name="pocet" Label="Množství" ></column>
</code>

{{Important|Editace UDF šablony pomocí FormBuilder parametr MobileBarcodeSearch umaže!}}

=====Společné konfigurační volby parametrů=====

Výchozí hodnoty voleb jsou zvýrazněny '''tučně'''.

; scanMode=''hodnota''
: Určuje, zda zařízení použije pro skenování kódu hardwarovou čtečku nebo kamerou zařízení.
: Podporované hodnoty:
:* '''''auto''''' - pro skenování se použije hardwarová čtečka, je-li na zařízení přítomna, v opačném případě se bude automaticky skenovat pomocí kamery zařízení,
:* ''hw'' - pro skenování lze použít pouze hardwarovou čtečku (dostupné pouze jen Android),
:* ''sw'' - pro skenování se vždy použije kamera zařízení.

; type=''hodnota''
: Typ kódu, který může být sejmut. Omezení vhodné pro zamezení načtení špatného kódu (pokud je například ve snímané oblasti více druhů čárových kódů).
: Tato volba je respektována jen při použití softwarové čtečky (scanMode="sw")
: Podporované hodnoty:
:* '''''all''''' - všechny níže uvedené skupiny (výchozí hodnota).
:* ''1d'' - jednorozměrné kódy (UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, RSS-14 a RSS Expanded),
:* ''1dProduct'' - jednorozměrné produktové kódy (UPC-A, UPC-E, EAN-8, EAN-13, a RSS-14),
:* ''1dIndustrial'' - jednorozměrné průmyslové kódy (CODE 39, CODE 93, CODE 128, ITF a RSS Expanded),
:* ''2d'' - dvourozměrné kódy (QR, Data Matrix),
:* ''qr'' - dvourozměrný kód typu QR,
:* ''datamatrix'' - dvourozměrný kód typu Data Matrix.

=====Specifické konfigurační volby pro parametr MobileBarcode=====

; instantScan
: Automatické snímání čárového kódu po vytvoření položky, pokud se jedná o položkový formulář, nebo po založení nového záznamu u hlavičkového formuláře.
: Volbu instantScan lze na formuláři použít jen jednou. V případě položkové třídy lze použít instantScan na hlavičce i na položce.

; moveToNext
: Po úspěšném načtení kódu a případném navázání záznamu je předán focus podle parametru TabIndex.

; saveOnSuccess
: Po úspěšném načtení kódu a případném navázání záznamu je záznam uložen stejným způsobem jako přes tlačítko na panelu. Pokud jsou na záznamu povinné atributy či vztahy, které nejsou vyplněny, dojde k zobrazení chybové zprávy a uložení neproběhne.

======Vztahy======

; targetFolder=''číslo pořadače''
: Číslo pořadače, ve kterém má aplikace hledat shodu pro načtený čárový kód. Volba má smysl pouze u vztahů, kde je na zařízení synchronizovaných více cílových pořadačů. V tomto případě pak aplikace nezobrazuje dialog pro výběr pořadače, který by jinak předcházel samotné snímání kódu.

; targetField=''sloupec''
: Atribut na navazovaném záznamu, se kterým je porovnávána nasnímaná hodnota kódu. Pokud není volba zadáná, je tento sloupec zvolen na základě sloupce, ve kterém je parametr MobileBarcode umístěn. Pro sloupce ''…_refer'' je automaticky zvolen sloupec ''reference_subjektu'', pro ''…_nazev'' pak ''nazev_subjektu''.

======Atributy======

; multiScan
: Aktivace vícenásobného čtení. Tato volba umožňuje sejmout více kódů do jednoho atributu, které jsou odděleny čárkou, nebo jiným zvoleným řetězcem.

; multiScanSeparator''=řetězec''
: Řetězec použitý pro oddělení kódů sejmutých v rámci vícenásobného čtení. Výchozí hodnota je ''čárka'' (","). Při použití této volby je automaticky aktivováno vícenásobné čtení, není nutné dodatečně používat volbu '''multiScan'''.

====UDF atributy====
Je-li třeba do šablony zahrnout i atributy, které pořadač neposkytuje, bude nutné získat potřebná data z databáze pomocí Udf SELECTu.

'''Udf SELECT''' se vkládá přes menu ''Nástroje - Data'' na záložce ''Udf SELECT''.

Jedná se o klasický SELECT v jazyce SQL, který musí splňovat následující podmínky:
* První sloupec výsledné tabulky musí mít název číslo_subjektu.
* Musí obsahovat podmínku omezující záznamy dle argumentu v záložce ''Arguments'' (''Nástroje - Data'').
* Vnější SELECT nesmí používat klauzuli TOP. Pro zvýšení efektivity je dotaz vyhodnocován pro více záznamů najednou a použití TOP by mělo za následek chybějící hodnoty u většiny záznamů. Obecně platí, že SELECT musí být funkční i v případě kdy je operátor argumentu na nahrazen operací IN (např. cislo_subjektu IN (@cislo_subjektu1, @cislo_subjektu2,@cislo_subjektu3...).

{{Sample|Příklad:}}
<code sql>
SELECT
lcs.kontaktni_osoby.cislo_subjektu,
lcs.organizace.nazev_subjektu AS organizace
FROM
lcs.kontaktni_osoby
LEFT OUTER JOIN lcs.organizace
ON lcs.kontaktni_osoby.cislo_organizace = lcs.organizace.cislo_subjektu
WHERE
lcs.kontaktni_osoby.cislo_subjektu = @cislo_subjektu
</code>

=====Další specifika UDF atributů=====
* UDF atributy jsou automaticky pouze pro čtení.
* Pokud se na formuláři vyskytuje UDF atribut, jeho hodnota se při rozdílové synchronizaci vždy synchronizuje pro všechny záznamy pořadače. Při objemu pořadače s UDF řádově v tisících záznamů tak může dojít ke značnému zpomalení rozdílových synchronizací.
* Nachází-li se UDF atribut na položce, je třeba počítat s tím, že každá položka se do zařízení synchronizuje zvlášť a při odhadu nároků na synchronizaci je tak třeba zvažovat místo počtu záznamů v pořadači celkový součet všech položek přes všechny záznamy pořadače.
* Z hlediska snižování objemů rozdílové synchronizace je žádoucí, aby UDF select vracel v případech, kdy není výsledkem dotazu žádná užitečná hodnota (např. 0), hodnotu NULL.

====UDA atributy====
{{Important|Pokud jsou v šabloně UDA atributy, je potřeba zkontrolovat v XML (viz následující odstavec) a všechny tečky v názvech sloupců přepsat na podtržítka.}}

{{Sample|Příklad:}}
<code text>
<column Name="lcs.uda_m_udalost.maloobchod" ...>
</code>
změnit na
<code text>
<column Name="lcs_uda_m_udalost_maloobchod" ...>
</code>

===Skryté třídy===
Do mobilního zařízení se synchronizují pouze data pořadačů vybraných v inicializaci. Je proto nutné přidat do inicializace také pořadače, které vstupují do mobilních formulářů prostřednictvím vztahů. Pořadače není třeba v navigačním sloupci mobilní aplikace zobrazovat, proto jsou označeny jako skryté.

[[Soubor:Hidden.jpg]]

===Workflow===
Má-li se nad záznamy pořadače vykonávat workflow, je třeba je povolit zaškrtávátkem (viz obrázek). V případě, že workflow obsahuje [[#Funkce|funkce]], musejí být tyto funkce navázány ve ''Vztazích položek''.

[[Soubor:Workflow.jpg]]

===Dynamické vztahy===
Dynamické vztahy se v případě mobilního klienta nepřidávají v [[#UDF šablony|definici šablony mobilního formuláře]], ale až v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek''.

[[Soubor:Init-dv.jpg]]

Pokud není dynamický vztah k dispozici v Konfiguraci dynamických vztahů, je třeba jej nejprve přidat (F2; Nový záznam).

U dynamického vztahu lze nastavit:
* '''Pouze pro čtení'''
* '''Nezobrazovat zleva/zprava''' - (užitečné v případě, že je vztah definován mezi pořadači jedné třídy)
* '''Zobrazovat pouze synchronizované záznamy''' - Tato volba je užitečná tehdy, když se v HELIOS Greenu mění názvy či umazávají navázané záznamy, případně, když se vztahy navazují z druhé strany. Tyto změny se projeví pouze u navázaných záznamů, které jsou do mobilního zařízení synchronizovány. Pokud se taková změna provede u přivázaných záznamů, které synchronizovány nejsou, v dynamickém vztahu se změny neprojeví. Pak je výhodné nesynchronizované záznamy v dynamickém vztahu vůbec nezobrazovat.
* '''RelationParams''' - Parametry pro navázání vztahu. Je možné omezit množinu nabízených pořadačů dynamicky filtrovat nabízené záznamy k navázání. Syntaxe je stejná jako případě [[#Parametr RelationParams|parametru RelationParams]].

===Funkce===
Funkce lze nad záznamy z mobilního zařízení spouštět buď samostatně, nebo v průběhu workflow, jehož jsou součástí.

Aby bylo možné k jednotlivým pořadačům v [[#Inicializace mobilních zařízení|inicializaci mobilních zařízení]] v části ''Vztahy položek'' potřebné funkce navázat, je nejprve nutné ''Vygenerovat záznamy o funkcích''.

[[Soubor:Funkce-1.jpg]]

[[Soubor:Funkce-2.jpg]]

[[Soubor:Funkce-3.jpg]]

'''Viditelnost funkce'''

Po otevření konfigurace navázané funkce lze na záložce ''Standard'' nastavit její jméno, kterým se bude v mobilním zařízení prezentovat, a zda ji bude možné spouštět nad záznamem v daném pořadači přímo, nebo pouze v rámci workflow (''Skrytá'').

[[Soubor:Funkce-4.jpg]]

'''Dialogové okno funkce'''

Otevírá-li funkce během svého vykonávání dialogové okno, lze jeho podobu modifikovat úpravou XML šablony na záložce ''Data''.

[[Soubor:Funkce-5.jpg]]

====Definice vztahů====
Pokud dialogové funkce obsahuje vztahy, je nutné je zadefinovat pomocí atributu '''RelationParams'''. V případě funkcí je syntaxe stejná jako v HeG:

<code>c(24;12),f(110),r(10245)</code>
nebo

<code>c(24),c(12),f(110),r(10245)</code>

Kde s následující prioritou:
* '''f''' - značí číslo pořadače, bere se pouze v případě, že je daný pořadač součástí inicializace.
* '''c''' - značí číslo třídy, berou se tedy všechny pořadače dané třídy v inicializaci.
* '''r''' - značí číslo vztahu, ze kterého jsou převzaty vztažené pořadače. (Platí pouze poslední uvedený v atributu.)

Pokud je tedy uveden výčet pořadačů, vůbec se nezohledňují čísla tříd.

{{Important|Narozdíl od RelationParams na formulářích záznamů nejsou podporvány výrazy pro filtraci nabízených záznamů.}}

====Defaultní hodnoty parametrů funkce====

Atribut ''Default'' v Datové šabloně XML je podporován jen u statických vztahů a čísel pořadačů. Výchozí hodnotu statických vztahů může uživatel následně při volání funkce na formuláři změnit. Výchozí hodnoty čísel pořadačů jsou doplněny automaticky během zpracování funkce na serveru. Uživatelský výběr pořadače na klientovi není podporován, není proto žádoucí tato pole nechávat na formuláři.

{{Sample|''Příklad''}}
<code>
...
<column Name="csPoradace_cispor" Type="System.Int32" Default="1400007" />
...
<column Name="csKategorie" Type="System.Int32" Default="79621" />
...
</code>

===Externí dokumenty===
Připojování externích dokumentů k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části '''Vztahy položek''', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Extfiles.jpg]]

===Tiskové šablony===
Informace z formuláře lze v mobilním zařízení prohlížet (PDF) a exportovat ve formě klasických tiskových sestav, vytvořených pro záznamy v {{ProductFullName|}}. Možnosti prohlížení a exportu ze zařízení jsou dány možnostmi a aplikačním vybavením mobilního zařízení.

Vytváření existujících tiskových šablon k záznamům (přiložené soubory, fotografie, audiozáznamy) lze pro konkrétní pořadač v definici inicializace mobilního zařízení povolit v části ''Vztahy položek'', podobně jako [[#Dynamické vztahy|dynamické vztahy]].

[[Soubor:Tisk-heg.jpg]]

===Záložky===
Záložky na formulářích reprezentují, stejně jako v HELIOS Green, statické vztahy zprava.

'''Podmínkou zobrazení záložky''' je umístění stejného vztahu zleva na formulář pořadače, jehož záznamy se mají na záložce zobrazit.

Př.:
K pořadači Organizace přidáme záložku Expozitury cizí.

[[Soubor:Zalozky.jpg]]

Aby se záložka skutečně na záznamech organizace zobrazila, je třeba na hlavičkový formulář pořadače Expozitura cizí přidat stejný statický vztah zleva.

<column Name="cislo_organizace_nazev" Label="Organizace:"></column>

Tento vztah může zobrazovat název, referenci nebo může být nastaven jako ''invisible''.

===Verzování inicializace===
Po každé změně na úrovni inicializace mobilních zařízení je třeba zvýšit verzi.

[[Soubor:Verze.jpg]]

Zvýšení verze inicializace vyvolá po přihlášení do aplikace výzvu k reinicializaci.

==Konfigurace uživatelů==

Součástí definice každé inicializace je '''konfigurace uživatelů''', kteří budou moci, v mantinelech této inicializace, se systémem {{ProductFullName}} prostřednictvím mobilního zařízení pracovat.

Zatímco inicializace předává mobilnímu zařízení informace o části funkční a datové struktury, kterou bude možno v mobilní aplikaci používat, konfigurace uživatele určuje, jaká data se budou mezi aplikací {{HELIOSMobile}} a systémem {{ProductFullName}} prostřednictvím webové služby pro konkrétního uživatele synchronizovat.

V případe nutnosti se mohou během komunikace mapovat na fyzicky existující uživatelské účty v systému {{ProductFullName|}}. To se děje například během zpracovávání workflow mobilním klientem.

[[Soubor:Userconfig.jpg]]

===Uživatelské účty v inicializaci mobilního zařízení===
Pro každý uživatelský účet v inicializaci je nutné zvlášť specifikovat portfolio dostupných formulářů výběrem z nabídky, definované pro danou inicializaci. To znamená, že uživatel muže v mobilní aplikaci využívat pouze formuláře dostupné v dané inicializaci a současně povolené pro jeho konkrétní účet. Na úrovni uživatele lze rovněž omezit objem dostupných dat výběrem [[#Filtry|filtru]], který nejlépe odpovídá jeho potřebám.

{{Sample|Příklad:}}
<code text>
inicializace: obchodní zástupce
uživatel: Jan Novák
filtr: region přidělený obchodnímu zástupci Janu Novákovi
</code>

===Vytvoření uživatelského účtu===
# V ''Inicializaci mobilních zařízení'' otevřít požadovanou inicializaci a v ní na záložce ''Uživatelé'' přidat nový záznam.
# Vyplnit ''ID Uživatele'' a ''Heslo'' pro přihlášení do mobilního klienta.
# {{Important|Tento uživatel existuje pouze pro komunikaci mobilního klienta s webovou službou, nejedná se o uživatele v {{ProductFullName}}!}}
# Jako ''Osobu'' vybrat z pořadače ''Uživatelé'' uživatele {{ProductFullName}}, na kterého se bude mobilní uživatel mapovat při zakládání nových záznamů, filtrování a vykonávání WorkFlow.
# Pomocí volby ''Přidat položku'' (Ctrl + F2) zpřístupnit uživateli požadované formuláře ze seznamu formulářů, které byly do inicializace vybrány v předchozím kroku. Ke každému formuláři lze na úrovni uživatele přidat ještě ''Filtr'', který pro mobilní zařízení omezí dostupné záznamy a ''Vzorový záznam'', který obsahuje výchozí hodnoty hlavičkových atributů, případně vzorovou položku (první položka vzorového záznamu) pro položky nového záznamu.

[[Soubor:Userconfig2.jpg]]

===Filtry===
Filtrování dat pro synchronizaci s mobilním zařízením slouží především k optimalizaci datových přenosů mezi mobilním zařízením a serverem. Pro každý pořadač, který je konkrétnímu uživateli vybrané inicializace povolen, lze současně přiřadit filtr výběrem z existujících filtrů v {{ProductFullName}} nebo vytvořením filtru nového. Tyto filtry se vytvářejí stejným způsobem jako v {{ProductFullName}}.

[[Soubor:FiltryHeM.jpg]]

{{Important|Uživatelský filtr slouží pouze k vymezení dat pro synchronizaci záznamů na zařízení, vykonává se na úrovni HELIOS Green a na zařízení se nepřenáší.}}

===Vzorové záznamy===

Vzorové záznamy slouží k předvyplněných výchozích hodnot pro nové záznamy. Předvyplnit lze tímto způsobem prakticky všechny atributy a statické vztahy zleva, které jsou na formuláři definovány. Výjimku tvoří atribut Název subjektu. Díky tomu, že se hodnota tohoto atributu do zařízení nepřenáší, lze jej využít k odfiltrování vzorových záznamů z implicitního formulářového pohledu v HELIOS Green.

'''Výchozí hodnoty na položce vzorového záznamu se použijí pro každou novou položku.'''

Webová služba

2017-08-08T14:15:03Z

Pnedoma: /* Konfigurace webové služby */ Konfigurace jazyka

==Webová služba==

Webová služba je rozhraní pro výměnu dat mezi systémem {{ProductFullName}} a aplikací {{HeMProductFullName}}.

Mobilní aplikace nekomunikuje s aplikačním serverem přímo, ale výhradně prostřednictvím webové služby.

Aplikace kontaktuje webovou službu se svými požadavky na systém {{ProductFullName}}, webová služba následně s těmito požadavky kontaktuje aplikační server a výsledky vrací zpět mobilní aplikaci.

Aplikační server {{ProductFullName}} se fyzicky nachází uvnitř podnikové sítě, zatímco mobilní zařízení se pohybují ve veřejném Internetu. Webová služba musí být na svých komunikačních portech těmto zařízením přístupná odkudkoliv.

'''To je možné realizovat dvěma způsoby:'''
* Webová služba běží stejně jako server uvnitř podnikové sítě za firewallem a '''mobilní zařízení k ní přistupuje pomocí VPN'''.
* Webová služba je fyzicky '''umístěna do DMZ''' (doporučeno).

==Instalace webové služby==
Webovou službu pro mobilní aplikaci {{HELIOSMobile}} je možno provozovat pouze na web serverech IIS!

Web server, na kterém webová služba poběží, se doporučuje umístit do DMZ.

===Výhody umístění webové služby do DMZ===
* Pohodlná komunikace s aplikačním serverem {{ProductFullName}}, umístěném uvnitř podnikové sítě
* Přímý přístup z Internetu na porty webové služby
* Mobilní zařízení nepotřebuje ke komunikaci s aplikačním serverem VPN.

===Požadavky webové služby na server ===
* Standardní HW pro instalaci Microsoft Windows Server 2008 a vyšší
* Microsoft Windows Server 2008 a vyšší
* Instalace Microsoft .Net Framework 4 a vyšší
* Instalace WWW serveru IIS7 a vyšší + Application Development Features
* Podpora HTTP i HTTPS
* V případě, že je .Net Framework instalován až po IIS, může být vyžadována také ruční registrace Frameworku z příkazové řádky příkazem:
aspnet_regiis -i

====Instalace ASP.NET v IIS8====
# Spustit Server Manager
# Položka IIS - oddíl Roles and Features - TASKS: Add Roles and Features
# Instalation Type: Role-based or feature-based instalation
# Server Roles: Web Server (IIS) - Web Server - Application Development: .NET Extensibility, ASP, ASP.NET, ISAPI
# Features: .NET Frameworks 4.5 - WCF Services: HTTP Activation
# (Restart automatically) - Install

===Postup instalace webové služby===
# Na serveru IIS, umístěném v DMZ, vytvořit nový aplikační pool pro webovou službu
# Stáhnout aktuální verzi instalačního balíčku webové služby z těchto stránek ([[Webová služba - download|Soubory ke stažení]])
# Obsah instalačního balíčku nakopírovat do kořenového adresáře připraveného aplikačního poolu
# Pokud bude aplikace pracovat s přílohami, vytvořit v kořenovém adresáři složku ''AttachmentCache''
# Nastavit práva zápisu pro webserver IIS na adresáře ''AttachmentCache'' a ''Log''
# Nakonfigurovat webovou službu v souboru ''Web.Config'' (Je třeba zvolit správnou verzi konfiguračního souboru, podle toho jaké protokoly jsou na IIS povoleny - zda jen HTTP, HTTPS nebo oba)
# Spustit nový webový server s webovou službou {{HELIOSMobile}}

==Konfigurace webové služby==
Konfigurace webové služby pro mobilní aplikaci {{HELIOSMobile}} je uložena v kořenovém adresáři webové služby v XML souboru '''Web.config'''.

Pro základní konfiguraci webové služby je důležitý hned první oddíl uzavřený tagem '''appSettings''':

<code text>
<appSettings>
<add key="HegMaxConnections" value="2"/>
<add key="AttachmentCacheFolder" value="AttachmentCache"/>
<add key="ApplicationServerURL" value=""/>
<add key="DbProfile" value=""/>
<add key="Domain" value=""/>
<add key="User" value=""/>
<add key="Password" value=""/>
<add key="LicenceFile" value=""/>
</appSettings>
</code>

; ''HegMaxConnections''
: Počet povolených externích spojení na aplikační server HELIOS Green pro synchronizace. Doporučený minimální počet připojení je 2.

; ''ApplicationServerURL''
: Adresa aplikačního serveru, případně konkrétního poolu {{ProductFullName}}.

; ''DbProfile''
: Jméno připojené databáze.

; ''Domain''
: Název domény Active Directory. Pokud HELIOS Green nepoužívá doménovou autentikaci, zůstane tento klíč prázdný.

; ''User''
: Globální uživatel {{ProductFullName}}, pod kterým je webová služba spuštěná. Tento uživatel musí mít v HELIOS Green nastaveno Globální právo ''Tvorba výrazů''.

; ''Password''
: Heslo globálního uživatele v zakódovaném tvaru. Pro kódování hesla je k dispozici jednoduchý nástroj HELIOS Mobile MakePass.
: [[Soubor:Makepass.jpg]]
: [[:Soubor:MakePass.rar|HELIOS Mobile MakePass ke stažení]]

; ''LicenceFile''
: Tato položka je povinná jen tehdy, není-li název licenčního souboru ve výchozím tvaru (licence.lic).

; ''AndroidMinVersion''
: Minimální podporovaná verze Android klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

; ''iOSMinVersion''
: Minimální podporovaná verze iOS klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

; ''UdfDisabledUsers''
: Seznam uživatelů (oddělených čárkou), pro které se nesynchronizují hodnoty UDF atributů. Vhodné pro situace, kdy máme např. technického uživatele pod kterým nahráváme na server data předsynchronizace, pro která UDF atributy znamenají akorát zbytečné prodloužení doby běhu synchronizace.

; ''Language''
: Výchozí jazyk spojení s HELIOS Green. Ovlivňuje jazyk chybových zpráv a názvy Atributů, Vztahů či např. Pořadačů, pokud jsou v repository k dispozici jejich překlady. Výchozí jazyk je použit v případě, že není jazyk specifikován klientem (starší verze aplikace).

; ''SupportedLanguages''
: Seznam jazyků (oddělených čárkou) podporovaných serverem. Tato položka slouží k ošetření situace, kdy se připojuje klient s nastaveným jazykem, který není podporován serverem HELIOS Green. Položku je také možné využít pro nastavení mapování nepodporovaného jazyka. Mapování se uvádí do závorky za cílový jazyk (oddělné středníkem). Zápis pro server podporující jazyky <code text>CZ</code> a <code text>EN</code> s mapováním <code text>SK</code> a <code text>PL</code> na <code text>CZ</code> a všemi ostatními jazyky na <code text>EN</code> by vypadal následovně: <code text>"EN,CZ(SK;PL)"</code>.

===Vzorové konfigurace ke stažení===
* [[:Soubor:WebConfig.rar|WebConfig.rar]] - Web.config pro IIS s podporou '''HTTP i HTTPS'''
* [[:Soubor:WebConfigHTTP.rar|WebConfigHTTP.rar]] - Web.config pro IIS s podporou '''pouze HTTP'''
* [[:Soubor:WebConfigHTTPS.rar|WebConfigHTTPS.rar]] - Web.config pro IIS s podporou '''pouze HTTPS'''

Webová služba

2017-08-08T13:49:53Z

Pnedoma: /* Konfigurace webové služby */ UdfDisabledUsers

==Webová služba==

Webová služba je rozhraní pro výměnu dat mezi systémem {{ProductFullName}} a aplikací {{HeMProductFullName}}.

Mobilní aplikace nekomunikuje s aplikačním serverem přímo, ale výhradně prostřednictvím webové služby.

Aplikace kontaktuje webovou službu se svými požadavky na systém {{ProductFullName}}, webová služba následně s těmito požadavky kontaktuje aplikační server a výsledky vrací zpět mobilní aplikaci.

Aplikační server {{ProductFullName}} se fyzicky nachází uvnitř podnikové sítě, zatímco mobilní zařízení se pohybují ve veřejném Internetu. Webová služba musí být na svých komunikačních portech těmto zařízením přístupná odkudkoliv.

'''To je možné realizovat dvěma způsoby:'''
* Webová služba běží stejně jako server uvnitř podnikové sítě za firewallem a '''mobilní zařízení k ní přistupuje pomocí VPN'''.
* Webová služba je fyzicky '''umístěna do DMZ''' (doporučeno).

==Instalace webové služby==
Webovou službu pro mobilní aplikaci {{HELIOSMobile}} je možno provozovat pouze na web serverech IIS!

Web server, na kterém webová služba poběží, se doporučuje umístit do DMZ.

===Výhody umístění webové služby do DMZ===
* Pohodlná komunikace s aplikačním serverem {{ProductFullName}}, umístěném uvnitř podnikové sítě
* Přímý přístup z Internetu na porty webové služby
* Mobilní zařízení nepotřebuje ke komunikaci s aplikačním serverem VPN.

===Požadavky webové služby na server ===
* Standardní HW pro instalaci Microsoft Windows Server 2008 a vyšší
* Microsoft Windows Server 2008 a vyšší
* Instalace Microsoft .Net Framework 4 a vyšší
* Instalace WWW serveru IIS7 a vyšší + Application Development Features
* Podpora HTTP i HTTPS
* V případě, že je .Net Framework instalován až po IIS, může být vyžadována také ruční registrace Frameworku z příkazové řádky příkazem:
aspnet_regiis -i

====Instalace ASP.NET v IIS8====
# Spustit Server Manager
# Položka IIS - oddíl Roles and Features - TASKS: Add Roles and Features
# Instalation Type: Role-based or feature-based instalation
# Server Roles: Web Server (IIS) - Web Server - Application Development: .NET Extensibility, ASP, ASP.NET, ISAPI
# Features: .NET Frameworks 4.5 - WCF Services: HTTP Activation
# (Restart automatically) - Install

===Postup instalace webové služby===
# Na serveru IIS, umístěném v DMZ, vytvořit nový aplikační pool pro webovou službu
# Stáhnout aktuální verzi instalačního balíčku webové služby z těchto stránek ([[Webová služba - download|Soubory ke stažení]])
# Obsah instalačního balíčku nakopírovat do kořenového adresáře připraveného aplikačního poolu
# Pokud bude aplikace pracovat s přílohami, vytvořit v kořenovém adresáři složku ''AttachmentCache''
# Nastavit práva zápisu pro webserver IIS na adresáře ''AttachmentCache'' a ''Log''
# Nakonfigurovat webovou službu v souboru ''Web.Config'' (Je třeba zvolit správnou verzi konfiguračního souboru, podle toho jaké protokoly jsou na IIS povoleny - zda jen HTTP, HTTPS nebo oba)
# Spustit nový webový server s webovou službou {{HELIOSMobile}}

==Konfigurace webové služby==
Konfigurace webové služby pro mobilní aplikaci {{HELIOSMobile}} je uložena v kořenovém adresáři webové služby v XML souboru '''Web.config'''.

Pro základní konfiguraci webové služby je důležitý hned první oddíl uzavřený tagem '''appSettings''':

<code text>
<appSettings>
<add key="HegMaxConnections" value="2"/>
<add key="AttachmentCacheFolder" value="AttachmentCache"/>
<add key="ApplicationServerURL" value=""/>
<add key="DbProfile" value=""/>
<add key="Domain" value=""/>
<add key="User" value=""/>
<add key="Password" value=""/>
<add key="LicenceFile" value=""/>
</appSettings>
</code>

; ''HegMaxConnections''
: Počet povolených externích spojení na aplikační server HELIOS Green pro synchronizace. Doporučený minimální počet připojení je 2.

; ''ApplicationServerURL''
: Adresa aplikačního serveru, případně konkrétního poolu {{ProductFullName}}.

; ''DbProfile''
: Jméno připojené databáze.

; ''Domain''
: Název domény Active Directory. Pokud HELIOS Green nepoužívá doménovou autentikaci, zůstane tento klíč prázdný.

; ''User''
: Globální uživatel {{ProductFullName}}, pod kterým je webová služba spuštěná. Tento uživatel musí mít v HELIOS Green nastaveno Globální právo ''Tvorba výrazů''.

; ''Password''
: Heslo globálního uživatele v zakódovaném tvaru. Pro kódování hesla je k dispozici jednoduchý nástroj HELIOS Mobile MakePass.
: [[Soubor:Makepass.jpg]]
: [[:Soubor:MakePass.rar|HELIOS Mobile MakePass ke stažení]]

; ''LicenceFile''
: Tato položka je povinná jen tehdy, není-li název licenčního souboru ve výchozím tvaru (licence.lic).

; ''AndroidMinVersion''
: Minimální podporovaná verze Android klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

; ''iOSMinVersion''
: Minimální podporovaná verze iOS klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

; ''UdfDisabledUsers''
: Seznam uživatelů (oddělených čárkou), pro které se nesynchronizují hodnoty UDF atributů. Vhodné pro situace, kdy máme např. technického uživatele pod kterým nahráváme na server data předsynchronizace, pro která UDF atributy znamenají akorát zbytečné prodloužení doby běhu synchronizace.

===Vzorové konfigurace ke stažení===
* [[:Soubor:WebConfig.rar|WebConfig.rar]] - Web.config pro IIS s podporou '''HTTP i HTTPS'''
* [[:Soubor:WebConfigHTTP.rar|WebConfigHTTP.rar]] - Web.config pro IIS s podporou '''pouze HTTP'''
* [[:Soubor:WebConfigHTTPS.rar|WebConfigHTTPS.rar]] - Web.config pro IIS s podporou '''pouze HTTPS'''

Webová služba

2017-08-08T13:41:49Z

Pnedoma: /* Konfigurace webové služby */

==Webová služba==

Webová služba je rozhraní pro výměnu dat mezi systémem {{ProductFullName}} a aplikací {{HeMProductFullName}}.

Mobilní aplikace nekomunikuje s aplikačním serverem přímo, ale výhradně prostřednictvím webové služby.

Aplikace kontaktuje webovou službu se svými požadavky na systém {{ProductFullName}}, webová služba následně s těmito požadavky kontaktuje aplikační server a výsledky vrací zpět mobilní aplikaci.

Aplikační server {{ProductFullName}} se fyzicky nachází uvnitř podnikové sítě, zatímco mobilní zařízení se pohybují ve veřejném Internetu. Webová služba musí být na svých komunikačních portech těmto zařízením přístupná odkudkoliv.

'''To je možné realizovat dvěma způsoby:'''
* Webová služba běží stejně jako server uvnitř podnikové sítě za firewallem a '''mobilní zařízení k ní přistupuje pomocí VPN'''.
* Webová služba je fyzicky '''umístěna do DMZ''' (doporučeno).

==Instalace webové služby==
Webovou službu pro mobilní aplikaci {{HELIOSMobile}} je možno provozovat pouze na web serverech IIS!

Web server, na kterém webová služba poběží, se doporučuje umístit do DMZ.

===Výhody umístění webové služby do DMZ===
* Pohodlná komunikace s aplikačním serverem {{ProductFullName}}, umístěném uvnitř podnikové sítě
* Přímý přístup z Internetu na porty webové služby
* Mobilní zařízení nepotřebuje ke komunikaci s aplikačním serverem VPN.

===Požadavky webové služby na server ===
* Standardní HW pro instalaci Microsoft Windows Server 2008 a vyšší
* Microsoft Windows Server 2008 a vyšší
* Instalace Microsoft .Net Framework 4 a vyšší
* Instalace WWW serveru IIS7 a vyšší + Application Development Features
* Podpora HTTP i HTTPS
* V případě, že je .Net Framework instalován až po IIS, může být vyžadována také ruční registrace Frameworku z příkazové řádky příkazem:
aspnet_regiis -i

====Instalace ASP.NET v IIS8====
# Spustit Server Manager
# Položka IIS - oddíl Roles and Features - TASKS: Add Roles and Features
# Instalation Type: Role-based or feature-based instalation
# Server Roles: Web Server (IIS) - Web Server - Application Development: .NET Extensibility, ASP, ASP.NET, ISAPI
# Features: .NET Frameworks 4.5 - WCF Services: HTTP Activation
# (Restart automatically) - Install

===Postup instalace webové služby===
# Na serveru IIS, umístěném v DMZ, vytvořit nový aplikační pool pro webovou službu
# Stáhnout aktuální verzi instalačního balíčku webové služby z těchto stránek ([[Webová služba - download|Soubory ke stažení]])
# Obsah instalačního balíčku nakopírovat do kořenového adresáře připraveného aplikačního poolu
# Pokud bude aplikace pracovat s přílohami, vytvořit v kořenovém adresáři složku ''AttachmentCache''
# Nastavit práva zápisu pro webserver IIS na adresáře ''AttachmentCache'' a ''Log''
# Nakonfigurovat webovou službu v souboru ''Web.Config'' (Je třeba zvolit správnou verzi konfiguračního souboru, podle toho jaké protokoly jsou na IIS povoleny - zda jen HTTP, HTTPS nebo oba)
# Spustit nový webový server s webovou službou {{HELIOSMobile}}

==Konfigurace webové služby==
Konfigurace webové služby pro mobilní aplikaci {{HELIOSMobile}} je uložena v kořenovém adresáři webové služby v XML souboru '''Web.config'''.

Pro základní konfiguraci webové služby je důležitý hned první oddíl uzavřený tagem '''appSettings''':

<code text>
<appSettings>
<add key="HegMaxConnections" value="2"/>
<add key="AttachmentCacheFolder" value="AttachmentCache"/>
<add key="ApplicationServerURL" value=""/>
<add key="DbProfile" value=""/>
<add key="Domain" value=""/>
<add key="User" value=""/>
<add key="Password" value=""/>
<add key="LicenceFile" value=""/>
</appSettings>
</code>

; ''HegMaxConnections''
: Počet povolených externích spojení na aplikační server HELIOS Green pro synchronizace. Doporučený minimální počet připojení je 2.

; ''ApplicationServerURL''
: Adresa aplikačního serveru, případně konkrétního poolu {{ProductFullName}}.

; ''DbProfile''
: Jméno připojené databáze.

; ''Domain''
: Název domény Active Directory. Pokud HELIOS Green nepoužívá doménovou autentikaci, zůstane tento klíč prázdný.

; ''User''
: Globální uživatel {{ProductFullName}}, pod kterým je webová služba spuštěná. Tento uživatel musí mít v HELIOS Green nastaveno Globální právo ''Tvorba výrazů''.

; ''Password''
: Heslo globálního uživatele v zakódovaném tvaru. Pro kódování hesla je k dispozici jednoduchý nástroj HELIOS Mobile MakePass.
: [[Soubor:Makepass.jpg]]
: [[:Soubor:MakePass.rar|HELIOS Mobile MakePass ke stažení]]

; ''LicenceFile''
: Tato položka je povinná jen tehdy, není-li název licenčního souboru ve výchozím tvaru (licence.lic).

; ''AndroidMinVersion''
: Minimální podporovaná verze Android klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

; ''iOSMinVersion''
: Minimální podporovaná verze iOS klienta. Připojení klienta s nižší verzí aplikace končí chybou. Pokud je verze nastavená v konfiguračním souboru nižší než minimální webovou službou požadovaná verze, je tato položka ignorována.

===Vzorové konfigurace ke stažení===
* [[:Soubor:WebConfig.rar|WebConfig.rar]] - Web.config pro IIS s podporou '''HTTP i HTTPS'''
* [[:Soubor:WebConfigHTTP.rar|WebConfigHTTP.rar]] - Web.config pro IIS s podporou '''pouze HTTP'''
* [[:Soubor:WebConfigHTTPS.rar|WebConfigHTTPS.rar]] - Web.config pro IIS s podporou '''pouze HTTPS'''

Šablony účtenek

2017-03-24T14:52:09Z

Pnedoma: úvod

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2017-03-24T14:24:48Z

Pnedoma: /* Hlavička */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2017-03-24T13:49:46Z

Pnedoma: přidání sekce hlavičky

Šablony účtenek

2017-03-24T13:39:23Z

Pnedoma: /* Položky */ Suma

Šablony účtenek

2017-03-24T13:29:14Z

Pnedoma: změna pořadí

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

Šablony účtenek

2017-03-24T13:25:59Z

Pnedoma: /* Přehled DPH */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

Šablony účtenek

2017-03-24T10:01:05Z

Pnedoma: /* Velikost */ normal

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

=== Přehled DPH ===

<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

Šablony účtenek

2017-03-24T08:45:40Z

Pnedoma: /* Položky */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

=== Přehled DPH ===

<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

Šablony účtenek

2017-03-24T08:23:27Z

Pnedoma: /* Položky */ příklady

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===

<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

=== Přehled DPH ===

<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

Šablony účtenek

2017-03-23T12:24:08Z

Pnedoma: /* EET */ příklad

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

Šablony účtenek

2017-03-23T12:22:00Z

Pnedoma: /* Podmíněný blok */

Šablony účtenek

2017-03-23T11:58:11Z

Pnedoma:

Šablony účtenek

2017-03-23T11:57:21Z

Pnedoma: /* EET */

Šablony účtenek

2017-03-23T11:57:03Z

Pnedoma: /* EET */ atribut label

Šablony účtenek

2017-03-23T11:47:24Z

Pnedoma: /* EET */ popisky identifikátorů

Šablony účtenek

2017-03-23T10:31:53Z

Pnedoma: /* EET */

Šablony účtenek

2017-03-23T10:30:56Z

Pnedoma: /* EET */

Šablony účtenek

2017-03-23T10:30:36Z

Pnedoma: /* Hodnoty */ výčet identifikátorů

Šablony účtenek

2017-03-23T10:11:01Z

Pnedoma:

Šablony účtenek

2017-03-23T10:09:54Z

Pnedoma: /* Obrázky */

Šablony účtenek

2017-03-22T18:08:19Z

Pnedoma: /* Čáry */

Šablony účtenek

2017-03-22T18:06:46Z

Pnedoma: /* Čáry */

Šablony účtenek

2017-03-22T17:13:44Z

Pnedoma: /* Velikost */ příklady

Šablony účtenek

2017-03-22T17:02:31Z

Pnedoma: /* Velikost */

Šablony účtenek

2017-03-22T17:02:19Z

Pnedoma: /* Velikost */

Šablony účtenek

2017-03-22T17:01:33Z

Pnedoma: /* Velikost */

Šablony účtenek

2017-03-22T16:13:59Z

Pnedoma: /* Text */

Šablony účtenek

2017-03-22T16:10:03Z

Pnedoma: /* Řádkování */ příklad

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T16:09:00Z

Pnedoma: /* Zarovnání */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T16:07:25Z

Pnedoma: /* Řádkování */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.

<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T15:55:29Z

Pnedoma: /* Text */

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.

<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T15:49:00Z

Pnedoma: /* Tučný */

== Text ==
Statický text musí být vždy uzavřený v elementu <code>text</code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code>br</code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.

<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T15:48:32Z

Pnedoma: /* Podtržený */

Šablony účtenek

2017-03-22T15:48:09Z

Pnedoma: /* Styl textu */

Šablony účtenek

2017-03-22T15:15:47Z

Pnedoma: /* Zarovnání */

== Text ==
Statický text musí být vždy uzavřený v elementu <code>text</code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code>br</code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.

<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code>b</code>.

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code>u</code> a výraznější <code>u2</code> pro podtržení s dvounásobnou tloušťkou čáry.

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code>invert</code>.

=== Řádkování ===

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T15:14:15Z

Pnedoma: /* Styl textu */

== Text ==
Statický text musí být vždy uzavřený v elementu <code>text</code>. Volný text není podporován.
<code xml>
<text>Text</text>
</code>
Pokud je text delší než je zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code>br</code>.
<code xml>
 
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.

<code xml>
<left>Levé</left>
<center>Střed</center>
<right>Pravé</right>
</code>

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code>b</code>.

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code>u</code> a výraznější <code>u2</code> pro podtržení s dvounásobnou tloušťkou čáry.

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code>invert</code>.

=== Řádkování ===

=== Velikost ===

== Čáry ==

== Obrázky ==

== Položky ==

== Hodnoty ==

Šablony účtenek

2017-03-22T13:55:54Z

Pnedoma: /* Text */