Документация 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" появляется переключатель, который позволяет соединить этот компонент с компонентом, уже имеющим соединение.

Наличие иконки  image2024-11-7_15-47-46.png  обозначает, что  переключатель включен, и данный компонент можно соединить с компонентом, уже имеющим соединение.

Смена положения переключателя  удаляет исходящую ветку этого компонента.

Кнопка  image2024-11-7_15-51-56.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"

В этом поле вводится текст, который будет отображаться, как заголовок над файлом (Рис. 2). Если поле оставить пустым, то контейнер будет без заголовка.

1.2.5. Поле "Hint"

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

Значок не будет отображаться если поле оставить пустым.

1.2.6. Переключатель "Readonly"

image2024-6-26_13-52-22.png  - отображает контейнер для входных файлов в Workspace.

  • Нажатие на  Снимок экрана 2024-03-19 172801.png  кнопку скачивает входной файл в формате .zip.

  • Нажатие на название файла скачивает сам файл.

image2024-6-26_13-52-54.png  - отображает контейнер для исходящих файлов в Workspace (Рис. 3).

При нажатии на image2024-6-26_13-45-40.png  открывается окно для выбора файла, который будет прикреплен.

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

Переключатель отвечает за возможность разворачивать\сворачивать блок с файлами:

image2024-6-26_13-52-54.png  - блок с  файлами по умолчанию развернут без возможности сворачивать;

image2024-6-26_13-52-22.png  - блок с файлами по умолчанию свернут. Есть возможность разворачивать\сворачивать блок (Рис. 3).

  • image2024-6-26_14-3-51.png  - разворачивает блок;

  • image2024-6-26_14-4-13.png  - сворачивает блок (Рис. 3).

Предназначен для привязки файлов к сущностям. Состоит из следующих элементов:

  • Переключатель “Custom channel”;

  • Поле “Channel”;

  • Поле “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-20250704-085952.png - инициирует окончание выполнения схемы после данного компонента;

  • image-20250704-085922.png - переключатель отключен.

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

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

Если через компонент прохождений будет больше, чем указано в поле "Max", то будет использоваться ветка "failover"- image2024-1-26_12-1-12.png , которая появляется в блоке компонента при установке лимита.

Нажатие на кнопку "Add limit" добавляет поле "Max" и кнопку "Delete limit".

В поле "Max" указывается количество возможных прохождений.

Нажатие на кнопку "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"