Funkcje w szablonach dokumentów

Z Planfix
Wersja z dnia 01:23, 7 gru 2025 autorstwa PlanfixBot (dyskusja | edycje) (Utworzono nową stronę "{{#seo: |title=Funkcje w szablonach dokumentów |titlemode=append |keywords= Planfix, dokument, szablony, dokumenty |description=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ń…")
(różn.) ← poprzednia wersja | przejdź do aktualnej wersji (różn.) | następna wersja → (różn.)
Skocz do: nawigacja, szukaj

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:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%


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:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

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.

Przejdź do

Źródło: „http://planfix.com/pl/help/index.php?title=Funkcje_w_szablonach_dokumentów&oldid=2636”