Файл¶
Основные настройки
Основные настройки параметра:
| Параметр | Описание |
|---|---|
| Мультифайл | Если настройка активна, то в ДП можно хранить сразу несколько файлов, на карточке задачи они будут отображаться списком. Наименование файлов происходит автоматически — со второго файла к названию добавляется номер его версии. Пример: Первый вложенный файл будет называться name.pdf, второй name-1.pdf, третий — name-2.pdf и т.д., где name — название файла, а .pdf — его расширение. Формирование файла по смарт-выражению работает аналогичным образом. |
| Значение по умолчанию | Файл, которые будет загружаться в ДП по умолчанию. Нажмите кнопку Выбрать файл, выберите нужный файл с диска и нажмите кнопку Обновить. |
| Имя файла | Доступные значения: -Не менять — При записи имя файла будет оставлено без изменений. -Добавить версию — К имени файла будет добавлено пояснение о версии с указанием времени добавления в формате hh:mm. -Фиксированное имя — Имя файла определяется в поле, расположенном ниже. -Смарт-выражение — Имя файла формируется в зависимости от условий и значений других ДП, описанных в смарт-выражении. Вы можете создать новое смарт-выражение или выбрать из уже существующих в системе. Если смарт-выражение для генерации имени возвращает пустой результат или пустую строку, система оставляет исходное имя вкладываемого файла без изменений. |
| Логировать действия с файлами | Если настройка активна, то скачивание, просмотр, редактирование и удаление файла будет записано в системный журнал Диск |
Дополнительные настройки¶
Дополнительные настройки параметра:
| Параметр | Описание |
|---|---|
| Запретить удалять файлы из ДП | Настройка хранится в базе данных, однако в текущей реализации не применяется: ни компоненты ДП на фронтенде, ни серверные методы удаления файлов из ДП её не проверяют. Фактическое управление возможностью удаления файлов из ДП типа "Файл" и "Мультифайл" осуществляется через настройку категории "Удаление файлов" (см. subcategory-files-settings.md). |
| Изображение | Если настройка активна, то пользователи смогут вкладывать только файлы, являющиеся изображениями |
| Разрешить сканирование | Если настройка активна, то пользователи смогут воспользоваться утилитой сканирования, разработанной компанией "Первая Форма" |
| Разрешить загрузку из файловой системы | Если настройка активна, то в ДП можно загружать внешние файлы |
| Разрешить загрузку из файлового хранилища | Если настройка активна, то в ДП можно загружать файлы из Диска |
| Защитить файл от загрузки | Если параметр включен, то файл можно будет открывать только для постраничного просмотра, без возможности загрузить (сохранить) файл или скопировать его содержимое через буфер обмена. При скачивании файлов с помощью действия Скачать все в карточке задачи файл, который загружен в параметр с данной настройкой, не будет включен в архив . Эти ограничения действуют только для пользователей, которые не являются владельцами файла, и только если ДП доступен для них в режиме "Для чтения". Владелец файла (пользователь, который вложил файл в ДП) сможет загружать и просматривать файл как обычно |
| Максимальный размер файла (килобайты) | Параметр задает предельно допустимый размер файла, который может быть вложен в данный ДП |
| Создавать системные копии вложенных файлов при акцепте подписи | Если настройка активна, то при акцепте подписи будет создаваться скрытая версия файла, а в снэпшоте будет указываться ссылка на нее (снэпшот — цифровой снимок задачи, содержащий точную копию содержащихся в ней данных). Эта версия не отображается пользователю в списке версий данного файла, но может использоваться в смарт-автоматизациях |
| Файловый провайдер | Если значение не указано, то при загрузке файла будет использоваться файловый провайдер, указанный по умолчанию. |
ℹ️ В прежних версиях системы утилита сканирования была доступна для загрузки на странице Прочие настройки в пользовательском интерфейсе и в разделе Прочее режима администрирование. В настоящее время ссылка для скачивания больше недоступна в интерфейсе системы, утилита поставляется в виде .zip архива, который вы можете найти в служебной категории Репозиторий версий приложения
Если значение указано, то будет использоваться указанный файловый провайдер. Выбор провайдера может понадобиться для хранения отдельных файлов в несжатом виде.
ℹ️ Выбранный файловый провайдер в настройках ДП учитывается, если значение ДП изменяется вручную, с помощью смарт-действия "Скачать файл" и с использованием LUA-скрипта. Во всех остальных случаях, включая другие смарт-действия, будет использован провайдер по умолчанию.
| Параметр | Описание |
|---|---|
| Список допустимых расширений | Позволяет задавать список расширений файлов, которые будут допустимы для загрузки в ДП. Выберите из списка расширение, которое вы хотите разрешить (например, jpg, pdf, docx) и нажмите кнопку "+" — если расширение корректное и не было внесено ранее, оно будет добавлено в список. Чтобы удалить расширение из списка нажмите на крестик. |
| Тип пропорции | Позволяет выбрать одно из стандартных соотношений сторон для превью изображений в табличном представлении списка задач категории. Доступные значения: По умолчанию, 1:1, 2:1, 3:2, 4:3, 5:4, 16:9, 21:9, 1:2, 2:3, 3:4, 4:5, 9:16, 9:21. Значение учитывается, если в настройках файла активна опция Изображение и выбрано значение ширины колонки в настройках табличного вида категории. |
Файлы Word¶
Работа с файлами Word:
| Параметр | Описание |
|---|---|
| Запретить вкладывать файлы с паролем | (Устаревшее, не используется) Если настройка активна, то в ДП нельзя вкладывать файлы, защищенные паролем. |
| Запретить вкладывать файлы с вложениями | Если настройка активна, то в ДП нельзя вкладывать файлы, содержащие вложенные объекты (Acrobat, Excel и т.п.), т.к. в этом случае невозможно сделать сравнение файлов. При попытке вложить некорректный файл пользователю будет выдано предупреждение. |
| Показывать кнопку для сравнения файлов Word | Если выбран смарт-фильтр, то когда он возвращает "истина", при выполнении перехода (т.е. в процессе согласования документа) для файлов Word, вложенных в этот ДП, отображается кнопка сравнения. |
| Первый файл | Смарт-выражение, возвращающее имя первого файла для сравнения. Чтобы получить ссылку на конкретную версию файла, можно использовать строку вида FileID.VersionID. Если выполняется смарт-фильтр, выбранный в параметре Показывать кнопку сравнения для файлов Word (см. выше), то при клике на файл будут сравниваться первый и второй файлы. Если параметры Первый файл и Второй файл не заполнены, то сравнение выполняется по логике параметра Смарт-фильтр для сравнения с первой версией. |
| Второй файл | Смарт-выражение, возвращающее имя второго файла для сравнения. |
| Смарт-фильтр для сравнения с первой версией | Если выбран смарт-фильтр, то когда он возвращает "истина", при выполнении перехода последняя версия документа сравнивается с самой первой версией, а не с предыдущей. Если смарт-фильтр не указан, то сравнение также идет с первой версией. |
ℹ️ Эта логика используется только если не заполнены параметры Первый файл и Второй файл (см. выше)
Режим объединения¶
Если настройка активна, то будет выполняться объединение первого и второго файлов (как это реализовано в Microsoft Word). Ниже под включенной опцией отображаются поля для выбора смарт-выражений, возвращающих имена объединяемых файлов.
ℹ️ Режим работает только если не включена опция Изображение (см выше)
Настройки ДП¶
Основные настройки ДП:
Настройки ДП Файл в прежнем интерфейсе администрирования Полезные ссылки
Примечание для интеграторов¶
Для публикации стабильных ссылок на файл, загруженный в файловое ДП, можно использовать endpoint:
GET /app/v1.2/api/files/eps/{taskId}/{extParamId}
Ссылка остаётся рабочей при замене файла в этом ДП, так как не зависит от fileId. Подробнее — в curl-examples.md, раздел 2.6.