ДП «Файл» — справочник настроек¶
Полный перечень настроек ДП типа «Файл»: где хранится каждая настройка, что она делает и какие есть ограничения. Справочник охватывает основные и дополнительные параметры, расширения, файлы по умолчанию, интеграцию с MS Office и провайдеры хранения.
Основные настройки (ExtParamsFileSettings)¶
Хранятся в таблице ExtParamsFileSettings (1:1 с ExtParams через PK = ExtParamID). Настраиваются на вкладке «Основное» карточки ДП.
Основные параметры, именование и логирование¶
Базовые параметры — режим мультифайла и файл-шаблон по умолчанию:
| Настройка | Поле БД | Тип | Описание | Ограничения |
|---|---|---|---|---|
| Мультифайл | IsMultifile |
bit, по умолчанию 0 | 0 = один файл, 1 = несколько файлов | Определяет тип ДП. Изменение после создания задач не рекомендуется |
| Значение по умолчанию | FileId FK → FileStorageFiles |
int NULL | Файл-шаблон, загружаемый при создании задачи | CASCADE DELETE при удалении файла |
Правило, по которому файл переименовывается при загрузке в ДП:
| Настройка | Поле БД | Тип | Описание |
|---|---|---|---|
| Не менять | RenameMethod = 0 |
int, по умолчанию 0 | Имя файла остаётся без изменений |
| Добавить версию | RenameMethod = 1 |
К имени добавляется дата-время: версия dd.MM.yyyy HH-mm |
|
| Фиксированное имя | RenameMethod = 2 |
Имя из поля RenameOnUpload |
|
| Смарт-выражение | RenameMethod = 3 |
Имя вычисляется через SmartRenameOnUpload. Если пустой результат — оставляет исходное |
| Поле | Тип | Описание |
|---|---|---|
RenameOnUpload |
varchar(250) | Фиксированное имя (для RenameMethod=2) |
SmartRenameOnUpload |
int FK → SmartExpressions | смарт-выражение для генерации имени (для RenameMethod=3) |
Для мультифайла: именование автоматическое — со второго файла добавляется суффикс -N к имени.
Запись действий с файлами в журнал Диска:
| Настройка | Поле БД | Тип | Описание |
|---|---|---|---|
| Логировать действия с файлами | IsLogFileReadsAction |
bit, по умолчанию 0 | Скачивание, просмотр, редактирование, удаление записываются в журнал Диск |
Дополнительные настройки¶
Прочие параметры поведения ДП «Файл» — источники загрузки, ограничения, превью изображений, провайдер хранения. Настраиваются на вкладке «Доп. настройки» карточки ДП.
| Настройка | Поле БД | Тип | Описание |
|---|---|---|---|
| Запретить удалять файлы из ДП | PreventDeletingFromHistory |
bit, по умолчанию true при создании ДП | Хранится в БД, но в текущей версии не применяется. Фактическое управление удалением файлов из ДП — через настройку категории AllowDeleteFiles. |
| Изображение | IsImage |
bit, по умолчанию 0 | Только файлы-изображения |
| Разрешить сканирование | AllowScanning |
bit, по умолчанию 1 | Утилита сканирования |
| Разрешить загрузку из файловой системы | ExtParamFileSource (бит 0) |
tinyint, по умолчанию 1 | Загрузка с компьютера пользователя |
| Разрешить загрузку из файлового хранилища | ExtParamFileSource (бит 1) |
tinyint | Загрузка из Диска |
| Защитить файл от загрузки | ProtectFileView |
bit, по умолчанию 0 | Только постраничный просмотр, без скачивания файла и копирования его содержимого. Не действует для владельца файла и при доступе «Для редактирования». Защищённый файл не включается в архив действия «Скачать все» |
| Показывать в форме новой задачи | ShowInNewTaskForm |
bit, по умолчанию 0 | Отображать ДП в НТФ |
| Максимальный размер файла (КБ) | MaxFileSizeKb |
bigint NULL | Ограничение размера |
| Тип пропорции | Proportion |
smallint NULL | Пропорции для превью изображений (1:1, 2:1, 3:2, 4:3, 16:9 и обратные) |
| Создавать системные копии при подписании | CreateSystemFileVersionsOnSignatureSign |
bit, по умолчанию 0 | Скрытая версия файла при акцепте подписи |
| Файловый провайдер | FileProviderId |
int NULL FK → FileProviders (SET NULL) | Конкретный провайдер хранения. Если не указан — провайдер по умолчанию |
Поле ExtParamFileSource хранит разрешённые источники загрузки файла в виде битовой маски:
None = 0 // Нет источников
FileSystem = 1 // Загрузка с компьютера
FileStorage = 2 // Загрузка из файлового хранилища
Оба бита могут быть установлены одновременно.
Список допустимых расширений и файлы по умолчанию¶
Перечень расширений файлов, которые разрешено загружать в ДП, хранится в таблице ExtParamFileAllowedExtensions:
| Столбец | Тип | Описание |
|---|---|---|
| ExtParamID | int FK → ExtParams | ID ДП |
| Extension | varchar(30) | Расширение (pdf, docx, jpg...) |
| ExtParamTableColId | int NULL | ID колонки табличного ДП (для File в таблице) |
Кешируется в ExtParamFileAllowedExtensionsCache.
Таблица ExtParamFileDefaults содержит файлы-шаблоны, подставляемые при создании задачи:
| Столбец | Тип | Описание |
|---|---|---|
| ExtParamId | int FK → ExtParams | |
| FileName | varchar(255) | Имя файла |
| FileContent | varbinary(max) | Контент |
| FileMime | varchar(1024) | MIME-тип |
| FileSize | bigint | Размер |
| FileID | varchar(200) | Ключ в провайдере |
| FileProviderID | int NULL FK → FileProviders |
Настройки MS Office¶
Таблица: MsOfficeInteractionSettings. Привязка: ExtParamsFileSettings.MsOfficeInteractionSettingId. Настраиваются на вкладке «Файлы Word» карточки ДП.
| Настройка | Поле БД | Описание |
|---|---|---|
| Запретить вкладывать файлы с паролем | DisallowProtectedDocx |
Устаревшая настройка |
| Запретить вкладывать файлы с вложениями | DisallowEmbeddingsInDocx |
Запрет вложенных объектов |
| Показывать кнопку для сравнения файлов Word | ShowComparisonExpressionId FK → SmartExpressions |
Смарт-фильтр: когда показывать кнопку сравнения |
| Первый файл | FirstFileExpressionId FK → SmartExpressions |
Смарт-выражение для первого файла сравнения |
| Второй файл | SecondFileExpressionId FK → SmartExpressions |
Смарт-выражение для второго файла |
| Смарт-фильтр для сравнения с первой версией | RedLineCompareTypeExpressionId FK → SmartExpressions |
Сравнение с первой или с предыдущей версией |
| Генерировать документ с правками (redline) | GenerateRedline |
bit, по умолчанию 0 |
| Передавать в SharePoint | TransmitToSharepoint |
bit, по умолчанию 0 |
| Режим объединения | EnableMergeMode |
bit, по умолчанию 0. Объединение первого и второго файлов (MS Word) |
| Первый/Второй файл объединения | FirstFileMergeExpressionId, SecondFileMergeExpressionId |
SmartExpressions |
Режим объединения работает только если не включена опция «Изображение».
Провайдеры хранения файлов¶
Таблица: FileProviders. Типы (FileProviderTypes):
| Значение | Тип | Описание |
|---|---|---|
| 1 | MSSQL | MS SQL varbinary с полнотекстовым поиском |
| 2 | MSSQLNoFulltextSearch | MS SQL без полнотекстового поиска |
| 3 | SharePoint | Интеграция с SharePoint |
| 4 | MSSQLFileStream | MS SQL FileStream |
| 5 | MSSQLWithTextContent | MS SQL с текстовым содержимым |
| 6 | PostgreSQL | PostgreSQL bytea |
| 7 | S3 | S3-совместимое хранилище (MinIO, AWS) |
Выбранный в настройках ДП провайдер учитывается при ручном изменении, смарт-действии «Скачать файл» и Lua-скрипте. В остальных случаях — провайдер по умолчанию.
Вкладка «Настройки ДП»¶
Вкладка «Настройки ДП» карточки ДП «Файл» содержит базовые поля параметра:
- Название — имя параметра, отображаемое на карточках объектов категорий.
- Пример содержимого — текст всплывающей подсказки при наведении на ДП.
- Модуль — модуль, к которому привязан параметр.
- Регулярное выражение — шаблон проверки формата вводимого значения.
- Пояснение к полю — при заданном регулярном выражении: текст предупреждения о несоответствии; иначе — подсказка под полем.
Примечание для интеграторов¶
Для публикации стабильных ссылок на файл, загруженный в файловое ДП, используйте endpoint:
GET /app/v1.2/api/files/eps/{taskId}/{extParamId}
Ссылка остаётся рабочей при замене файла в этом ДП, так как не зависит от fileId. Подробнее — в curl-examples.md, раздел 2.6.