Funkcje w szablonach dokumentów
Funkcje można stosować podczas automatycznego formatowania dokumentów przy użyciu szablonów. Funkcje upraszczają sposób wyświetlania danych w dokumentach. Na przykład można użyć formuł do automatycznego wyświetlania liczb słownie lub obliczania kosztów zamówień.
Formuły
Aby dodać formułę do dokumentu, użyj następującej składni: %%%FORMULA%%%.
FORMULA to wyrażenie służące do obliczania wartości pola, podobnie jak w polu obliczeniowym.
Przykład:
W powyższym przykładzie do formuły dodawane są dane z znacznika danych "Service" za pomocą odpowiadających zmiennych. Dwie wartości są mnożone, a wynik jest wartością całkowitego kosztu konkretnej usługi lub produktu. Funkcja TEXT() formatuje wartość jako czytelny ciąg tekstowy.
Ważne
Na przykład:
- Formuły muszą być zapisane w jednym ciągu i nie można ich dzielić przez naciśnięcie Enter. Jeśli potrzebujesz wstawić znak nowej linii, użyj sekwencji "\n".
- Bez łamania linii
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Z łamaniem linii
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Zmienne wewnątrz formuły nie mogą być formatowane, na przykład przez pogrubienie lub kursywę.
- Jeżeli chcesz, aby wynik formuły był wyświetlony pogrubioną czcionką, zastosuj formatowanie do całej formuły, łącznie z symbolami procenta.
Funkcje
Wszystkie funkcje dostępne w formułach szablonów dokumentów:
Funkcja SUM
SUM() to funkcja, która sumuje wszystkie wartości uzyskane podczas obliczania formuły. Stosuje się ją do każdego elementu mnożonej zmiennej.
Na przykład, jeśli masz znacznik danych "Service" i chcesz obliczyć całkowity koszt wszystkich usług w dokumencie, użyj następującej funkcji:
SUM({{DataTag.Service.Cost}})
Aby uzyskać całkowity koszt świadczonych usług, musisz pomnożyć koszt usługi przez ilość razy, kiedy została zamówiona. Oto formuła, którą powinieneś użyć w dokumencie:
SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))
Zauważ, że funkcja SUM() może zawierać dowolną formułę złożoną z funkcji.
Funkcja PLURALFORM
Służy do dopasowania końcówki słowa lub zmiany samego słowa, jeśli jest ono nieregularne, w zależności od liczby podanej wcześniej w szablonie dokumentu.
Składnia:
PLURALFORM (number; "text1"; "text2";)
W zależności od obliczonej wartości number, funkcja wybiera jeden z dwóch parametrów. Parametry muszą być podane w ścisłej kolejności zgodnie z algorytmem.
Na przykład, jeśli potrzebujesz odmienić słowo "dollar", postępuj zgodnie z algorytmem:
Najpierw zapisz wymagane słowo dla liczby 1:
- 1 dollar
Oznacza to, że pierwszy parametr w funkcji powinien być słowem "dollar" zamiast "text1".
Następnie zapisz słowo dla liczby 2:
- 2 dollars
Oznacza to, że drugi parametr w funkcji powinien być słowem "dollars" zamiast "text2".
Na koniec możesz umieścić następującą funkcję PLURALFORM() w dokumencie:
Funkcja NUMBERASWORDS
Jest to funkcja, która zwraca liczbę zapisano słownie. Zapisywana jest tylko część całkowita liczby.
Składnia:
NUMBERASWORDS(number; Output; "language")
Gdzie:
- number — liczba lub formuła
- Output — definiuje sposób wyświetlania liczebnika (od 0 do 6)
- language — ciąg określający język wyjściowy. Jeśli pozostawiony pusty (""), używany jest język użytkownika generującego dokument.
Języki i ich metody Output:
- Angielski ("en")
- 0-3 — domyślnie (liczba główna)
- 4-6 — domyślnie, ale z wielką literą
- Niemiecki ("de")
- 0 — domyślnie (neutralne płciowo)
- 1 — zapisane w formie żeńskiej
- 2 — zapisane w formie męskiej
- 3 — zapisane w formie nijakiej
- 4 — z wielką literą w formie żeńskiej
- 5 — z wielką literą w formie męskiej
- 6 — z wielką literą w formie nijakiej
- Francuski ("fr")
- 0 — domyślnie (liczba główna)
- 1 — zapisane w formie żeńskiej
- 2 — zapisane w formie męskiej
- 4 — z wielką literą w formie żeńskiej
- 5 — z wielką literą w formie męskiej
Na przykład, aby wyświetlić liczbę słownie w dokumencie, użyj następującej funkcji:
NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")
Funkcja FRACTIONALPART
Ta funkcja wyświetla część ułamkową liczby. Możesz określić liczbę cyfr po przecinku, które chcesz zobaczyć.
Składnia:
FRACTIONALPART(number; NumberOfDigitsAfterDecimal)
Na przykład, aby wyświetlić liczbę centów dla kosztu usługi w dokumencie, użyj następującej funkcji:
FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)
Funkcja zwraca dwie cyfry po przecinku:
- 176.03 — funkcja zwraca 3.
- 15.15 — funkcja zwraca 15.
- 16.156 — funkcja zaokrągla pierwsze dwie cyfry do 16.