Файловое хранилище

Назначение

Сервис обеспечивает прикрепление, хранение и использование файлов в объектах системы. Включает хранение файлов и вложений , предпросмотр вложений и правила очистки файлов .

Цели и задачи

• Прикреплять файлы к документам через выбор файла, перетаскивание, ссылку или камеру.
• Хранить файлы с привязкой к документу (attached_to_doctype, attached_to_name); доступ по правам на документ.
• Просматривать вложения без скачивания для поддерживаемых форматов.
• Управлять лимитами (размер, количество вложений) и при необходимости очисткой служебных данных .
• Массово импортировать/экспортировать вложения (Zip) через File Manager.

Для кого

• Все пользователи, прикрепляющие и открывающие файлы.
• Администраторы, настраивающие лимиты и политики хранения.
• Пользователи инструмента File Manager (Tools > Files).

Основные понятия

• File — объект хранения файла в Dinext; связь с документом или папкой.
• File Manager — интерфейс управления файлами: Home > Tools > Files; прикрепление, Zip import/export, обрезка и оптимизация изображений.
• Max Attachments — лимит вложений на документ (Customize Form > тип документа > Max Attachments).
• max_file_size — лимит размера файла в конфигурации сайта (по умолчанию 10 MB).
• Dinext — приложение предпросмотра без скачивания.

Основные сущности / объекты

• File — хранение файлов и вложений.
• Dinext — предпросмотр вложений (README).
• Dinext — правила очистки файлов и служебных данных (README).

Основные сценарии / процессы

Прикрепление файла к документу

1. Открыть документ; нажать «Прикрепить» или перетащить файл в область вложений.
2. Выбрать файл с устройства, ранее загруженный файл, веб-ссылку или снимок с камеры (при поддержке).
3. Файл сохраняется как File и привязывается к документу; доступ к нему имеют пользователи с правом чтения документа.
4. Для изображений доступны обрезка и оптимизация (качество 85%, макс. 1920x1080 при настройке).

Просмотр без скачивания

1. При установленном Dinext открыть вложение кликом.
2. Поддерживаемые форматы (PDF, изображения, офисные и т.д.) отображаются в браузере; остальные — скачиваются.

Управление и лимиты

1. File Manager: массовый импорт/экспорт Zip, просмотр прикрепленных файлов.
2. Увеличить лимит вложений на тип документа: Customize Form > выбрать тип документа > Max Attachments.
3. Увеличить лимит размера файла: site config max_file_size (осторожно с нагрузкой и диском).
4. Правила очистки и сроки хранения служебных файлов — в Dinext по документации.

Правила и ограничения

• Чтение вложения разрешено при наличии права Read на документ, к которому оно прикреплено.
• Размер файла ограничен max_file_size; количество вложений на документ — Max Attachments.
• Физическое хранение — в папках сайта (private/files, public/files); резервное копирование должно включать эти каталоги.

Результаты / отчетность

• Список вложений по документу.
• File Manager для обзора и массовых операций с файлами.
• Аудит доступа при ведении логов (если включено).

Типовые вопросы и ошибки (FAQ)

Ошибка при загрузке большого файла

Проверьте лимит max_file_size в конфигурации сайта и лимиты веб-сервера (client_max_body_size в nginx и т.п.). Увеличивайте в разумных пределах с учетом диска и нагрузки.

Как разрешить больше вложений на один документ?

Customize Form > выбрать тип документа > поле Max Attachments — увеличить значение. Не устанавливайте слишком большое число без необходимости (влияет на производительность списка вложений).

Где настраивается очистка старых файлов?

В приложении Dinext документированы правила очистки файлов и служебных данных; настройка может быть в конфигурации или в скриптах приложения.

Связанные темы

• Диск и документы
• Роли и полномочия
• Логи и журналы