Блок "Скачать файл"
Блок доступен начиная с версии 0.40
Назначение блока
Блок обеспечивает скачивание одного или нескольких файлов с сервера. Поддерживается как отображение блока в виде визуализатора, так и загрузка файлов без визуального представления. Чтобы начать работать с блоком, его необходимо выбрать в библиотеке блоков и переместить в область графа.
Настройки блока
Работа с настройками блока осуществляется через локальное меню блока (пункт Настройки):
Модальное окно настроек выглядит следующим образом:
Общие настройки блока описаны в отдельном разделе.
Раздел "Скачать файл"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Вид отображения визуализатора | Выпадающий список | Да | Выбор режима отображения визуализатора. Возможные режимы: - Ссылки - визуализатор отображается в пресете; - Скрытый - визуализатор отображается только при редактировании пресета |
Входы блока
| Название входа | Тип | Обязательный | Описание |
|---|---|---|---|
| Файлы для скачивания | JSON | Да | JSON-объект, содержащий ссылки на файлы на сервере, подлежащие скачиванию. Файл должен находиться в той же задаче, в какой размещен и сам блок |
Пример входа с файлами для скачивания
Выходы блока
| Название входа | Тип | Обязательный | Описание |
|---|---|---|---|
| Объекты | Объекты | Нет | Массив объектов с информацией о файлах, доступных для скачивания |
События блока
В блоке нет событий.
Описание работы блока
- Блок считывает все ссылки на файлы, которые пришли ему на вход в разделе fileNames.
- Блок проверяет наличие файла на сервере. В случае отсутствия файла система выдаст предупреждение.
- Блок формирует массив объектов с именами файлов (переменная name в атрибутах) и ссылкой на файл (переменная path).
- Блок создает визуализатор всегда, даже если выбран «Скрытый» режим отображения.
Описание работы визуализатора
Визуализатор размещается на пресете в режиме редактирования.
Если визуализатор не разместить, скачивание файлов будет недоступно.
-
На изображении показаны два размещенных визуализатора. У левого выбран режим отображения «Скрытый». Однако в режиме редактирования пресета видны оба блока.:
-
В режиме просмотра пресета видимым остается только один визуализатор. При этом скачивание файлов доступно для обоих:
Скачивание файлов из скрытого визуализатора происходит в момент расчета события, вызвать которое можно, используя Блок "Кнопка".
Для скачивания файла в режиме отображения "Ссылки" необходимо нажать на иконку скачивания, расположенную слева от названия файла:
Настройки визуализатора
Общий список доступен на странице Настройки визуализатора.
Визуализатор позволяет задать дополнительные настройки. Для этого необходимо вызвать контекстное меню визуализатора и в раскрывающемся списке выбрать "Настройки внешнего вида":
Модальное окно настроек выглядит следующим образом:
| Название параметра | Тип параметра | Обязательный | Описание | Пример |
|---|---|---|---|---|
| Размер шрифта текста кнопок | Целое число | Да | Задает размер текста в кнопке | 13 |
| Цвет текста кнопок | Цвет | Да | Задает цвет текста в кнопке | #3C667F |
| Цвет фона кнопок | Цвет | Да | Задает цвет фона в кнопке | transparent |
| Цвет текста активной кнопки | Цвет | Да | Задает цвет текста активной (нажатой) кнопки | #fff |
| Цвет фона активной кнопки | Цвет | Да | Задает цвет фона активной (нажатой) кнопки | rgb(85, 84, 113) |
| Скругление углов кнопок | Целое число | Да | Задает скругление углов кнопки | 0 |
Версия блока
Документация на версию блока
Актуально для версии блока 6
Примеры
http://test.int.bittechno.ru/graph?task=53b91c7b-2a5a-4a56-826c-ee3287fea1c0
Постановки
VISMIND-5978 Блок "Скачать файл"
VISMIND-9173 Кнопки. Унификация настроек и их корректная работ
VISMIND-10992: Управление файлами