Zmienne w tekście

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

Nawigacja

• Obliczenia ze zmiennymi
• IF
• ELSE
• ELSEIF
• FOREACH
• TABLE
• FOREACH i TABLE z infoblockami

Zmienne przechowują pewną wartość, na przykład liczbę, ciąg znaków lub inny typ danych. Zmienne są używane w:

• Nazwie zadania (w szablonie zadania lub podczas tworzenia zadania)
• Opisie zadania (w szablonie zadania lub podczas tworzenia zadania)
• Szablonach e-mail
• Akcjach skryptów, przyciskach, przychodzących webhookach, regułach e-mail dla zadań:
  • Send HTTP request
  • Send SMS
  • Write to WhatsApp
  • Write to Instagram
• Hurtowych akcjach, skryptach, przyciskach, przychodzących webhookach, regułach 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 „różne zmienne” (1), utwórz zmienną i dodaj ją do tekstu odpowiedniego pola w szablonie zadania (2):

Obliczenia ze zmiennymi

Czasami nie wystarczy wstawić wartości zmiennej do tekstu — trzeba wykonać obliczenia na wartościach zmiennych lub przetworzyć otrzymany ciąg. 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ć zapisany w jednym wierszu i nie może być przerwany. Innymi słowy formuła nie może być przeniesiona do następnego wiersza przez naciśnięcie Enter.
• Zmienne w formule 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 w zależności 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 jest używany tylko razem z IF. Gdy warunek w IF nie jest prawdziwy, wyświetlana jest część z bloku ELSE.

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

Przykład

%%$IF({{Task. Invoice №}}="")$%%
Pole [Invoice №] nie jest wypełnione
%%$ELSE$%%
Wymagane pole zadania jest wypełnione! :)
%%$ENDBLOCK$%%

Wynik:

• Jeśli pole nie jest wypełnione, wyświetlony zostanie komunikat „Pole [Invoice №] nie jest wypełnione”.
• Jeśli pole jest wypełnione, wyświetlony zostanie komunikat „Wymagane pole zadania jest wypełnione! :)”.

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 ELSE jest częścią opcjonalną bloku.

Przykład

%%$IF({{Task.Invoice Number}}="")$%%
Pole [Invoice Number] nie jest wypełnione
%%$ELSEIF({{Task.UPD Number}}="")$%%
Pole [UPD Number] nie jest wypełnione
%%$ELSEIF({{Task.Contract Number}}="")$%%
Pole [Contract Number] nie jest wypełnione
%%$ELSE$%%
Wszystkie pola zadania są wypełnione, jesteś świetny! :)
%%$ENDBLOCK$%%

Wynik:

• Jeśli wszystkie trzy pola są niewypełnione, zostanie wyświetlony tylko pierwszy komunikat „Pole [Invoice Number] nie jest wypełnione”, pozostałe zostaną pominięte.
• Jeśli pola "Invoice Number" i "UPD Number" są wypełnione, ale pole "Contract Number" nie, zostanie wyświetlony odpowiedni komunikat „Pole [Contract Number] nie jest wypełnione”.

FOREACH

Gdy zmienna reprezentuje listę wartości, na przykład {{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, tzn. {{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świetleni tylko ci, 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 potrzebujesz 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ć tę informację klientowi jako tabelę. Tabelę dodano za pomocą 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 sum 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 wyróżnione na czerwono oznaczają, ile wierszy użyć w nagłówku i w sumie.

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.

Aby użyć dwóch wierszy w nagłówku tabeli, wpisz 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 tabeli i wybierz Row - Insert Row Above:

FOREACH i TABLE z infoblockami

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

• Wyodrębnij dane do infoblocków:
  • from JSON
  • from HTML table
• Następnie użyj następującej składni:

%%$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

• Zmienne w szablonach zadań
• Zmienne w szablonach dokumentów