Список файлов

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

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

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

Отображать основные и дополнительные файлы карточки.

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

Для использования функции сканирования в элемент управления Список файлов требуется добавить элемент "Сканирование".

Работать со списком версий.
Изменять тип добавленного файла (основной, дополнительный) перетаскиванием.
Переименовывать файлы.
Просматривать содержимое файла в окне предварительного просмотра: собственная реализация или с использованием компонента "Предпросмотр файла".
Подписывать файлы ЭП.
Формировать печатную версию со штампом электронной подписи для основных файлов.
Загружать отсоединённую электронную подпись.

Возможность выполнения определённой операции пользователем регулируется ролевой моделью.

Данный ЭУ может быть добавлен только в разметку карточек типа Документ.

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Поведение

Видимость

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

Адаптивный

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

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

Загружать синхронно (шт)

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

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

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

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

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

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

Разрешить дополнительные файлы

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

Сортировка файлов

Свойство позволяет сортировать файлы в списке, доступны несколько способов сортировки по имени или времени добавления:

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

Сортировка пользователем

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

Когда свойство активно (флаг установлен), сортировка разрешена (значение по умолчанию). Когда свойство отключено (флаг снят), сортировка запрещена.

Скрыть кнопку подписи

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

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

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

Текст метки

Заголовок

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

Заполнитель

Текст, отображаемый в элементе управления, когда файлы не добавлены. По умолчанию: Файлы отсутствуют.

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

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

Текст "Добавить дополнительный файл"

Текст отображаемый в ссылке, при нажатии которой вызывается добавление дополнительного файла. По умолчанию: + дополнительный.

Текст "Добавить основной файл"

Текст отображаемый в ссылке, при нажатии которой вызывается добавление основного файла. По умолчанию: + основной.

Текст для дополнительного файла

Текст, отображаемый в блоке добавления дополнительного файла перетаскиванием, и в заголовке списка дополнительных файлов. По умолчанию: Дополнительные файлы.

Текст для основного файла

Текст, отображаемый в блоке добавления основного файла перетаскиванием, и в заголовке списка основных файлов. По умолчанию: Основные файлы.

Свойство Текст "Добавить дополнительный файл", Текст "Добавить основной файл", Текст для дополнительного файла и Текст для основного файла доступны только при включенном свойстве Разрешить дополнительные файлы.

События

Клик по строке

Вызывается по нажатию на строку.

Перед визуализацией файла

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

Перед добавлением дополнительного файла

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

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

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

Перед добавлением основного файла

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

Перед загрузкой версии файла

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

Перед кликом по версии файла

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

Перед кликом по имени файла

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

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

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

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

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

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

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

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

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

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

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

Перед просмотром журнала подписей

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

Перед разворачиванием

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

Перед сворачиванием

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

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

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

Перед созданием цифровой подписи

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

Перед удалением дополнительного файла

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

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

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

Перед удалением основного файла

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

После визуализации файла

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

После добавления дополнительного файла

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

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

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

После добавления основного файла

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

После загрузки версии файла

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

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

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

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

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

После разворачивания

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

После сворачивания

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

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

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

После создания цифровой подписи

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

После удаления дополнительного файла

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

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

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

После удаления основного файла

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

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

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

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

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

При просмотре журнала подписей

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

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

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

При щелчке

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