Funkce v šablonách dokumentů
Funkce lze používat při automatickém formátování dokumentů pomocí šablon. Funkce zjednodušují způsob zobrazení dat v dokumentech. Například můžete pomocí vzorců automaticky zobrazit čísla slovy nebo vypočítat náklady objednávky.
Vzorce
Pro vložení vzorce do dokumentu použijte následující syntaxi: %%%FORMULA%%%.
FORMULA je výraz pro výpočet hodnoty pole, podobně jako ve vypočítaném poli.
Příklad:
V příkladu výše jsou do vzorce přidána data z datového tagu "Service" pomocí odpovídajících proměnných. Dvě hodnoty se vynásobí a výsledkem je celková cena konkrétní služby nebo produktu. Funkce TEXT() formátuje hodnotu jako čitelný textový řetězec.
Důležité
Například:
- Vzorce musí být zapsány v jednom řetězci a nesmějí být rozděleny stisknutím Enter. Pokud potřebujete vložit zalomení řádku, použijte sekvenci "\n".
- Bez zalomení řádku
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Se zalomením řádku
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Proměnné ve vzorci nelze formátovat, například tučně nebo kurzívou.
- Pokud chcete, aby se výsledek vzorce zobrazil tučně, použijte formátování na celý vzorec včetně procentových znaků.
Funkce
Všechny funkce dostupné ve vzorcích šablony dokumentu:
Funkce SUM
SUM() je funkce, která sčítá všechny hodnoty získané při výpočtu vzorce. Aplikuje se na každý prvek násobitelné proměnné.
Například máte datový tag "Service" a chcete spočítat celkové náklady všech služeb v dokumentu. Použijete tuto funkci:
SUM({{DataTag.Service.Cost}})
Aby bylo možné získat celkovou cenu poskytnutých služeb, je třeba cenu služby vynásobit počtem, kolikrát byla objednána. Zde je vzorec, který byste měli v dokumentu použít:
SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))
Všimněte si, že funkce SUM() může obsahovat libovolný vzorec sestávající z funkcí.
Funkce PLURALFORM
Používá se k připojení koncovky ke slovu nebo ke změně samotného slova, pokud jde o nepravidelné podstatné jméno, na základě čísla uvedeného před ním v šabloně dokumentu.
Formát:
PLURALFORM (number; "text1"; "text2";)
Podle vypočtené hodnoty čísla funkce vybere jeden ze dvou parametrů. Parametry musí být zadány v přísném pořadí podle algoritmu.
Například je potřeba ohýbat slovo "dollar". Postupujte podle algoritmu:
Nejprve napište požadované slovo s číslem 1:
- 1 dollar
To znamená, že první parametr ve funkci by měl být slovo "dollar" místo "text1".
Pak napište slovo s číslem 2:
- 2 dollars
To znamená, že druhý parametr ve funkci by měl být slovo "dollars" místo "text2".
Nakonec můžete v dokumentu použít následující funkci PLURALFORM():
Funkce NUMBERASWORDS
Tato funkce vrací číslo slovy. Je zapsána pouze celá část čísla.
Formát:
NUMBERASWORDS(number; Output; "language")
Kde:
- number — je číslo nebo vzorec
- Output — určuje, jak bude číslo zobrazeno (od 0 do 6)
- language — řetězec určující jazyk výstupu. Pokud je prázdný (""), použije se jazyk uživatele generujícího dokument.
Jazyky a jejich metody Output:
- Angličtina ("en")
- 0-3 — výchozí (základní číslovka)
- 4-6 — výchozí s velkým počátečním písmenem
- Němčina ("de")
- 0 — výchozí (rodově neutrální)
- 1 — psáno v ženském rodě
- 2 — psáno v mužském rodě
- 3 — psáno v stř. rodě
- 4 — psáno s velkým počátečním písmenem v ženském rodě
- 5 — psáno s velkým počátečním písmenem v mužském rodě
- 6 — psáno s velkým počátečním písmenem ve stř. rodě
- Francouzština ("fr")
- 0 — výchozí (základní číslovka)
- 1 — psáno v ženském rodě
- 2 — psáno v mužském rodě
- 4 — psáno s velkým počátečním písmenem v ženském rodě
- 5 — psáno s velkým počátečním písmenem v mužském rodě
Například pro zobrazení čísla slovy v dokumentu použijte tuto funkci:
NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")
Funkce FRACTIONALPART
Tato funkce zobrazí zlomek (desetinnou část) čísla. Můžete určit počet číslic za desetinnou čárkou, které chcete zobrazit.
Formát:
FRACTIONALPART(number; NumberOfDigitsAfterDecimal)
Například pro výstup počtu centů ceny služby v dokumentu použijte tuto funkci:
FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)
Tato funkce zobrazí dvě číslice za desetinnou čárkou:
- 176.03 — funkce vrátí 3.
- 15.15 — funkce vrátí 15.
- 16.156 — funkce zaokrouhlí první dvě desetinná místa na 16.