Закладка "Свойства"
В закладке "Свойства" описываются основные параметры реестра/справочника.
Чтобы настроить свойства:
Убедитесь, что активна закладка "Свойства".
В группе параметров "Основные" заполните поля (Рисунок 1):
"Имя": системное имя реестра/справочника. Имя должно начинаться с буквы и содержать только латинские буквы, цифры, символы "-", "_". Не может содержать пробелы. Недоступно для редактирования после сохранения реестра/справочника.
"Отображаемое имя": имя реестра/справочника, которое будет отображаться всем пользователям. Отображаемое имя может состоять из букв как латинского алфавита, так и кириллицы, а также пробелов. Рекомендуется использовать человеко-идентифицируемое название. Можно редактировать после сохранения реестра/справочника.
"Описание": любая дополнительная информация о реестре/справочнике.
"Дополнительные параметры". Перечень параметров (пара "имя" – "значение"), которые содержат дополнительную текстовую информацию. На параметры могут ссылаться кастомные расширения, также параметры могут содержать нестандартную информацию из внешних систем.
В группе параметров "Продвинутые" при необходимости задайте пользовательские границы периодов актуальности. При создании справочника также можно указать, что справочник будет иерархическим.
В группе параметров "Стратегии генерации внешнего ключа" выберите требуемый способ генерации: Не используется, Автогенерация, Объединение или Пользовательская.
Сохраните изменения. Нажмите кнопку Сохранить, расположенную в верхнем правом углу экрана.
Перейдите в закладку "Атрибуты" для добавления и настройки атрибутов.
Рисунок 1 – Свойства реестра/справочника
Продвинутые свойства
Параметр "Сквозной поиск"
Параметр позволяет включить функционал сквозного поиска для выбранного реестра/справочника и искать данные по записям нескольких реестров/справочников, а также их связям и классификациям.
Параметр "Лимит черновиков записи"
Параметр позволяет задать и контролировать максимально допустимое количество черновиков для одной карточки записи.
Логика работы:
При попытке создать новый черновик система проверяет текущее количество черновиков по записи.
Если количество существующих черновиков достигает установленного лимита, создание нового черновика блокируется.
При ограничении больше, чем один черновик: при создании черновика открывается стандартное модальное окно списка черновиков.
При ограничении равном одному черновику: изменения происходят непосредственно в карточке записи в состоянии черновика, модальное окно списка черновиков не открывается.
При удалении или публикации существующего черновика лимит обновляется и появляется возможность создать новый черновик.
Параметры "Время уведомления/запуска"
Параметры позволяют задать временные интервалы для управления сроками хранения черновиков, не отправленных на согласование. По истечении заданного времени уведомления пользователь получает предупреждение о необходимости запустить процесс согласования, а по истечении времени запуска черновик автоматически удаляется.
Время уведомления: интервал времени до запуска процесса согласования, по истечении которого пользователю отправляется уведомление о необходимости запустить процесс согласования для черновика.
Время запуска: интервал времени до запуска процесса согласования, по истечении которого черновик будет автоматически удален, если не был отправлен на согласование.
Время уведомления (новая запись): аналогично параметру "Время уведомления", но применяется только к черновикам новых записей (записей, созданных непосредственно в черновике).
Время запуска (новая запись): аналогично параметру "Время запуска", но применяется только к черновикам новых записей.
Формат указания времени: данные указываются в формате <x>d <y>h <z>m, где x, y и z - количество дней, часов и минут соответственно. Например, 1d 12h 30m означает 1 день 12 часов 30 минут. Допустимо указывать не все компоненты (например, 2h - 2 часа). В случае некорректной записи будет показана ошибка валидации.
Примечание
Указанные значения используются операциями уведомления и удаления черновиков.
Параметр "Иерархический"
Параметр доступен только для справочников.
Примечания:
Параметр можно изменить, если у справочника отсутствуют записи.
Иерархические справочники в разделе "Данные" отображаются в виде дерева и могут переключаться в табличный вид.
Если справочник указан как иерархический, то свойство "Границы периодов актуальности" недоступны. Для иерархических справочников границы равны границам, указанным глобально в конфигурации Юниверс MDM.
Для атрибутов записей иерархического справочника работают правила качества, установка значений в атрибуты записи и из атрибутов справочника. Фильтрация записей и метки безопасности временно недоступны.
В иерархическом виде справочника доступен поиск по отображаемому имени записей. При вводе текста в строку поиска дерево фильтруется, показывая только записи, удовлетворяющие условию. Найденные совпадения подсвечиваются: если совпадение найдено в имени текущей записи, подсвечивается соответствующий фрагмент текста; если совпадение найдено в дочерних записях (но не в имени текущей), то текущая запись подсвечивается целиком, сигнализируя о наличии совпадений в ее поддереве (Рисунок 2).
Рисунок 2 – Поиск по иерархическим справочникам
Параметр "Отображать периоды актуальности"
Параметр предоставляет возможность через флаг "Отображать периоды актуальности" в настройках модели скрыть все элементы управления периодами актуальности во всех интерфейсах платформы.
Особенности:
При активации параметра система полностью скрывает виджеты и колонки периодов актуальности в UI-компонентах: карточки записи, таблицы поиска, связей, истории записей, клонирования записей, графа связей и сравнения записей.
При включении флага автоматически очищаются настройки границ периода актуальности, а флаг доступен для изменения только при отсутствии данных (hasData = false).
Для иерархических справочников параметр включен по умолчанию (true), так как периоды актуальности для них не поддерживаются.
Если на модели отключены периоды, но в базе уже есть записи с несколькими периодами актуальности, система переходит в специальный режим:
Виджет периодов отображается в режиме только для чтения.
Пользователь может переключаться между существующими периодами для просмотра данных.
Создание, редактирование или удаление периодов становится невозможным.
Связь с атрибутами типа "Ссылка на справочник":
Параметр напрямую влияет на возможность установки значения по умолчанию для атрибутов с типом "Ссылка на справочник". Установить или изменить значение по умолчанию можно только для справочников, у которых флаг "Отображать периоды актуальности" выключен (периоды скрыты). Если у модели справочника периоды актуальности включены, поле "Значение по умолчанию" в атрибуте-ссылке будет недоступно.
Параметр "Границы периодов актуальности"
Задание возможных границ актуальности создаваемого объекта.
При включении параметра становятся доступными параметры:
Точность периода актуальности - выбор точности периодов из выпадающего списка:
Дата - формат отображения принимает вид DD.MM.YYYY, часовой пояс - UTC.
Дата / время - формат принимает вид DD.MM.YYYY hh:mm:ss, и отображается тот часовой пояс, в котором находится пользователь.
Формат хранения периода актуальности на сервере не зависит от точности и всегда - UTC.
Даты начала и конца периода.
Важные условия задания границ:
Указанная точность будет отображаться на всех экранах интерфейса оператора данных, где фигурируют периоды актуальности.
Если параметр включен, но даты начала и конца периода не заданы, то оператору данных в карточке записи будут отображаться границы по умолчанию: 01.01.1900 02:30:17 - 01.01.2501 02:59:59. Значения границ из-за перевода форматов времени учитывают различные факторы, включая смену календаря.
Не допускается изменение границы периода при наличии данных.
Границы связанных объектов должны пересекаться, иначе будет невозможно установить связь между объектами модели данных.
Особенности:
Настройка осуществляется для каждого реестра/справочника отдельно.
Выбор влияет на записи реестра/справочника и на периоды актуальности связи реестра.
Связь между реестрами с разной точностью периодов актуальности корректна.
В окнах выбора связанной записи (ссылки или связи) периоды актуальности отображаются с учетом настройки реестра на правом конце связи/ссылки.
Стратегии генерации внешнего ключа
Система Юниверс MDM использует уникальный идентификатор записи (внешний ключ) External ID, который используется при импорте записей и других операциях с записями.
Возможно создание внешних ключей в процессе импорта записей при помощи функции генерации External ID. При этом внешний ключ может быть сгенерирован одним из следующих способов:
Не используется. Подходит для случаев, когда необходимо загружать данные из сторонних систем вместе с их внешним ключом (External ID).
Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы.
При импорте через JSON и при интеграциях со сторонними системами: если сторонняя система не передает с записями внешние ключи, то вставка записей завершится ошибкой. Для этих способов обязательно наличие внешних ключей.
При импорте из Excel: Если сторонняя система не передает с записями внешние ключи, то при загрузке записей будет создан Origin ID для записей.
Автогенерация (GUID). Внешний ключ генерируется для записей, в которых внешняя система не передает внешний ключ. При генерации используется UUID v4. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы.
Объединение. Внешний ключ генерируется путем соединения заданных в конфигурации атрибутов в единую строку. Генерируется для записей, в которых внешняя система не передает внешний ключ. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы. Доступны следующие типы данных: Строковый, Целочисленный, Ссылка на справочник. Также необходимо заполнить следующие параметры:
Показывать названия атрибутов. Необходимо выбрать атрибуты, которые будут объединены в одну строку.
Разделитель. Необходимо ввести знак или набор знаков, которые будут разграничивать атрибуты в генерируемой строке.
Пользовательская. Внешний ключ генерируется по алгоритму, заданному пользователем. Внешний ключ генерируется для записей, в которых внешняя система не передает внешний ключ. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы. При использовании необходимо заполнить следующие параметры:
Имя пользовательского способа генерации.
Библиотека. Выбор .jar-файла библиотеки из списка ранее загруженных.
Java класс. Выбор класса, который содержится в файле библиотеки.
Примечание
Пользовательская стратегия генерации доступна только в случае, если система была установлена вручную и была произведена соответствующая кастомизация
Примечания:
Максимальная длина внешнего ключа ограничена 512 символами.
Внешний ключ не переписывается, если он уже есть в записи или пришел в контексте вставки.
Атрибуты, участвующие в генерации внешнего ключа, становятся обязательными. При подготовке импорта в Excel атрибуты также должны быть заполнены. В случае, если хотя бы 1 из атрибутов для импортируемой записи не заполнен, то при попытке генерации внешнего ключа эта запись будет опущена.
Для атрибутов типа Дата используется фиксированный формат yyyy-mm-dd. Другие форматы даты не поддерживаются при генерации внешнего ключа.