Закладка "Свойства"¶
В закладке "Свойства" описываются основные параметры реестра/справочника.
Чтобы настроить свойства:
Убедитесь, что активна закладка "Свойства".
В группе параметров "Основные" заполните поля (Рисунок 1):
"Имя": системное имя реестра/справочника. Имя должно начинаться с буквы и содержать только латинские буквы, цифры, символы "-", "_". Не может содержать пробелы. Недоступно для редактирования после сохранения реестра/справочника.
"Отображаемое имя": имя реестра/справочника, которое будет отображаться всем пользователям. Отображаемое имя может состоять из букв как латинского алфавита, так и кириллицы, а также пробелов. Рекомендуется использовать человеко-идентифицируемое название. Можно редактировать после сохранения реестра/справочника.
"Описание": любая дополнительная информация о реестре/справочнике.
"Дополнительные параметры". Перечень параметров (пара "имя" – "значение"), которые содержат дополнительную текстовую информацию. На параметры могут ссылаться кастомные расширения, также параметры могут содержать нестандартную информацию из внешних систем.
В группе параметров "Продвинутые" при необходимости задайте пользовательские границы периодов актуальности. При создании справочника также можно указать, что справочник будет иерархическим.
В группе параметров "Стратегии генерации внешнего ключа" выберите требуемый способ генерации: Не используется, Автогенерация, Объединение или Пользовательская.
Сохраните изменения. Нажмите кнопку Сохранить, расположенную в верхнем правом углу экрана.
Перейдите в закладку "Атрибуты" для добавления и настройки атрибутов.
Рисунок 1 – Свойства реестра/справочника
Продвинутые свойства¶
Параметр "Иерархический"¶
Параметр доступен только для справочников.
Примечания:
Свойство указывается только при создании справочника, и блокируется после сохранения. Опубликованным справочникам нельзя сменить свойство.
Иерархические справочники в разделе "Данные" отображаются в виде дерева и могут переключаться в табличный вид.
Поиск записей не работает в виде дерева, поэтому при поиске записей будет включаться табличный вид справочника.
Если справочник указан как иерархический, то свойство "Границы периодов актуальности" недоступны. Для иерархических справочников границы равны границам, указанным глобально в конфигурации Юниверс MDM.
Для атрибутов записей иерархического справочника работают Правила качества, установка значений в атрибуты записи и из атрибутов справочника. Фильтрация записей и метки безопасности временно недоступны.
Параметр "Границы периодов актуальности"¶
Задание возможных границ актуальности создаваемого объекта.
При включении параметра становятся доступными параметры:
Точность периода актуальности - выбор точности периодов из выпадающего списка:
Дата - формат отображения принимает вид 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 из атрибутов для импортируемой записи не заполнен, то при попытке генерации внешнего ключа эта запись будет опущена.