Файл

Элемент управления Файл предназначен для работы с файлами карточек любых типов.

Пример элемента управления "Файл"
Рисунок 1. Пример элемента управления "Файл"

Данный элемент управления позволяет:

  • Добавлять/удалять/скачивать файлы.

  • Работать со списком версий.

  • Комментировать версии.

  • Просматривать содержимое файла в окне предварительного просмотра.

  • Просматривать содержимое .zip-архивов: видеть виды файлов и их количество, просмотр файлов в архиве недоступен.

  • Редактировать файл с использованием WebDAV (должно поддерживаться IIS).

Работа с файлом осуществляется с помощью команд контекстного меню (открывается при щелчке по названию файла).

При щелчке по номеру версии (в. 1 на рисунке выше) будет открыт список версий файла с комментариями.

Версии файла
Рисунок 2. Версии файла с комментариями

Из данного окна можно скачать любую версию файла или открыть её в режиме предварительного просмотра.

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Внешний вид

Заполнитель

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

Локализуемый

Заполнитель при перетаскивании

Текст, отображаемый в элементе управления, когда файл перетаскивается с файловой системы в область ЭУ.

Локализуемый

Отображать метку без значения

Регулирует отображение метки, когда файл не загружен.

Подсказка

Содержимое всплывающей подсказки.

Локализуемый

Сообщение при пустом значении

Сообщение, выводимое при попытке сохранить пустое значение в поле выбора файла.

Локализуемый

Текст метки

Содержимое метки, отображаемой около элемента управления. При размещении элемента управления в Таблице метка будет скрыта.

Локализуемый

Данные

Расширенный источник данных

Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.

Источник данных

Секция карточки, содержащая данные элемента управления.

Файл может быть связан с плоской или табличной секцией (для добавления нескольких файлов). При связывании с табличной секцией Файл будет отображать данные из первой строки секции, если элемент управления Файл размещается не в ЭУ Таблица (см. Настройка элемента управления для работы с несколькими файлами).

Поле данных

Ссылочное поле, указывающее на карточку версионного файла.

Операция на скачивание

Операция редактирования, при доступности которой пользователю будет разрешено скачивать файл. Если операция не выбрана, возможность скачивания файла не ограничена.

Операция на чтение

Операция редактирования, при доступности которой пользователю будет разрешено открывать файл и использовать предварительный просмотр. Если операция не выбрана, возможность просмотра файла не ограничена.

Операция редактирования

Выбор операции редактирования значения элемента управления. Если операция недоступна пользователю, изменение значения элемента управления также недоступно. Если операция не выбрана, возможность редактирования значения элемента управления не проверяется.

Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).

Поведение

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Включить версионинг

Включает или отключает возможности версионирования, предоставляемые элементом управление: просмотр, добавление и комментирование версий.

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Доступные расширения

Список разрешённых для загрузки расширений.

Обязательное

Определяет требование к заполнению значения ЭУ до сохранения карточки:

  • Когда флаг установлен, значение ЭУ должно быть присвоено, иначе карточка не будет сохранена. При этом ЭУ помечается предупреждающим сообщением.

  • Когда флаг не установлен, присваивать значение необязательно.

Операция редактирования для видимости

Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость:

  • Когда флаг Видимость установлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования.

  • Когда флаг Видимость установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда.

  • Когда флаг Видимость НЕ установлен, ЭУ всегда скрыт.

Отключен

Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством `Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.

Адаптивный

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

Показывать контекстное меню

Регулирует отображение контекстного меню.

Режим редактирования

Определяет возможности настройки элемента управления и список операций в контекстном меню ЭУ. Возможные варианты:

  • По месту. Доступные операции: "Открыть", "Предварительный просмотр", "Комментировать", "Добавить версию", "Заменить", "Скачать", "Удалить".

  • Редактирование. Доступные операции: аналогично режиму По месту.

  • Без редактирования. Доступные операции: "Открыть", "Предварительный просмотр", "Комментировать", "Скачать".

    Отдельные пункты меню могут быть недоступны, если соответствующая операция редактирования недоступна и/или отключен версионирования.
    Особенность поведения: в режиме редактирования По месту элемент управления предоставляет возможность управлять версиями файла. В том числе при создании новой карточки.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

События

Перед добавлением комментария к версии файла

Вызывается перед добавлением комментария к версии файла.

Перед закрытием диалога комментариев

Вызывается перед закрытием диалогового окна ввода комментария к версии файла.

Перед закрытием диалога просмотра версий

Вызывается перед закрытием диалогового окна со списком версий файла.

Перед открытием диалога комментариев

Вызывается перед открытием диалогового окна ввода комментария к версии файла.

Перед открытием диалога просмотра версий

Вызывается перед открытием диалогового окна со списком версий файла.

Перед открытием предпросмотра

Вызывается перед открытием предварительного просмотра файла.

Перед открытием файла

Вызывается перед открытием файла.

Перед скачиванием файла

Вызывается перед скачиванием файла.

Перед удалением комментария к версии файла

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

После добавления комментария к версии файла

Вызывается после добавления комментария к версии файла.

После загрузки информации о версиях файла

Вызывается после загрузки информации о версиях файла в элемент управления (в окне списка версий).

После закрытия диалога комментариев

Вызывается после закрытия диалогового окна ввода комментария к версии файла.

После закрытия диалога просмотра версий

Вызывается после закрытия диалогового окна со списком версий файла.

После открытия диалога комментариев

Вызывается после открытия диалогового окна ввода комментария к версии файла.

После открытия диалога просмотра версий

Вызывается после открытия диалогового окна со списком версий файла.

После открытия предпросмотра

Вызывается после открытия предварительного просмотра файла.

При сохранении файла в WebDAV

Вызывается при сохранении файла с использованием WebDAV.

После открытия файла

Вызывается после открытия файла.

После скачивания файла

Вызывается после скачивания файла.

После смены данных

Вызывается после любого изменения (выбора, загрузки, удаления) данных элемента управления.

После удаления комментария к версии файла

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

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

Вызывается, когда курсор мыши покидает область элемента управления.

При сохранении файла в WebDAV

Вызывается при сохранении файла в WebDAV.

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.

Файл выбран

Вызывается после выбора файла с помощью элемента управления или добавления файла перетаскиванием.

Файл загружен

Вызывается при успешном сохранении файла на сервере.

Файл удалён

Вызывается после очищения значения элемента управления.

См. также: Настройка элемента управления для работы с несколькими файлами.