Webitel: Документація

Компонент "Form File"

1. Опис

Компонент для динамічних сторінок (форм) оператора, що відображає в Workspace контейнер для вхідних/вихідних файлів.

Цей компонент присутній у схемах типу:

  • Форми.

Блок (Рис. 1.(1)) використовується у полі для побудови схеми. При натисканні на блок відкривається панель налаштувань даного компонента (Рис. 1.(2)).

Form File.png
Рис. 1. Компонент "Form File”

1.1. Блок "Form File"

Блок складається з таких елементів:

  1. Назви компонента;

  2. Гілка "In" - гілка, що приймає (з'єднує з іншим блоком);

  3. Гілка "Out" - вихідна (з'єднує з наступним блоком) гілка.

При наведенні на поле "Out" з'являється перемикач, який дозволяє з'єднати цей компонент з компонентом, який вже має з'єднання.

Наявність іконки Screenshot 2024-11-07 154742.png позначає, що перемикач увімкнено, і цей компонент можна з'єднати з компонентом, який уже має з'єднання.

Зміна положення перемикача видаляє вихідну гілку цього компонента.

Кнопка Screenshot 2024-11-07 155145.png видаляє блок зі схеми.

1.2. Панель налаштувань "Form File"

Складається з таких елементів (Рис. 2):

Form File - блок налаштувань.png
Рис. 2. Панель налаштувань “Form File“

1.2.1 Поле "Id"

У цьому полі задається назва* (унікальна в межах схеми) - службова назва, що не відображається на сторінці. Використовується як змінна для подальшого доступу до значень.

1.2.2 Елемент "View"

Призначений для налаштування відображення (Рис. 3).

Складається з таких елементів:

  1. Поле "Initial value";

  2. Поле "Label";

  3. Поле "Hint";

  4. Перемикач "Readonly";

  5. Перемикач "Collapsible".

1.2.3. Поле "Initial value"

Якщо перемикач “Readonly” увімкнено:

  • У "Initial value" поле викликається змінна, в яку передаються прикріплені файли з листа.

Задати таку змінну можна в компоненті "Get Email" в елементі "Set variables": у полі "Value" вводитися - attachments, а в полі "Key" вводиться назва змінної, яку будемо викликати тут.

Наприклад, у компоненті "Get Email" в елементі "Set variables" у полі "Value" вказали - attachments, а в полі "Key" вказали — Файли. Тоді в поле "Initial value" необхідно ввести - ${Файли}.

Якщо перемикач "Readonly" вимкнений:

  • У полі "Initial value" викликається змінна, в яку передаються файли. Ці файли будуть прикріплені до повідомлення, що відправляє.

1.2.4. Поле "Label"

У цьому полі вводиться текст, який буде відображатися, як заголовок над файлом (Рис. 3). Якщо поле залишити порожнім, то контейнер буде без заголовка.

1.2.5. Поле "Hint"

У цьому полі можна задати підказку. Підказка відображатиметься під час наведення курсора на Снимок экрана 2024-06-25 164459.png (Рис. 3).

Значок не відображатиметься, якщо поле залишити порожнім.

1.2.6. Перемикач "Readonly"

image2024-6-26_13-52-22.png?version=1&modificationDate=1719399146433&cacheVersion=1&api=v2 - відображає контейнер для вхідних файлів у Workspace.

  • Натискання на кнопку Screenshot 2024-03-28 195626.png завантажує вхідний файл у форматі .zip.

  • Натискання на назву файлу завантажує сам файл.

image2024-6-26_13-52-54.png?version=1&modificationDate=1719399179222&cacheVersion=1&api=v2 - відображає контейнер для вихідних файлів у Workspace (Рис. 3).

При натисканні на image2024-6-26_13-45-40.png?version=1&modificationDate=1719398744835&cacheVersion=1&api=v2 відкривається вікно для вибору файлу, який буде прикріплений.

Контейнер для вихідних файлів.png
Рис. 3. Контейнер для вихідних файлів у Workspace
1.2.7. Перемикач "Collapsible"

Перемикач відповідає за можливість розгортати\згортати блок із файлами:

  • image2024-6-26_13-52-54.png?version=1&modificationDate=1719399179222&cacheVersion=1&api=v2 - блок із файлами за замовчуванням розгорнутий без можливості згортати;

  • image2024-6-26_13-52-22.png?version=1&modificationDate=1719399146433&cacheVersion=1&api=v2 - блок із файлами за замовчуванням згорнуто. Є можливість розгортати\згортати блок (Рис. 3).

  • image2024-6-26_14-3-51.png?version=1&modificationDate=1719399836509&cacheVersion=1&api=v2 - розгортає блок;

  • image2024-6-26_14-4-13.png?version=1&modificationDate=1719399857752&cacheVersion=1&api=v2 - згортає блок (Рис. 3).

Призначений для прив’язки файлів до сутностей. Складається з таких елементів:

  1. Перемикач “Custom channel”;

  2. Поле “Channel”;

  3. Поле “Entity id”.

1.2.9. Перемикач “Custom channel”

Перемикач, який визначає, чи використовувати власний канал.

За замовчуванням вимкнений image-20251023-080755.png .

Якщо перемикач вимкнений image-20251023-080755.png , інші поля блоку неактивні.

1.2.10. Поле “Channel”

Поле вибору. Містить два варіанти:

  • email — для файлів з листів;

  • case — для файлів, прикріплених до звернень.

Поле стає активним лише після ввімкнення image2024-6-26_13-52-22.png?version=1&modificationDate=1719399146433&cacheVersion=1&api=v2 перемикача “Custom channel”.

1.2.11. Поле “Entity id”

Поле введення для зазначення ідентифікатора сутності.

Поле стає активним лише після ввімкнення image2024-6-26_13-52-22.png?version=1&modificationDate=1719399146433&cacheVersion=1&api=v2 перемикача “Custom channel”.

1.2.12. Перемикач "Break"

Відповідає за закінчення виконання схеми.

image-20241231-124210.png - ініціює закінчення виконання схеми після цього компонента;

image-20241231-124231.png - перемикач у вимкненому положенні.

1.2.13. Елемент "Limit"

Призначений для визначення максимальної кількості проходжень через цей компонент.

Натискання на кнопку "Add limit" додає поле "Max" та кнопку "Delete limit".

У полі “Max” вказується кількість можливих проходжень.

Якщо через компонент проходження буде більше, ніж зазначено в полі "Max", то використовуватиметься гілка "failover", яка з'являється в блоці компонента при установці ліміту.

Натискання на кнопку "Delete limit" забирає ліміт, повертаючи кнопку "Add limit".

Limit.png


Рис. 4. Встановлення ліміту

1.2.14. Елемент "Add description"

Натискання на кнопку "Add description" додає поле "Description" та кнопку "Delete description".

У полі "Description" вказується опис — коментарі до компонента.

Натискання на кнопку "Delete description" прибирає опис, повертаючи кнопку "Add description".

Description.png


Рис. 5. Елемент "Add description"