ДП «Файл» — справочник настроек¶
Полный перечень настроек с указанием где хранится, что делает, ограничения
Основные настройки (ExtParamsFileSettings)¶
Хранятся в таблице ExtParamsFileSettings (1:1 с ExtParams через PK = ExtParamID).
Основные¶
| Настройка (UI) | Поле БД | Тип | Описание | Ограничения |
|---|---|---|---|---|
| Мультифайл | IsMultifile |
bit, default 0 | 0 = один файл, 1 = несколько файлов | Определяет тип ДП. Изменение после создания задач не рекомендуется |
| Значение по умолчанию | FileId FK → FileStorageFiles |
int NULL | Файл-шаблон, загружаемый при создании задачи | CASCADE DELETE при удалении файла |
Имя файла (RenameMethod)¶
| Настройка (UI) | Поле БД | Тип | Описание |
|---|---|---|---|
| Не менять | RenameMethod = 0 |
int, default 0 | Имя файла остаётся без изменений |
| Добавить версию | RenameMethod = 1 |
К имени добавляется дата-время: версия dd.MM.yyyy HH-mm |
|
| Фиксированное имя | RenameMethod = 2 |
Имя из поля RenameOnUpload |
|
| Смарт-выражение | RenameMethod = 3 |
Имя вычисляется через SmartRenameOnUpload. Если пустой результат — оставляет исходное |
| Поле | Тип | Описание |
|---|---|---|
RenameOnUpload |
varchar(250) | Фиксированное имя (для RenameMethod=2) |
SmartRenameOnUpload |
int FK → SmartExpressions | Smart-выражение для генерации имени (для RenameMethod=3) |
Для MultiFile: именование автоматическое — со второго файла добавляется суффикс -N к имени.
Логирование¶
| Настройка (UI) | Поле БД | Тип | Описание |
|---|---|---|---|
| Логировать действия с файлами | IsLogFileReadsAction |
bit, default 0 | Скачивание, просмотр, редактирование, удаление записываются в журнал Диск |
Дополнительные настройки¶
| Настройка (UI) | Поле БД | Тип | Описание |
|---|---|---|---|
| Запретить удалять файлы из ДП | PreventDeletingFromHistory |
bit, default true при создании ДП | Хранится в БД, но не применяется в текущей реализации: не проверяется ни компонентами ДП на фронтенде, ни backend-методами DeleteExtParamFile / DeleteMultifileFromEp. Фактическое управление удалением файлов из ДП — через настройку категории AllowDeleteFiles (AllowDeleteFilesEnum). |
| Изображение | IsImage |
bit, default 0 | Только файлы-изображения |
| Разрешить сканирование | AllowScanning |
bit, default 1 | Утилита сканирования |
| Разрешить загрузку из файловой системы | ExtParamFileSource (бит 0) |
tinyint, default 1 | Загрузка с компьютера пользователя |
| Разрешить загрузку из файлового хранилища | ExtParamFileSource (бит 1) |
tinyint | Загрузка из Диска |
| Защитить файл от загрузки | ProtectFileView |
bit, default 0 | Только постраничный просмотр. Не действует для владельца файла и при доступе «Для редактирования» |
| Показывать в форме новой задачи | ShowInNewTaskForm |
bit, default 0 | Отображать ДП в NTF |
| Максимальный размер файла (КБ) | MaxFileSizeKb |
bigint NULL | Ограничение размера |
| Тип пропорции | Proportion |
smallint NULL | Пропорции для превью изображений (1:1, 2:1, 3:2, 4:3, 16:9 и обратные) |
| Создавать системные копии при подписании | CreateSystemFileVersionsOnSignatureSign |
bit, default 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.
| Настройка (UI) | Поле БД | Описание |
|---|---|---|
| Запретить вкладывать файлы с паролем | DisallowProtectedDocx |
Устаревшее |
| Запретить вкладывать файлы с вложениями | DisallowEmbeddingsInDocx |
Запрет вложенных объектов |
| Показывать кнопку для сравнения файлов Word | ShowComparisonExpressionId FK → SmartExpressions |
Смарт-фильтр: когда показывать кнопку сравнения |
| Первый файл | FirstFileExpressionId FK → SmartExpressions |
Смарт-выражение для первого файла сравнения |
| Второй файл | SecondFileExpressionId FK → SmartExpressions |
Смарт-выражение для второго файла |
| Смарт-фильтр для сравнения с первой версией | RedLineCompareTypeExpressionId FK → SmartExpressions |
Сравнение с первой vs предыдущей версией |
| Генерировать redline | GenerateRedline |
bit, default 0 |
| Передавать в SharePoint | TransmitToSharepoint |
bit, default 0 |
| Режим объединения | EnableMergeMode |
bit, default 0. Объединение первого и второго файлов (MS Word) |
| Первый/Второй файл объединения | FirstFileMergeExpressionId, SecondFileMergeExpressionId |
SmartExpressions |
Режим объединения работает только если не включена опция «Изображение».
Провайдеры хранения файлов¶
Таблица: FileProviders. Типы (FileProviderTypes):
| Значение | Тип | Описание |
|---|---|---|
| 1 | MSSQL | MS SQL varbinary с полнотекстовым поиском |
| 2 | MSSQLNoFulltextSearch | MS SQL без FTS |
| 3 | SharePoint | Интеграция с SharePoint |
| 4 | MSSQLFileStream | MS SQL FileStream |
| 5 | MSSQLWithTextContent | MS SQL с текстовым содержимым |
| 6 | PostgreSQL | PostgreSQL bytea |
| 7 | S3 | S3-совместимое хранилище (MinIO, AWS) |
Выбранный в настройках ДП провайдер учитывается при ручном изменении, смарт-действии «Скачать файл» и LUA-скрипте. В остальных случаях — провайдер по умолчанию.