Настройка класса документов¶
Настройка класса объекта «Документ»¶
В LDM.Box изначально создан один класс документов «ldmbox_doc», используя который можно загружать и работать с файлами. При необходимости для класса документов «ldmbox_doc» можно настроить прикрепление/вложение контента и разрешенные форматы файлов. Остальные параметры класса рекомендуется оставить без изменений.
Важно! Изменение классов документов после начала эксплуатации может нарушить целостность данных.
Настройка классов документов для использования их в прикладном решении осуществляется в сервисе «Модели данных». Для этого необходимо выбрать пункт меню 
в вертикальном меню прикладного решения для перехода в раздел Модели данных, после чего открыть подраздел Документы.
Для настройки класса объекта «Документ» в LDM.Box необходимо выполнить следующие действия:
- В разделе Документы найти класс документов «ldmbox_doc» и открыть его карточку двойным нажатием ЛКМ.
2. В открывшейся форме выполнить при необходимости настройки класса документов:
2.1. Выбрать политику, согласно которой будет размещаться контент создаваемого класса, в поле Политика размещения. Полный список доступных политик открывается при нажатии кнопки 
в конце строки поля и берется из сервиса «Управление файлами».
Если среди списка политик нет нужной, ее можно создать в сервисе «Управление файлами» (процесс создания политики размещения описан в документе Руководство администратора ЛДМ. Управление файлами (ЛДМ. УФ). Если поле Политика размещения оставить пустым, для данного класса будет использоваться политика по умолчанию.
2.2. Указать значение в поле Максимальный размер файла, заполнив его вручную и с помощью кнопок 
, которые появляются при наведении курсора на поле. Значение указывается в Кб.
Если в поле Максимальный размер файла указать значение, LDM.Box будет проверять размер файла при загрузке. Если размер загружаемого файла превысит ограничение, появится уведомление, информирующее о недопустимом размере файла. Если поле Максимальный размер файла оставить пустым, ограничение на размер файлов применяться не будет.
2.3. Для проверки форматов файлов необходимо активировать тумблер Включена проверка форматов файлов в карточке класса и создать конфигурацию с ключом «docshouse.documents.file_formats_check_enable» (п. Настройка ограничений на формат и размер прикрепляемых файлов). Для проверки можно использовать глобальные и локальные ограничения.
Для включения глобальных ограничений необходимо активировать тумблер Использовать глобальные ограничения на форматы файлов, активация которого указывает на то, что данный класс документов будет поддерживать список разрешенных форматов файлов, перечисленных в конфигурации с ключом «docshouse.documents.allowed_file_formats».
Дополнительно можно использовать локальные ограничения, применяемые к текущему классу документов, перечислив форматы файлов в блоке Разрешенные форматы файлов. Для заполнения блока необходимо нажать кнопку 
, в открывшемся окне отметить чекбоксами нужные форматы, после чего подтвердить выбор, нажав кнопку [Подтвердить].
Добавленные форматы появятся в блоке Разрешенные форматы файлов, где их можно исключить, нажав кнопку 
. Для удобства поиска конкретного формата из множества можно воспользоваться строкой поиска в блоке. Чтобы исключить все разрешенные форматы, нужно нажать кнопку 
.
Пример настройки класса документов приведен на рисунке ниже.
Действовать могут локальные и глобальные ограничения как по отдельности, так и вместе. Если тумблер Включена проверка форматов файлов активирован, необходимо выбрать как минимум один формат файлов в блоке Разрешенные форматы файлов или включить глобальные ограничения.
Для работы проверки форматов файлов дополнительно необходимо настроить конфигурации (п. Настройка ограничений на формат и размер прикрепляемых файлов).
3. После заполнения атрибутов нажать кнопку 
.
Появится уведомление, информирующее об успешном сохранении настроек класса документов.
Класс документов включает в себя готовый набор атрибутов «Для папок и документов LDMBox» (код ldmbox_folder_doc_attrs)», его нельзя удалять.
Класс документов «ldmbox_doc» включен в конфигурацию сервиса «dh-documents-service» с ключом «docshouse.datamodel.starter.classes» в сервисе «Управление конфигурациями» для его использования.
Подробнее процесс создания нового класса документов описан в документе Руководство администратора ЛДМ. Управление документами (ЛДМ. УД).
Настройка ограничений на формат и размер прикрепляемых файлов¶
В сервисе «Управление настройками» для документов можно настраивать глобальные и локальные ограничения на форматы файлов. Для настройки глобальных ограничений требуется в сервисе «Управление настройками» создать конфигурацию для сервиса «Управление документами» с ключом «docshouse.documents.allowed_file_formats», где в поле Значение прописать необходимые значения:
{application/msword,doc},
{application/msword,docx},
{application/pdf,pdf},
{application/rtf,rtf},
{application/vnd.ms-excel,xls},
{application/vnd.ms-excel,csv},
{application/vnd.ms-powerpoint,ppt},
{application/vnd.ms-project,mpp},
{application/zip,zip},
{image/jpeg,jpeg},
{image/jpeg,jpg},
{image/svg+xml,svg},
{image/tiff,tif},
{text/plain,txt},
{application/x-7z-compressed,7z},
{image/gif,gif},
{image/png,png},
{application/rar,rar},
{application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,xlsx},
{application/vnd.openxmlformats-officedocument.wordprocessingml.document,docx},
{application/xml,xml},
{application/json,json}
Для локальных ограничений на форматы файлов необходимо создать конфигурацию для сервиса «dh-datamodel-service» с ключом «docshouse.datamodel.file_formats» в сервисе «Управление конфигурациями».
В поле Значение необходимо перечислить форматы файлов, которые можно использовать при настройке класса документов в блоке Разрешенные форматы файлов. Пример значения для такой конфигурации:
{application/pdf,pdf},
{application/vnd.openxmlformats-officedocument.wordprocessingml.document,docx},
{application/vnd.openxmlformats-officedocument.presentationml.presentation,pptx},
{image/jpeg,jpeg},
{image/jpeg,jpg}
Обязательной для проверки форматов файлов является конфигурация с ключом «docshouse.documents.file_formats_check_enable» для сервиса «Управление документами», где в поле Значение необходимо прописать «true» (для включения проверки) или «false» (для отключения проверки).