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

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

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

Создать карточку Виртуального файла можно несколькими способами:

Нажать Меню системы → Создать карточку → Справочники → Виртуальный файл.
Открыть представление Администратор → Шаблоны и уведомления → Виртуальные файлы, в правом верхнем углу нажать кнопку + Создать.

После чего откроется новая карточка, в которой необходимо заполнить следующие поля:

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

Note

Для виртуального файла “Лист согласования” по умолчанию выставлено условие Видимость листа согласования, которое проверяет, есть ли в истории заданий карточки какие-либо записи, которые необходимо отобразить в листе согласования.
Сценарий инициализации виртуального файла - сценарий, который вызывается после добавления виртуального файла в загружаемую пользователем карточку. Данный скрипт может использоваться для изменения параметров файла (имя, категория), записи в карточку файла дополнительной информации или для удаления виртуального файла или его версии из карточки.

Созданные карточки виртуальных файлов доступны для редактирования и находятся в рабочем месте Администратор в представлении Шаблоны и уведомления → Виртуальные файлы.

Important

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

Important

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