V tomto článku se budeme věnovat pokročilému nastavení vlastních šablon exportovaných dokumentů. Pokud ještě nevíte, co vlastní šablona je a jak ji vytvořit, mrkněte na podrobný článek.
Tady se ale budeme věnovat opravdovým vychytávkám. Zaměříme se na to, jak upravit šablonu tak, aby byla mnohem sofistikovanější.
Obrázek
Značka pro obrázek začíná znakem % např. u Klienta je to {%logo}.
Pro změnu velikosti vloženého obrázku můžete doplnit parametr size.
{%image | size:70:70}
Obrázek tedy bude mít velikost 70px x 70px.
Podmínka
Podmínka umožňuje ošetřit části textu tak, aby se do exportovaného dokumentu vepsaly pouze tehdy, pokud jsou vyplněné i v raynetu. Např. pole Poznámka u Nabídky se v dokumentu zobrazí tehdy, je-li v ní vepsán text.
Seznam možných podmínek opět naleznete v parametrech pro konkrétní typ záznamu. Každá podmínka je definována tzv. otevírací a uzavírací značkou. Název otevírací značky je doplněn znakem hash # a uzavírací značka je doplněna lomítkem /, např. {#birthday} ... {/birthday}. Ke každé hodnotě existuje parametr s předponou has, kterým lze otestovat, zdali je hodnota vyplněna či nikoli {#hasBirthday} ... {/hasBirthday}.
Vyplnění podmínky pak může vypadat takto:
Podmínky vždy začínají symbolem # a ukončují se pomocí lomítka /:
{#hasBirthday}Narozeniny: {birthday}{/hasBirthday}
Ukončení podmínky lze provést dvěma způsoby:
{#items.length > 3}...{/items.length > 3}
{#items.length > 3}...{/}
Operátory které lze v podmínkách využít:
!== nerovnost {#discount !== "0,00"}... {/}
=== rovnost {#discount === "0,00"}... {/}
> větší {#items.length > 1}... {/}
< menší {#items.length < 1}... {/}
<= menší rovno {#items.length <= 1}... {/}
>= větší rovno {#items.length >= 1}... {/}
&& AND {#items.length > 1 && discount === "0,00" }... {/}
|| OR {#items.length > 1 || discount === "0,00" }... {/}
! negace {#!hasDescription }... {/}
Podmínku k počtu položek můžete použít např. u Nabídky, Objednávky, nebo Obchodního případu.
Vypadá například takto:
{#items.length > 3} více položek nez 3 {/}
{#items.length <= 3} 3 a méně položek {/}
Cykly
Číslování řádku v cyklu docílíte tímto způsobem:
{#products}
{$rowNum}. {name}
{/}
Podmínka na čísla řádků
Čísla řádků se dají využít i v podmínce:
{#products}
{#$rowNum < 5}{name}{/}
{/}
(zobrazí pouze prvních 5 produktů).