Змінні в тексті: відмінності між версіями
Aliona (обговорення | внесок) Немає опису редагування |
Aliona (обговорення | внесок) Немає опису редагування |
||
Рядок 74: | Рядок 74: | ||
== '''ELSE''' == | == '''ELSE''' == | ||
Використовується тільки разом з | Використовується тільки разом з IF. Коли умова в IF не буде істинною, відобразиться текст з частини блоку ELSE. | ||
<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"> | <div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"> |
Версія за 09:39, 2 жовтня 2023
Навігація
Змінні зберігають у собі яке-небудь значення, наприклад, число, рядок або інший тип даних. Змінні використовуються в:
- Назві завдання (у шаблоні завдання або при створенні завдання)
- Описі завдання (у шаблоні завдання або при створенні завдання)
- Шаблонах листів
- Діях сценаріїв, кнопок, вхідних вебхуків, правилах для завдань поштою:
- Відправити HTTP-запит
- Надіслати SMS
- Написати в WhatsApp
- Написати в Instagram
- Змінах завдань масовими діями, сценаріями, кнопками, вхідними вебхуками, правилами для завдань поштою:
- Змінити назву
- Змінити опис
- Додати коментар
- Встановити значення поля (для полів типу «Текст»)
Щоб додати змінну в текст, наприклад, в опис завдання, перейдіть за посиланням «різні змінні» (1), сформуйте змінну і додайте її в текст потрібного поля шаблону завдання (2):
Обчислення над змінними
Іноді простого вставлення значення змінної в текст буває недостатньо, а вам необхідно перед тим зробити обчислення над значеннями в змінних або обробити отриманий у ній рядок. Для таких дій використовуйте наступний синтаксис:
%%%ТЕКСТ ФОРМУЛИ%%%
Приклади
Важливо
- Текст формули обов'язково записується в один рядок і ніяк не переноситься, тобто формулу не можна переносити на наступний рядок, натискаючи Enter.
- Змінну в формулі не можна форматувати, наприклад, виділяти жирним або робити курсивом.
- Якщо результат формули необхідно виділити жирним, то застосовуйте форматування одразу до всієї формули разом з відсотками.
IF
Для вставки тексту залежно від значень змінних (умови) використовується наступний синтаксис:
ТЕКСТ
%%$ENDBLOCK$%%
Конструкцію необхідно додавати одним рядком без пропусків і переносів:
Приклад
Результат:
ELSE
Використовується тільки разом з IF. Коли умова в IF не буде істинною, відобразиться текст з частини блоку ELSE.
%%$IF(Логічна формула)$%%
ТЕКСТ
%%$ELSE$%%
ТЕКСТ
%%$ENDBLOCK$%%
Конструкцію необхідно додавати одним рядком без пропусків і переносів:
%%$IF(Логічна формула)$%%ТЕКСТ%%$ ELSE$%%ТЕКСТ%%$ENDBLOCK$%%
Приклад
%%$IF({{Task.Номер рахунку}}="")$%%
Не заповнено поле [Номер рахунку]
%%$ELSE$%%
Потрібне поле завдання заповнено! :)
%%$ENDBLOCK$%%
Результат:
- Якщо поле буде не заповнено — виведеться повідомлення «Не заповнено поле [Номер рахунку]».
- Якщо поле буде заповнено — виведеться повідомлення «Потрібне поле завдання заповнено! :)».
ELSEIF
Допоможе зібрати більш складну конструкцію з умовами:
%%$IF(Логічна формула)$%%
ТЕКСТ
%%$ELSEIF(Логічна формула)$%%
ТЕКСТ
%%$ELSEIF(Логічна формула)$%%
ТЕКСТ
%%$ELSE$%%
ТЕКСТ
%%$ENDBLOCK$%%
Зверніть увагу
- Останнє ELSEIF — не обов'язкова частина блоку.
- Конструкцію необхідно додавати одним рядком без пропусків і переносів:
- %%$IF(Логічна формула)$%%ТЕКСТ%%$ELSEIF(Логічна формула)$%%ТЕКСТ%%$ELSEIF(Логічна формула)$%%ТЕКСТ%%$ ELSE$%%ТЕКСТ%%$ENDBLOCK$%%
Приклад
%%$IF({{Task.Номер рахунку}}="")$%%
Не заповнено поле [Номер рахунку]
%%$ELSEIF({{Task.Номер УПД}}="")$%%
Не заповнено поле [Номер УПД]
%%$ELSEIF({{Task.Номер контракту}}="")$%%
Не заповнено поле [Номер контракту]
%%$ELSE$%%
Всі поля завдання заповнені, ти молодець! :)
%%$ENDBLOCK$%%
Результат:
- Якщо всі три поля будуть не заповнені — виведеться лише перше повідомлення «Не заповнено поле [Номер рахунку]», інші будуть пропущені.
- Якщо поля «Номер рахунку» і «Номер УПД» будуть заповнені, а поле «Номер контракту» — ні, тоді відобразиться відповідний рядок «Не заповнено поле [Номер контракту]».
FOREACH
Коли змінна представляє собою список значень, наприклад {{Task.Subtasks}} або {{Task.Assignee}}, і вам необхідно вивести інформацію для кожного значення — використовуйте наступний синтаксис:
ТЕКСТ
%%$ENDBLOCK$%%
Важливо: в цій частині конструкції — %%$ДЛЯКОЖНОГО(Змінна;Роздільник)$%% — обов'язково вказуйте змінну першого рівня, тобто {{Task.Subtasks}} або {{Task.Assignee}} і ніяк інакше.
Конструкцію необхідно додавати одним рядком без пропусків і переносів:
Приклад
Результат:
Вася П'ятірочкін - Розробник
Катя Смирнова - СЕО
Результат:
2120 - Попередня обробка
2121 - Остаточна обробка
Приклад з умовою
%%$FOREACH(Змінна;Роздільник;Умова_БЕЗ_Якщо)$%%
ТЕКСТ
%%$ENDBLOCK$%%
%%$FOREACH({{Task.Subtasks}};"")$%%%%$IF({{Task.Subtasks.Status}}="ТКП додано в розрахунок")$%%
{{Task.Subtasks.Counterparty}}, сума контракту {{Task.Subtasks."Сума контракту (од. вим.)"}}
%%$КІНЕЦЬБЛОКУ$%%%%$ENDBLOCK$%%
Результат
Зі всього списку контрагентів, відобразити лише тих, у кого сума контракту більше 1000:
ТОВ Восход, 1500
ТОВ Рассвет, 1700
ТОВ Заря, 2500
Блок IF всередині блоку FOREACH
%%$FOREACH(Змінна;Роздільник)$%%
ТЕКСТ
%%$IF(Логічна формула)$%%
ТЕКСТ
%%$ENDBLOCK$%%
ТЕКСТ
%%$ENDBLOCK$%%
%%$FOREACH({{Task.Subtasks}})$%%%%$IF({{Task.Subtasks.Status}}="ТКП додано в розрахунок")$%%
{{Task.Subtasks.Counterparty}}, {{Task.Subtasks.Counterparty.Name}}, сума контракту {{Task.Subtasks."Сума контракту (од. вим.)"}}
%%$ENDBLOCK$%%%%$ENDBLOCK$%%
Результат:
ТОВ Восход, 5689845987654, 1500 од.
ТОВ Рассвет, 5689845125699, 1700 од.
ТОВ Заря, 5689845589674, 2500 од.
ТОВ Свет, 5689845235689, 500 од.
TABLE
Якщо змінна представляє собою список значень, і вам необхідно вивести інформацію для кожного значення у вигляді таблиці — використовуйте наступний синтаксис:
ТЕКСТ
%%$ENDBLOCK$%%
Приклад
Приклад показує, як з доданої до завдання аналітики виділити лише потрібні блоки і відправити цю інформацію клієнту у вигляді таблиці. Таблицю додають через панель редактора:
Замовлення №{{Task.Number}}
%%$TABLE({{Data tag.Послуга}})$%%
{{Data tag.Послуга.Назва послуги}} | {{Data tag.Послуга.Сума}} |
%%$ENDBLOCK$%%
Загальна сума замовлення: %%%ТЕКСТ(SUM({{Data tag.Послуга.Сума}});",.2f")+PLURAL(SUM({{Data tag.Послуга.Сума}}); " гривня"; " гривні"; " гривень")%%%
Результат:
Замовлення №2118
Графічний дизайн | 1 600,00 |
Програмування | 3 000,00 |
Розробка ТЗ | 300,00 |
Загальна сума замовлення: 4 900,00 гривень
Приклад з шапкою та підсумком
Щоб вивести в таблиці шапку або рядок підсумків, використовуйте в синтаксисі наступні параметри:
Таблиця, намальована за допомогою редактора ПланФікса
%%$ENDBLOCK$%%
Приклад::
%%$TABLE({{Data tag.Послуга}};1;1)$%%
№ | Назва | Вартість |
---|---|---|
{{Data tag.Послуга.Порядковий номер запису}} | {{Data tag.Послуга.Назва послуги}} | {{Data tag.Послуга.Сума}} |
Підсумок | %%%SUM({{Data tag.Послуга.Сума}})%%% |
%%$ENDBLOCK$%%
Результат:
№ | Назва | Вартість |
---|---|---|
1 | Розробка ТЗ | 1 000,00 |
2 | Програмування | 3 705,00 |
3 | Графічний дизайн | 1 035,00 |
4 | Тестування | 690,00 |
Підсумок | 6430 |
Цифри, виділені червоним кольором, показують, скільки рядків на початку і в кінці таблиці використовувати для заголовка і підсумків.
Так, у прикладі вище зазначені цифри (1;1) — це означає, що один рядок на початку буде використаний для заголовка таблиці, а один рядок в кінці буде використаний для підсумків таблиці.
Для того, щоб використати два рядки у заголовку таблиці, вкажіть це так — (2;1).
Приклад:
%%$ТАБЛИЦА({{Data tag.Послуга}};2;1)$%%
Набір послуг | ||
---|---|---|
№ | Назва | Вартість |
{{Data tag.Послуга.Порядковий номер запису}} | {{Data tag.Послуга.Назва послуги}} | {{Data tag.Послуга.Сума}} |
Підсумок | %%%Сума({{Data tag.Услуга.Сумма}})%%% |
%%$ENDBLOCK$%%
Результат:
Набір послуг | ||
---|---|---|
№ | Назва | Вартість |
1 | Розробка ТЗ | 1 000,00 |
2 | Програмування | 3 705,00 |
3 | Графічний дизайн | 1 035,00 |
4 | Тестування | 690,00 |
Підсумок | 6430 |
Приклад з умовою
%%$TABLE(Змінна;0;0;Умова_БЕЗ_якщо_якщо)$%%
Таблиця, намальована за допомогою редактора ПланФікса
%%$ENDBLOCK$%%
%%$TABLE({{Task.Subtasks}};1;0;{{Task.Subtasks.Status}}="ТКП додано в розрахунок")$%%
Контрагент | ЄДРПОУ | Сума контракту |
---|---|---|
{{Task.Subtasks.Counterparty}} | {{Task.Subtasks.Counterparty.ЄДРПОУ}} | {{Task.Subtasks."Сума контракту (у.о.)"}}{{Task.Subtasks.Валюта.Символ}} |
%%$ENDBLOCK$%%
Результат:
Контрагент | ЄДРПОУ | Сума контракту |
---|---|---|
5689845987654 | 1500$ | |
ТОВ Рассвет | 5689845125699 | 1700$ |
ТОВ Заря | 5689845589674 | 2500$ |
ТОВ Світло | 5689845235689 | 500$ |
Чтобы добавить в таблицу шапку, нажмите на нее правой кнопкой мыши и выберите Cтрока - Вставить строку сверху: Щоб додати в таблицю заголовок, клацніть на неї правою кнопкою миші і виберіть Рядок - Вставити рядок зверху:
Важливо
В TABLE на даний момент не підтримується вкладеність конструкцій, отже блок ЯКЩО всередині TABLE не працюватиме. Тимчасове рішення — використовувати блок TABLE з функцією IF, тобто замість блоку «%%$IF» використовувати функцію «%%%IF».
FOREACH і TABLE з інфоблоками
При розгляді листа або відповіді на HTTP-запит ви отримуєте кілька рядків даних і бажаєте додати їх до коментаря у вигляді структурованого тексту або таблиці:
- Витягніть дані в інфоблоки:
- Потім скористайтеся наступним синтаксисом:
%%$FOREACH({{Infoblock.!row}};Роздільник)$%%
{{Infoblock.!row.Ім'я інфоблоку}}
%%$ENDBLOCK$%%
%%$TABLE({{Infoblock.!row}})$%%
{{Infoblock.!row.Ім'я інфоблоку}}
%%$ENDBLOCK$%%
Приклад
Витягнемо дані в інфоблоки «Товар» і «Ціна» та додамо їх до таблиці:
%%$TABLE({{Infoblock.!row}})$%%
{{Infoblock.!row.Товар}} | {{Infoblock.!row.Ціна}} |
%%$ENDBLOCK$%%
Результат:
Олівець | 150,00 |
Ручка | 200,00 |
Зошит | 100,00 |