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

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

1. Описание

Позволяет отобразить таблицу с внешними данными в форме схемы.

Данный компонент присутствует в схемах типа:

  • Формы.

Блок (Рис. 1.(1)) размещается в поле для построения схемы. При нажатии на блок открывается панель настроек компонента (Рис. 1.(2)).

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

2. Блок "Form Table"

Блок "Form Table" (Рис. 1.(1)) состоит из следующих элементов:

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

  • Ветка "In" — входящая (соединяет с предыдущим блоком);

  • Ветка "Out" — исходящая (соединяет со следующим блоком).

При наведении на поле "Out" появляется переключатель, который позволяет соединить компонент с блоком, уже имеющим соединение.

Наличие иконки image-20250423-134221.png означает, что переключатель включен, и компонент можно соединить с другим, уже подключенным блоком.

Изменение положения переключателя image-20250423-134248.png удаляет исходящую ветку компонента.

Кнопка icon_delete.png удаляет блок из схемы.

3. Панель настроек "Form Table"

Панель настроек компонента "Form Table" (Рис. 2) состоит из следующих элементов:

Рис. 2. Панель настроек "Form Table”

3.1. Поле "ID"

Уникальный идентификатор компонента в схеме (Рис. 2.(1)).

Значение, выбранное оператором в поле выбора сервиса, будет сохранено в переменной с этим идентификатором. Его можно использовать на следующих этапах схемы.

3.2. Поле “Source”

Текстовое поле ввода (Рис. 2.(2)), в которое можно передать переменную с JSON-объектом. Таблица будет сформирована на его основе.

3.3. Переключатель “Use system sources”

Если включен – image-20250327-111321.png — активируется поле System sources, а поле Source блокируется (Рис. 2.(3)).

3.4. Поле “System sources”

Выбор системных объектов Webitel (Рис. 2.(4)):

  • "Users";

  • "Roles";

  • Contacts“;

  • Calendars“;

  • Lists“;

  • Queues“;

  • Communication Types“;

  • Cases“;

  • Contact Groups“;

  • Case Sources“;

  • Agents“;

  • Priorities“.

Данные из этого источника используются для построения таблицы.

3.5. Блок "Display columns"

В этом блоке (Рис. 2.(5)) настраиваются колонки, которые будут отображены в таблице:

  • Display column;

  • Display name;

  • Width (px).

3.6. Поле "Display column"

Название колонки (например, phone_number), которая будет выведена (Рис. 2.(6)).

3.7. Поле "Display name"

Название системной колонки для выбора, отображаемое в форме (Рис. 2.(7)).

3.8. Поле "Width (px)"

Ширина колонки в пикселях. Если не задана, рассчитывается автоматически (Рис. 2.(8)).

3.9. Кнопка "Add"

Нажатие на кнопку "Add" (Рис. 2.(9)) добавляет новую колонку (Рис. 3). После этого становится доступной кнопка "Delete" для ее удаления.

image-20250423-141802.png
Рис. 3. Добавление новой колонки после нажатия на кнопку “Add”

3.10. Блок “Fields”

Блок (Рис. 2.(10)) позволяет настроить, какие поля из системного объекта нужно отобразить в форме.

3.11. Поле “Field”

Текстовое поле (Рис. 2.(11)), в котором указывается имя одного из нужных полей. Название должно точно соответствовать полю в источнике.

Можно добавить новые поля – image-20250627-124150.png или удалить их – image-20250627-124236.png.

3.12. Блок "Filters"

Блок (Рис. 2.(12)) появляется только при включенном переключателе "Use system sources" (см. раздел 3.3). Позволяет задать условия, по которым данные из выбранного источника будут отображаться в таблице.

3.13. Поле "Filter"

Поле “Filter (Рис. 2.(13)) позволяет вручную задать условие для фильтрации данных из выбранного источника.

Чтобы правильно заполнить это поле:

  1. Перейдите в раздел, где находится нужная вам сущность (например, CRM Контакты).

  2. Примените нужный фильтр в обычном интерфейсе (Рис. 4).

CRM_Контакты.png
Рис. 4. Применение фильтров
  1. Откройте инструменты разработчика ("DevTools") и перейдите на вкладку "Network" (Рис. 5).

Network_Контакты.png
Рис. 5. Вкладка "Network" в DevTools
  1. Найдите запрос добавления фильтров (Рис. 6.(1)) и перейдите на вкладку “Payload (Рис. 6.(2)).

payload_контакты.png
Рис. 6. Поиск запроса и переход на вкладку “Payload” в DevTools
  1. Скопируйте имя параметра и значение (например, user true) (Рис. 7).

image-20250619-134705.png
Рис. 7. Пример параметра и значения
  1. Перейдите к компоненту схемы и впишите значение в поле “Filter” в следующем формате

user=true

Обязательно удалите пробелы и используйте знак "=" между полем и значением (Рис. 8).

Filters.png
Рис. 8. Пример ввода значения в поле “Filters”

Иконка image-20250627-144022.png позволяет создать дополнительное поле “Filter” в блоке “Filters”. Это дает возможность задать несколько условий фильтрации (Рис. 9).

Важно! Если указано несколько условий, все они выполняются одновременно — система ищет только те записи, которые соответствуют всем условиям.

Filters_2.png
Рис. 9. Пример применения нескольких условий фильтрации

Чтобы удалить условие, нажмите на иконку image-20250611-122309.png рядом с соответствующим полем.

Альтернативный способ добавить несколько условий — не создавать новые поля вручную через кнопку “Add”, а записать их в одном поле через символ “&”, например:

user=true&label=df

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

3.14. Кнопка "Test"

Кнопка (Рис. 2.(14)) позволяет проверить, возвращает ли запрос результаты, которые будут отображены в форме постобработки.

  • После нажатия кнопки “Test” система отправляет запрос с учетом всех введенных условий.

  • Если условия корректны — результат будет показан в поле “Response” (см. 3.14).

  • Если есть ошибка — результат может не отобразиться.

3.15. Поле "Response"

Поле (Рис. 2.(15)) отображает данные в формате JSON, которые вернулись после нажатия кнопки Test. Чтобы увидеть все содержимое поля — нажмите иконку для разворачивания image-20250611-123039.png или сворачивания image-20250611-123124.png.

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

Каждое новое нажатие на кнопку “Test” обновляет содержимое поля.

Если запрос был корректным — отображаются объекты со значениями (Рис. 10).

image-20250619-140244.png
Рис. 10. Пример вывода значений в формате JSON в поле “Response”

Эти значения затем отображаются в таблице формы постобработки (Рис. 11).

Рис. 11. Вид компонента в форме постобработки в Workspace

3.16. Блок "Action buttons"

Этот блок (Рис. 2.(16)) позволяет создать кнопки в таблице, которые будут размещены в указанных колонках.

Содержит поля:

  • Column name;

  • Action;

  • Button name;

  • Button color;

  • Variable.

Управление кнопками:

  • Add — добавляет кнопку в таблицу;

  • Cancel — отменяет действие.

Добавленные действия отображаются в виде меток под блоком (Рис. 12). Каждую можно отредактировать или удалить image-20250423-142853.png. При редактировании появляется кнопка Save, активная после внесения изменений.

Відображення доданих дій.jpg
Рис. 12. Созданные действия

3.17. Поле "Column name"

Колонка (Рис. 2.(17)), в которой будет отображаться кнопка. Может быть существующей или отдельной.

3.18. Поле "Action"

Название события (выход в схеме) (Рис. 2.(18)), активируемое при нажатии кнопки. Также используется как переменная для сохранения строки.

3.19. Поле "Button name"

Текст на кнопке (Рис. 2.(19)).

3.20. Поле "Color"

Цвет кнопки (Рис. 2.(20)), выбирается из списка (Рис. 13):

image-20250423-142512.png
Рис. 13. Список цветов кнопки

3.21. Переключатель "Break"

Переключатель (Рис. 2.(21)), определяющий, завершится ли выполнение схемы после этого шага.

  • image-20250327-111321.png – инициирует завершение выполнения схемы после этого компонента;

  • image-20250327-111254.png – переключатель выключен.

3.22. Элемент "Add limit"

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

Нажатие кнопки "Add limit" (Рис. 2.(22)) добавляет поле "Max" и кнопку "Delete limit" (Рис. 14). В поле "Max" указывается допустимое количество проходов.

limit.png
Рис. 14. Установка лимита

Если количество проходов превышает значение в поле "Max", используется ветка "failover" (Рис. 15), которая появляется в блоке после установки лимита.

failover.png
Рис. 15. Отображение ветки "Failover" после установки лимита на компонент

Нажатие кнопки "Delete limit" удаляет лимит и возвращает кнопку "Add limit".

3.23. Элемент "Add description"

Нажатие кнопки "Add description" (Рис. 2.(23)) добавляет поле "Description" и кнопку "Delete description" (Рис. 16).

В поле "Description" указывается комментарий к компоненту.

Нажатие кнопки "Delete description" удаляет описание и возвращает кнопку "Add description".

description.png
Рис. 16. Элемент “Add description“

4. Отображение компонента в форме постобработки (Workspace)

В форме элемент "Form Table" отображается как свернутый раздел (Рис. 17).

Рис. 17. Свернутый элемент "Form Table" в форме постобработки

При нажатии на иконку image-20250417-120919.png, компонент разворачивается и показывает таблицу с данными (Рис. 18).

Рис. 18. Развернутый элемент "Form Table" в форме постобработки

4.1. Содержимое таблицы

В таблице отображаются те колонки, которые были заданы в настройках схемы в блоке "Display columns" (см. раздел 3.5). Например, id и name.

4.2. Структура строк

Каждая строка содержит значения, соответствующие выбранным полям JSON-объекта, полученного в результате фильтрации.

4.3. Кнопка действия

Если настроены кнопки (через блок "Action buttons" (см. раздел 3.15)), в каждой строке отображается соответствующая кнопка (например, "CALL" или "CLICK"). Нажатие активирует событие в схеме, связанное с текущей строкой.