Виртуальные файлы¶

В системе есть возможность создать карточки виртуальных файлов, по настройкам которых система добавляет виртуальные файлы при открытии карточек документов. Сами файлы генерируются на основе шаблонов файлов, указанных в настройках виртуальных файлов (см. раздел Шаблоны файлов) и, соответственно, поддерживаются все те же форматы файлов, что и для шаблонов файлов: html, txt, docx, xlsx.

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

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

Карточка виртуального файла содержит следующие настройки:

Название - уникальное название виртуального файла.
Шаблон файла - шаблон файла, на основе которого генерируется текущая версия виртуального файла.
Имя файла (пусто - определяется из шаблона) - имя файла, который будет добавлен в карточку как виртуальный файл. Имя файла пишется без расширения, расширение файла определяется на основе файла из шаблона файла.
Категория файла - категория файла, с которой будет добавлен виртуальный файл. Если не задано, то файл добавляется без категории.
ID виртуального файла - идентификатор виртуального файла, добавляемого в карточку. Генерируется системой.
ID версии виртуального файла - идентификатор текущей версии виртуального файла. Генерируется системой.
Дополнительные версии - таблица, содержащая настройки дополнительных версий виртуального файла.
Каждая строка имеет следующие настройки:
- Шаблон файла - шаблон файла, на основе которого генерируется дополнительная версия виртуального файла.
- Имя файла (пусто - определяется из шаблона) - имя дополнительной версии файла. Имя файла пишется без расширения, расширение файла определяется на основе файла из шаблона файла.
- ID версии виртуального файла - идентификатор дополнительной версии виртуального файла. Генерируется системой.
Типы - список типов карточек, для которых используется данный виртуальный файл.
Состояния карточек - список состояний, на которых данный виртуальный файл доступен.
Роли - список ролей, для которых доступен данный виртуальный файл. Не поддерживает контекстные роли.
Список условий - таблица с условиями, которые определяют доступность к виртуальному файлу. Более подробно о таблице с условиями смотрите в разделе Заполнение таблицы с условиями.
Сценарий инициализации виртуального файла - сценарий, который вызывается после добавления виртуального файла в загружаемую пользователем карточку. Данный скрипт может использоваться для изменения параметров файла (имя, категория), записи в карточку файла дополнительной информации или для удаления виртуального файла или его версии из карточки.

Виртуальные файлы добавляются в карточку при ее загрузке. Контент виртуального файла или его версий генерируется непосредственно при загрузке файла/версии файла.