Zmienne w tekście

Z Planfix
Wersja z dnia 01:30, 7 gru 2025 autorstwa PlanfixBot (dyskusja | edycje) (Utworzono nową stronę "{{#seo: |title=Zmienne w tekście |titlemode=append |keywords=planfix, variables, task template, document template, using variables, variables in text, text with variables, for each, foreach, if, else, elseif, table |description=Używanie zmiennych w tekście }} <div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Ten artykuł pomocy nie dotyczy szablonów dokumentów. Przeczytaj jak używać zmiennych w szablonach dokumentów Zmienne w szablon…")
(różn.) ← poprzednia wersja | przejdź do aktualnej wersji (różn.) | następna wersja → (różn.)
Skocz do: nawigacja, szukaj

Ten artykuł pomocy nie dotyczy szablonów dokumentów. Przeczytaj jak używać zmiennych w szablonach dokumentów tutaj.

Nawigacja

Zmienne przechowują pewną wartość, taką jak liczba, ciąg znaków lub inny typ danych. Zmienne są używane w:

  • Nazwa zadania (w szablonie zadania lub podczas tworzenia Zadania)
  • Opis zadania (w szablonie zadania lub podczas tworzenia Zadania)
  • Szablony wiadomości e-mail
  • Akcje skryptów, przyciski, przychodzące webhooki, reguły e-mail dla zadań:
    • Send HTTP request
    • Send SMS
    • Write to WhatsApp
    • Write to Instagram
  • Operacje masowe, skrypty, przyciski, przychodzące webhooki, reguły e-mail dla zadań:
    • Change name
    • Change description
    • Add comment
    • Set field value (dla pól typu "Text")


Aby dodać zmienną do tekstu, na przykład w opisie zadania, kliknij link "different variables" (1), utwórz zmienną i dodaj ją do tekstu wybranego pola w szablonie zadania (2):

vBmUi1.jpg

Obliczenia ze zmiennymi

Czasami nie wystarczy wstawić wartość zmiennej do tekstu — trzeba także wykonać obliczenia na wartościach zmiennych lub przetworzyć otrzymany ciąg znaków. Do takich działań używa się następującej składni: 

%%%FORMULA TEXT%%%

Przykłady

Discounted price: %%%{{Task.Price}}*0.8%%%
Work will be completed in %%%DATEDIF(NOW(); {{Task.Completion Date}}; "d")%%% %%%MULTIPLE(DATEDIF(NOW(); {{Task.Completion Date}}; "d");"day"; "days")%%%

Ważne

  • Tekst formuły musi być napisany w jednej linii i nie może być łamany. Innymi słowy, formuła nie może być przenoszona do następnego wiersza przez naciśnięcie Enter.
  • Zmienne wewnątrz formuły nie mogą być formatowane, np. pogrubione lub kursywą.
  • Jeśli chcesz wyróżnić wynik formuły pogrubieniem, zastosuj formatowanie do całej formuły wraz z wynikiem.

IF

Aby wstawić tekst zależny od wartości zmiennych (warunków), użyj następującej składni:

%%$IF(Logical formula)$%%
TEXT
%%$ENDBLOCK$%%

Przykład

%%$IF({{Task.Order Amount}} > 100000)$%%
VIP CUSTOMER
%%$ENDBLOCK$%%


Wynik:

VIP CUSTOMER

ELSE

ELSE używa się wyłącznie razem z IF. Gdy warunek w IF nie jest spełniony, wyświetlany jest tekst z części ELSE bloku.

%%$IF(Logical formula)$%%
TEXT
%%$ELSE$%%
TEXT
%%$ENDBLOCK$%%

Przykład

%%$IF({{Task. Invoice №}}="")$%%
The field [Invoice №] is not filled in
%%$ELSE$%%
The required task field is filled in! :)
%%$ENDBLOCK$%%


Wynik:

  • Jeśli pole nie jest wypełnione, wyświetlony zostanie komunikat "The field [Invoice №] is not filled in".
  • Jeśli pole jest wypełnione, wyświetlony zostanie komunikat "The required task field is filled in! :)".

ELSEIF

Pozwala stworzyć bardziej złożone wyrażenie z warunkami:

%%$IF(Logical formula)$%%
TEXT
%%$ELSEIF(Logical formula)$%%
TEXT
%%$ELSEIF(Logical formula)$%%
TEXT
%%$ELSE$%%
TEXT
%%$ENDBLOCK$%%


Uwaga

  • Ostatni fragment ELSE jest opcjonalny.

Przykład

%%$IF({{Task.Invoice Number}}="")$%%
The field [Invoice Number] is not filled in
%%$ELSEIF({{Task.UPD Number}}="")$%%
The field [UPD Number] is not filled in
%%$ELSEIF({{Task.Contract Number}}="")$%%
The field [Contract Number] is not filled in
%%$ELSE$%%
All task fields are filled in, you're awesome! :)
%%$ENDBLOCK$%%


Wynik:

  • Jeśli wszystkie trzy pola nie są wypełnione, wyświetlony zostanie tylko pierwszy komunikat "The field [Invoice Number] is not filled in", pozostałe zostaną pominięte.
  • Jeśli pola "Invoice Number" i "UPD Number" są wypełnione, ale pole "Contract Number" nie jest, wyświetlony zostanie odpowiedni komunikat "The field [Contract Number] is not filled in".

FOREACH

Gdy zmienna reprezentuje listę wartości, np. {{Task.Subtasks}} lub {{Task.Assignee}}, i trzeba wyświetlić informacje dla każdej wartości, użyj następującej składni:

%%$FOREACH(Variable;Delimiter)$%%
TEXT
%%$ENDBLOCK$%%


Ważne: w tej części wyrażenia — %%$FOREACH(Variable;Delimiter)$%% — koniecznie podaj zmienną pierwszego poziomu, np. {{Task.Subtasks}} lub {{Task.Assignee}}, i nic więcej.

Przykład

%%$FOREACH({{Task.Assignee}};"<br>")$%%{{Task.Assignee}} - {{Task.Assignee.Position}}%%$ENDBLOCK$%%


Wynik:

linda Martinez - Designer
Jamse Davis - Developer
Mary Brown - CEO
%%$FOREACH({{Task.Subtasks}};"<br>")$%%{{Task.Subtasks.Number}} - {{Task.Subtasks.Name}}%%$ENDBLOCK$%%


Wynik:

2119 - Rough finish
2120 - Sub-final finishing
2121 - Final touches

Przykład z warunkiem

Składnia:

%%$FOREACH(Variable;Delimiter;Condition_WITHOUT_If)$%%
TEXT
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}};"";{{Task.Subtasks."Contract Amount ($)"}}>1000))$%%
{{Task.Subtasks.Counterparty}}, contract amount {{Task.Subtasks."Contract Amount ($)"}}
%%$ENDBLOCK$%%


Wynik

Z całej listy kontrahentów zostaną wyświetlone tylko te, których kwota kontraktu jest większa niż 1000:

LLC Sunrise, 1500

LLC Sunset, 1700

LLC Dawn, 2500

Blok ELSE wewnątrz FOREACH

Składnia:

%%$FOREACH(Variable;Delimiter)$%%
TEXT
 %%$IF(Logical formula)$%%
TEXT
 %%$ENDBLOCK$%%
TEXT
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}})$%%%%$IF({{Task.Subtasks.Status}}="TKP added to calculation")$%%
{{Task.Subtasks.Counterparty}}, {{Task.Subtasks.Counterparty.TIN}}, contract amount {{Task.Subtasks."Contract Amount"}} {{Task.Subtasks.Currency.Symbol}}
%%$ENDBLOCK$%%%%$ENDBLOCK$%%


Wynik:

LLC Sunrise, 5689845987654, 1500 $
LLC Sunset, 5689845125699, 1700 $
LLC Dawn, 5689845589674, 2500 $
LLC Light, 5689845235689, 500 $

TABLE

Jeśli zmienna reprezentuje listę wartości i chcesz wyświetlić informacje dla każdej wartości w postaci tabeli, użyj następującej składni:

%%$TABLE(Variable)$%%
TEXT
%%$ENDBLOCK$%%

Przykład

Przykład pokazuje, jak wyciągnąć tylko potrzebne bloki z dodanego Znacznika danych w zadaniu i wysłać te informacje do klienta jako tabelę. Tabelę dodaje się przy użyciu edytora Planfix:

Order №{{Task.Number}}

%%$TABLE({{Data tag.Service}})$%%

{{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}

%%$ENDBLOCK$%%

Total order amount: %%%TEXT(SUM({{Data tag.Service.Amount}});",.2f")+MULTIPLE(SUM({{Data tag.Service.Amount}}); " ruble"; " rubles")%%%


Wynik:

Order №2118

Graphic design 1 600.00
Programming 3 000.00
Development of TA 300.00

Total order amount: 4 900.00 dollars

Przykład z nagłówkiem i sumą

Aby dodać nagłówek lub wiersz z sumami do tabeli, użyj następujących parametrów w składni:

%%$TABLE(Variable;0;0)$%%
Tabela narysowana przy użyciu edytora Planfix
%%$ENDBLOCK$%%

Przykład: %%$TABLE({{Data Tag.Service}};1;1)$%%

# Name Price
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Total %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Wynik:

# Name Price
1 Development of TA 1 000.00
2 Programming 3 705.00
3 Graphic design 1 035.00
4 Testing 690.00
Total 6430

Liczby zaznaczone na czerwono oznaczają, ile wierszy użyć w nagłówku i sumach.

Na przykład, liczby (1;1) w powyższym przykładzie oznaczają, że jeden wiersz na początku będzie użyty jako nagłówek tabeli, a jeden wiersz na końcu będzie użyty jako suma tabeli.

Aby użyć dwóch wierszy w nagłówku tabeli, podaj to tak — (2;1).

Przykład: %%$TABLE({{Data tag .Service}};2;1)$%%

Set of services
# Name Price
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Total %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Wynik:

Set of services
# Name Price
1 Development of TA 1 000.00
2 Programming 3 705.00
3 Graphic design 1 035.00
4 Testing 690.00
Total 6430

Przykład z warunkiem

%%$TABLE(Variable;0;0;Condition_WITHOUT_If)$%%
Tabela narysowana przy użyciu edytora Planfix
%%$ENDBLOCK$%%


%%$TABLE({{Task.Subtasks}};1;0;{{Task.Subtasks.Status}}="TKP added to calculation")$%%

Counterparty TIN Contract amount
{{Task.Subtasks.Counterparty}} {{Task.Subtasks.Counterparty.TIN}} {{Task.Subtasks."Contract Amount"}}{{Task.Subtasks.Currency.Symbol}}

%%$ENDBLOCK$%%


Wynik:

Counterparty TIN Contract amount
LLC Sunrise 5689845987654 1500$
LLC Sunset 5689845125699 1700$
LLC Dawn 5689845589674 2500$
LLC Light 5689845235689 500$


Aby dodać nagłówek do tabeli, kliknij prawym przyciskiem myszy na tabelę i wybierz Row - Insert Row Above:

Pvy4PR.jpg

FOREACH i TABLE z infoblockami

Podczas parsowania e-maila lub odpowiadania na żądanie HTTP otrzymujesz kilka linii danych i chcesz dodać je w postaci tekstu strukturalnego lub tabeli:

%%$FOREACH({{Infoblock.!line}};Separator)$%%
{{Infoblock.!line.Infoblock name}}
%%$ENDBLOCK$%%

%%$TABLE({{Infoblock.!line}})$%%
{{Infoblock.!line.Infoblock name}}
%%$ENDBLOCK$%%


Przykład

Wyodrębnijmy dane do infoblocków "Product" i "Price" i dodajmy je do tabeli:

%%$TABLE({{Infoblock.!line}})$%%

{{Infoblock.!string.Product}} {{Infoblock.!string.Price}}

%%$ENDBLOCK$%%


Wynik:

Pencil 1,00
Pen 2,00
Notebook 10,00


Przejdź do

Źródło: „http://planfix.com/pl/help/index.php?title=Zmienne_w_tekście&oldid=2692”