Создание класса объекта «Документ»¶
С помощью класса объекта «Документ» можно создавать новые классы документов и задавать им уникальные перечни атрибутов.
Для создания класса объекта «Документ» необходимо выполнить следующие действия:
Поля Наименование, Код класса и Описание заполняются вручную.
Тумблер Защитить от обновления позволяет активировать дополнительную защиту для создаваемого класса объекта «Документ», которая срабатывает при импорте сущностей одного типа. Если среди импортируемых сущностей будет класс документа с таким же идентификатором, что и у текущего, то активный тумблер заблокирует импорт сущности и существующая не будет перезаписана.
В поле Прикрепление/вложение контента может быть выбрано одно из следующих значений:
- «Не разрешено» – при создании документа текущего класса прикрепление файла запрещено;
- «Разрешено» – при создании документа текущего класса прикрепление файла разрешено, но не является обязательным;
- «Обязательно» – при создании документа текущего класса прикрепление файла является обязательным.
Если прикрепление/вложение контента разрешено, то становится доступным для заполнения поле Политика размещения, где нужно выбрать политику, согласно которой будет размещаться контент создаваемого класса. Полный список доступных политик открывается по нажатию кнопки
в конце строки поля.
Поле Максимальный размер файла можно заполнить вручную или с помощью кнопок
, которые появляются при наведении курсора на поле. Значение указывается в Кб.
Если тумблер Включена проверка форматов файлов активирован, ниже станут доступны дополнительные настройки проверки.
Активированный тумблер Использовать глобальные ограничения на форматы файлов указывает на то, что данный класс документа будет поддерживать список разрешенных форматов файлов, определенных по умолчанию в Системе.
При необходимости можно выбрать один или несколько форматов файлов, которые можно прикреплять к документам текущего класса, в блоке Разрешенные форматы файлов. Для заполнения необходимо нажать кнопку !img, в открывшемся окне отметить чекбоксами нужные форматы, после чего подтвердить выбор нажатием кнопки [Подтвердить].
Список доступных форматов файлов берется из конфигурации сервиса «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.datamodel.file_formats» является обязательной для работы проверки прикрепляемых форматов файлов. Помимо нее в сервисе «Управление конфигурациями» необходимо создать настройки «docshouse.documents.allowed_file_formats» и «docshouse.documents.max_file_size» (см. п. Настройки сервиса «Управление документами»).
Тумблер Разрешено создавать экземпляры класса определяет возможность создания экземпляров класса объекта.
Версионность позволяет создавать новые версии одного и того же документа и включается/выключается с помощью переключения тумблера Версионность.
Тумблер Разрешены альтернативные представления позволяет создавать альтернативные представления текущего класса документов. Альтернативные представления предусмотрены только для классов объекта «Документ». При активации тумблера появится список разрешенных форматов, который берется из настройки «ldm.renditions.supportedMimeTypes» для сервиса «Альтернативные представления».
Список можно редактировать отдельно в карточке настройки. Для перехода в карточку настройки можно нажать кнопку
справа от блока. При отсутствии данной настройки ее необходимо создать в сервисе «Управление настройками».
Дополнительно для разрешенных альтернативных представлений предусмотрен максимально допустимый размер в байтах. Данное ограничение определяется настройкой «ldm.renditions.maxFileSize» в сервисе «Управление настройками». Чтобы его изменить, необходимо нажать кнопку
справа от блока. При отсутствии данной настройки ее необходимо создать в сервисе «Управление настройками».
После активации тумблера Композитный документ ниже появится блок настройки вложений для композитных документов.
Здесь необходимо добавить классы документов, доступные для включения в композитные документы. Для этого необходимо на панели инструментов блока нажать кнопку
. В открывшемся окне выбрать один или несколько классов документов и нажать кнопку [Подтвердить].
В списке отображаются только некомпозитные и версионируемые классы документов. Выбранные классы появятся в блоке настройки вложений для композитных документов.
Для каждого выбранного класса документов предусмотрены параметры «Минимальное количество документов» и «Максимальное количество документов», для которых по умолчанию задается значение «Без ограничений». Данные параметры отображаются в колонках «Мин. кол-во документов» и «Макс. кол-во документов». Чтобы изменить параметры, необходимо открыть ранее добавленный класс документа двойным нажатием ЛКМ по строке и в открывшемся окне указать максимальное и/или минимальное количество документов вручную или с помощью переключателей
в конце строки нужного поля
Для сохранения изменений необходимо нажать кнопку [Сохранить] в модальном окне.
В дальнейшем в процессе добавления вложений для композитного документа будет проводиться автоматическая проверка на соответствие указанным ограничениям.
К классу документов количественные ограничения применяться не будут, если поля оставить пустыми.
3. После заполнения атрибутов нажать кнопку
.
Появится уведомление, информирующее об успешном создании нового класса.
Каждый раз после создания классов объекта «Документ» их коды необходимо прописывать в сервисе «Управление настройками» для dh-documents-service в поле Значение с ключом «docshouse.datamodel.starter.classes».
В карточке класса объекта появится новый блок Наборы атрибутов. Для раскрытия блока необходимо нажать ЛКМ на его наименование.
Тумблер Системный определяет тип класса объекта: системный или динамический. Системные классы недоступны для редактирования и удаления.
Тумблер Связан с субъектом персональных данных позволяет привязать к текущему классу объекта системный набор атрибутов субъекта персональных данных. При активации данного тумблера откроется модальное окно, в котором требуется подтвердить добавление связи.
Все события о прочтении документа (по его идентификатору, через атрибутивный поиск и общий список), класс которого связан с субъектом персональных данных, попадают в журнал событий аудита как «ldm.documents.ReadEvent.Success» (см. п. Журнал событий аудита).
Субъекты персональных данных создаются в сервисе массовой обработки персональных данных (см. п. Массовая обработка персональных данных).
После подтверждения действия появится уведомление, информирующее об успешном создании связи .
В блоке Наборы атрибутов появится новый системный набор атрибутов «_ldmPersonalDataSubjectPropertySet». Данный набор атрибутов включает в себя атрибут типа «LINK», его нельзя редактировать и удалять вручную. Чтобы исключить системный набор атрибутов из текущего класса объекта, необходимо деактивировать тумблер Связан с субъектом персональных данных.
Системный набор атрибутов также можно добавить к классу объекта вручную, нажав кнопку
на панели инструментов блока Наборы атрибутов (см. п. Добавление набора атрибутов в класс объекта).










