Компонент "Form Table"
1. Описание
Позволяет отобразить таблицу с внешними данными в форме схемы.
Данный компонент присутствует в схемах типа:
Формы.
Блок (Рис. 1.(1)) размещается в поле для построения схемы. При нажатии на блок открывается панель настроек компонента (Рис. 1.(2)).
2. Блок "Form Table"
Блок "Form Table" (Рис. 1.(1)) состоит из следующих элементов:
Название компонента;
Ветка "In" — входящая (соединяет с предыдущим блоком);
Ветка "Out" — исходящая (соединяет со следующим блоком).
При наведении на поле "Out" появляется переключатель, который позволяет соединить компонент с блоком, уже имеющим соединение.
Наличие иконки означает, что переключатель включен, и компонент можно соединить с другим, уже подключенным блоком.
Изменение положения переключателя удаляет исходящую ветку компонента.
Кнопка удаляет блок из схемы.
3. Панель настроек "Form Table"
Панель настроек компонента "Form Table" (Рис. 2) состоит из следующих элементов:
3.1. Поле "ID"
Уникальный идентификатор компонента в схеме (Рис. 2.(1)).
Значение, выбранное оператором в поле выбора сервиса, будет сохранено в переменной с этим идентификатором. Его можно использовать на следующих этапах схемы.
3.2. Поле “Source”
Текстовое поле ввода (Рис. 2.(2)), в которое можно передать переменную с JSON-объектом. Таблица будет сформирована на его основе.
3.3. Переключатель “Use system sources”
Если включен – — активируется поле 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" для ее удаления.
3.10. Блок “Fields”
Блок (Рис. 2.(10)) позволяет настроить, какие поля из системного объекта нужно отобразить в форме.
3.11. Поле “Field”
Текстовое поле (Рис. 2.(11)), в котором указывается имя одного из нужных полей. Название должно точно соответствовать полю в источнике.
Можно добавить новые поля – или удалить их –
.
3.12. Блок "Filters"
Блок (Рис. 2.(12)) появляется только при включенном переключателе "Use system sources" (см. раздел 3.3). Позволяет задать условия, по которым данные из выбранного источника будут отображаться в таблице.
3.13. Поле "Filter"
Поле “Filter” (Рис. 2.(13)) позволяет вручную задать условие для фильтрации данных из выбранного источника.
Чтобы правильно заполнить это поле:
Перейдите в раздел, где находится нужная вам сущность (например, CRM → Контакты).
Примените нужный фильтр в обычном интерфейсе (Рис. 4).
Откройте инструменты разработчика ("DevTools") и перейдите на вкладку "Network" (Рис. 5).
Найдите запрос добавления фильтров (Рис. 6.(1)) и перейдите на вкладку “Payload” (Рис. 6.(2)).
Скопируйте имя параметра и значение (например, user true) (Рис. 7).
Перейдите к компоненту схемы и впишите значение в поле “Filter” в следующем формате
user=true
Обязательно удалите пробелы и используйте знак "=" между полем и значением (Рис. 8).
Иконка позволяет создать дополнительное поле “Filter” в блоке “Filters”. Это дает возможность задать несколько условий фильтрации (Рис. 9).
Важно! Если указано несколько условий, все они выполняются одновременно — система ищет только те записи, которые соответствуют всем условиям.
Чтобы удалить условие, нажмите на иконку рядом с соответствующим полем.
Альтернативный способ добавить несколько условий — не создавать новые поля вручную через кнопку “Add”, а записать их в одном поле через символ “&”, например:
user=true&label=df
Такая запись также означает, что все условия должны выполняться одновременно.
3.14. Кнопка "Test"
Кнопка (Рис. 2.(14)) позволяет проверить, возвращает ли запрос результаты, которые будут отображены в форме постобработки.
После нажатия кнопки “Test” система отправляет запрос с учетом всех введенных условий.
Если условия корректны — результат будет показан в поле “Response” (см. 3.14).
Если есть ошибка — результат может не отобразиться.
3.15. Поле "Response"
Поле (Рис. 2.(15)) отображает данные в формате JSON, которые вернулись после нажатия кнопки Test. Чтобы увидеть все содержимое поля — нажмите иконку для разворачивания или сворачивания
.
Поле предназначено только для просмотра и не является редактируемым.
Каждое новое нажатие на кнопку “Test” обновляет содержимое поля.
Если запрос был корректным — отображаются объекты со значениями (Рис. 10).
Эти значения затем отображаются в таблице формы постобработки (Рис. 11).
3.16. Блок "Action buttons"
Этот блок (Рис. 2.(16)) позволяет создать кнопки в таблице, которые будут размещены в указанных колонках.
Содержит поля:
Column name;
Action;
Button name;
Button color;
Variable.
Управление кнопками:
Add — добавляет кнопку в таблицу;
Cancel — отменяет действие.
Добавленные действия отображаются в виде меток под блоком (Рис. 12). Каждую можно отредактировать или удалить . При редактировании появляется кнопка Save, активная после внесения изменений.
3.17. Поле "Column name"
Колонка (Рис. 2.(17)), в которой будет отображаться кнопка. Может быть существующей или отдельной.
3.18. Поле "Action"
Название события (выход в схеме) (Рис. 2.(18)), активируемое при нажатии кнопки. Также используется как переменная для сохранения строки.
3.19. Поле "Button name"
Текст на кнопке (Рис. 2.(19)).
3.20. Поле "Color"
Цвет кнопки (Рис. 2.(20)), выбирается из списка (Рис. 13):
3.21. Переключатель "Break"
Переключатель (Рис. 2.(21)), определяющий, завершится ли выполнение схемы после этого шага.
– инициирует завершение выполнения схемы после этого компонента;
– переключатель выключен.
3.22. Элемент "Add limit"
Предназначен для установки максимального количества прохождений через этот компонент.
Нажатие кнопки "Add limit" (Рис. 2.(22)) добавляет поле "Max" и кнопку "Delete limit" (Рис. 14). В поле "Max" указывается допустимое количество проходов.
Если количество проходов превышает значение в поле "Max", используется ветка "failover" (Рис. 15), которая появляется в блоке после установки лимита.
Нажатие кнопки "Delete limit" удаляет лимит и возвращает кнопку "Add limit".
3.23. Элемент "Add description"
Нажатие кнопки "Add description" (Рис. 2.(23)) добавляет поле "Description" и кнопку "Delete description" (Рис. 16).
В поле "Description" указывается комментарий к компоненту.
Нажатие кнопки "Delete description" удаляет описание и возвращает кнопку "Add description".
4. Отображение компонента в форме постобработки (Workspace)
В форме элемент "Form Table" отображается как свернутый раздел (Рис. 17).
При нажатии на иконку , компонент разворачивается и показывает таблицу с данными (Рис. 18).
4.1. Содержимое таблицы
В таблице отображаются те колонки, которые были заданы в настройках схемы в блоке "Display columns" (см. раздел 3.5). Например, id и name.
4.2. Структура строк
Каждая строка содержит значения, соответствующие выбранным полям JSON-объекта, полученного в результате фильтрации.
4.3. Кнопка действия
Если настроены кнопки (через блок "Action buttons" (см. раздел 3.15)), в каждой строке отображается соответствующая кнопка (например, "CALL" или "CLICK"). Нажатие активирует событие в схеме, связанное с текущей строкой.
- 1 1. Описание
- 2 2. Блок "Form Table"
- 3 3. Панель настроек "Form Table"
- 3.1 3.1. Поле "ID"
- 3.2 3.2. Поле “Source”
- 3.3 3.3. Переключатель “Use system sources”
- 3.4 3.4. Поле “System sources”
- 3.5 3.5. Блок "Display columns"
- 3.5.1 3.6. Поле "Display column"
- 3.5.2 3.7. Поле "Display name"
- 3.5.3 3.8. Поле "Width (px)"
- 3.5.4 3.9. Кнопка "Add"
- 3.6 3.10. Блок “Fields”
- 3.6.1 3.11. Поле “Field”
- 3.7 3.12. Блок "Filters"
- 3.7.1 3.13. Поле "Filter"
- 3.8 3.14. Кнопка "Test"
- 3.9 3.15. Поле "Response"
- 3.10 3.16. Блок "Action buttons"
- 3.10.1 3.17. Поле "Column name"
- 3.10.2 3.18. Поле "Action"
- 3.10.3 3.19. Поле "Button name"
- 3.10.4 3.20. Поле "Color"
- 3.11 3.21. Переключатель "Break"
- 3.12 3.22. Элемент "Add limit"
- 3.13 3.23. Элемент "Add description"
- 4 4. Отображение компонента в форме постобработки (Workspace)