Атрибуты ¶

Каждый тип документов имеет список метаданных, называемых атрибутами.

Перечень атрибутов может отличаться в зависимости от типа документа и настраивается один раз из панели администратора. Таким образом обеспечиватся переменная атрибутивность.

Параметры атрибута ¶

Параметры для каждого атрибута настраиваются индивидуально. Существуют следующие параметры:

• Название - краткое имя атрибута. Будет отображаться в основном интерфейсе
• Описание - расширенное описание атрибута. Отображается только в разделе для администратора
• Обязательный - определяет, будет ли атрибут обязательным для заполнения или его значение будет уникальным
• Значение по умолчанию - будет прописываться автоматически при создании нового документа
• Источник данных - откуда брать возможные значения. Значение по умолчанию - "атрибут". Параметры каждого источника (кроме "атрибут") настраиваются отдельно
• Тип - влияет не только на отображение, но и на способ обработки значения. Значение по умолчанию - "строка". Для каждого источника данных есть свой перечень возможных типов
• Тип отображения - позволяет изменить стандартное отображение атрибута. Для каждого типа атрибута и источника данных есть свой перечень возможных типов отображения
• Валидатор - для некоторых типов атрибутов есть возможность выбрать способ валидации вводимого значения
• Значение валидатора - если выбран валидатор, дополнительный параметр

Общие атрибуты ¶

Кроме индивидуального настраиваемого перечня атрибутов у каждого типа документов имеется набор общих атрибутов.

Общие атрибуты невозможно настраивать или удалять.

Они автоматически создаются при добавлении нового типа документов.

Каждый тип документов имеет следующие общие атрибуты:

• Название - название документа. Обязательный для заполнения атрибут
• Дата создания - автоматически прописывается после создания нового документа. Этот атрибут запрещено редактировать вручную
• Дата удаления - проставляется автоматически после удаления документа. Если документ был восстановлен, то прописывается пустое значение. Этот атрибут запрещено редактировать вручную
• Уровень безопасности - если в системе существуют дополнительные уровни безопасности, документ можно отнести к данному уровню
• Семейство безопасности - если в системе созданы дополнительные семейства безопасности, документ можно отнести к данному семейству
• Папка - в этом атрибуте записывается принадлежность документа к единому информационному дереву. Узлов может быть несколько. Пути к узлам перечисляются через разделитель ;. Этот атрибут запрещено редактировать вручную и он не отображается в списке атрибутов в карточке документа
• Автор - пользователь, который создавал документ. Этот атрибут запрещено редактировать вручную

Также, если при создании типа документов было заполнено поле "Папка", то автоматически создаётся атрибут "Файл" типа "файл".

Обязательность и уникальность ¶

Для атрибута можно указать обязательность заполнения значения.

Могут быть следующие опции:

• (по умолчанию) нет - атрибут можно не заполнять
• обязательный - значение атрибута не может быть пустым. Документ не сохранится, если атрибут не заполнен. Невозможно очистить значение атрибута у существующего документа
• уникальный - значение атрибута не может быть пустым и не может совпадать со значением атрибута другого документа данного типа. Сравнение ведётся с учётом регистра символов

Документ не будет сохранён пока не будут заполнены все обязательные и уникальные атрибуты. Документ не будет сохранён, если будет существовать документ, у которого значения уникальных атрибутов будут совпадать с введёнными.

Источники данных ¶

Значения атрибутов могут как вводиться вручную, так и выбираться из внешнего списка значений другого источника данных. Источник данных может влиять на перечень возможных типов атрибута и на возможные типы отображения атрибута.

Системой поддерживаются следующие источники данных для атрибута:

• (по умолчанию) атрибут - значение заполняется вручную пользователем
• словарь - внешний список возможных значений. По умолчанию атрибут из текстового поля трансформируется в выпадающий список. Существует возможность поменять тип отображения на поле с автозаполнением или список радиокнопок. В отдельном разделе для администратора можно настроить список возможных значений для словаря

Типы атрибутов ¶

В зависимости от источника данных меняется и список возможных типов атрибута.

Тип атрибута влияет на обработку значения атрибута системой. Также у каждого типа есть свой тип отображения по умолчанию. Иногда тип отображения можно изменить. Например, атрибут типа "дата" будет отображаться как поле с выпадающим календарём, а при сортировке по дате будет автоматически преобразовываться формат в тот, который более удобен для базы данных.

Существуют следующие типы атрибута:

• (по умолчанию) строка - простое однострочное текстовое поле
• число - помечает атрибут как числовой, влияет на сортировку документов по данному атрибуту и на отображение фильтров. Значение проверяется на числовое и автоматически активируется соответствующий валидатор
• автоинкремент - автоматически увеличивающееся на единицу число. Работает только для числовых значений. При создании документа вычисляет максимальное значение данного атрибута и автоматически заполняет соответствующее поле.
• логический - "да" либо "нет". Значение записывается как число - 1 или 0.
• дата - отображается календарь при изменении значения и при фильтрации, а также влияет на сортировку
• файл - в значение данного атрибута будет записана ссылка на файл, при добавлении документа появится возможность прикрепить файл и в карточке документа можно будет сменить файл; в списке документов атрибут будет выглядеть как ссылка. Загружаемые файлы будут складываться в папку, установленную при создании типа документов. У одного типа документов может существовать неограниченное количество атрибутов типа "файл"

Типы отображения ¶

Позволяют по-разному отображать атрибут.

Каждый тип атрибута имеет тип отображения по умолчанию, который иногда можно изменить.

Для атрибута типа "строка" существуют следующие типы отображения:

• автозаполнение - включает автоматическое заполнение, используются значения данного атрибута от других документов, сохранённых в системе
• текст - текстовое поле становиться многострочным
• ссылка - в карточке документа появится кнопка перехода по ссылке. Автоматически активирует валидатор для ссылок, то есть документ невозможно будет сохранить, если введена неправильная ссылка
• email - email-ссылка для адресов электронной почты. Автоматически активирует валидатор для email, то есть документ невозможно будет сохранить, если введён некорректный адрес электронной почты

Для атрибутов других типов список может быть другой или отсутствовать вовсе.

Валидаторы ¶

Валидаторы позволяют указать условие фильтрации для значения атрибута.

Некоторые типы атрибута и типы отображения атрибута имеют собственный валидатор.

Иногда его можно дополнить, выбрав опцию для параметра "Валидатор". Кроме выбора параметра "Валидатор" необходимо дополнительно заполнить параметр "Значение валидатора", иначе валидатор не будет действовать.

Для атрибута типа "число" существуют следующие дополнительные валидаторы:

• регулярное выражение - документ не будет сохранён, если значение атрибута не будет проходить по условию фильтрации по регулярному выражению
• сопоставление - например "<10", более упрощённый вариант регулярного выражения для сравнения значений

Для атрибутов других типов список может быть другой или отсутствовать вовсе.