Закладка "Свойства"

В закладке "Свойства" описываются основные параметры реестра/справочника.

Чтобы настроить свойства:

  1. Убедитесь, что активна закладка "Свойства".

  2. В группе параметров "Основные" заполните поля (Рисунок 1):

    • "Имя": системное имя реестра/справочника. Имя должно начинаться с буквы и содержать только латинские буквы, цифры, символы "-", "_". Не может содержать пробелы. Недоступно для редактирования после сохранения реестра/справочника.

    • "Отображаемое имя": имя реестра/справочника, которое будет отображаться всем пользователям. Отображаемое имя может состоять из букв как латинского алфавита, так и кириллицы, а также пробелов. Рекомендуется использовать человеко-идентифицируемое название. Можно редактировать после сохранения реестра/справочника.

    • "Описание": любая дополнительная информация о реестре/справочнике.

    • "Дополнительные параметры". Перечень параметров (пара "имя" – "значение"), которые содержат дополнительную текстовую информацию. На параметры могут ссылаться кастомные расширения, также параметры могут содержать нестандартную информацию из внешних систем.

  3. В группе параметров "Продвинутые" при необходимости задайте пользовательские границы периодов актуальности. При создании справочника также можно указать, что справочник будет иерархическим.

  4. В группе параметров "Стратегии генерации внешнего ключа" выберите требуемый способ генерации: Не используется, Автогенерация, Объединение или Пользовательская.

  5. Сохраните изменения. Нажмите кнопку Сохранить, расположенную в верхнем правом углу экрана.

  6. Перейдите в закладку "Атрибуты" для добавления и настройки атрибутов.

Свойства реестра/справочника (пример отображения для Enterprise Edition)

Рисунок 1 – Свойства реестра/справочника (пример отображения для Enterprise Edition)

Продвинутые свойства

Параметр "Иерархический"

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

Примечания:

  • Свойство указывается только при создании справочника, и блокируется после сохранения. Опубликованным справочникам нельзя сменить свойство.

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

  • Поиск записей не работает в виде дерева, поэтому при поиске записей будет включаться табличный вид справочника.

  • Если справочник указан как иерархический, то свойство "Границы периодов актуальности" недоступны. Для иерархических справочников границы равны границам, указанным глобально в конфигурации Юниверс 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. При этом внешний ключ может быть сгенерирован одним из следующих способов:

  1. Не используется. Подходит для случаев, когда необходимо загружать данные из сторонних систем вместе с их внешним ключом (External ID).

  • Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы.

  • При импорте через JSON и при интеграциях со сторонними системами: если сторонняя система не передает с записями внешние ключи, то вставка записей завершится ошибкой. Для этих способов обязательно наличие внешних ключей.

  • При импорте из Excel: Если сторонняя система не передает с записями внешние ключи, то при загрузке записей будет создан Origin ID для записей.

  1. Автогенерация (GUID). Внешний ключ генерируется для записей, в которых внешняя система не передает внешний ключ. При генерации используется UUID v4. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы.

  2. Объединение. Внешний ключ генерируется путем соединения заданных в конфигурации атрибутов в единую строку. Генерируется для записей, в которых внешняя система не передает внешний ключ. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы. Доступны следующие типы данных: Строковый, Целочисленный, Ссылка на справочник. Также необходимо заполнить следующие параметры:

    • Показывать названия атрибутов. Необходимо выбрать атрибуты, которые будут объединены в одну строку.

    • Разделитель. Необходимо ввести знак или набор знаков, которые будут разграничивать атрибуты в генерируемой строке.

  3. Пользовательская. Внешний ключ генерируется по алгоритму, заданному пользователем. Внешний ключ генерируется для записей, в которых внешняя система не передает внешний ключ. Если сторонняя система передает с записями внешние ключи, то они будут импортированы из сторонней системы. При использовании необходимо заполнить следующие параметры:

    • Имя пользовательского способа генерации.

    • Библиотека. Выбор .jar-файла библиотеки из списка ранее загруженных.

    • Java класс. Выбор класса, который содержится в файле библиотеки.

Примечание

Пользовательская стратегия генерации доступна только в случае, если система была установлена вручную и была произведена соответствующая кастомизация

Примечания:

  • Максимальная длина внешнего ключа ограничена 512 символами.

  • Внешний ключ не переписывается, если он уже есть в записи или пришел в контексте вставки.

  • Атрибуты, участвующие в генерации внешнего ключа, становятся обязательными. При подготовке импорта в Excel атрибуты также должны быть заполнены. В случае, если хотя бы 1 из атрибутов для импортируемой записи не заполнен, то при попытке генерации внешнего ключа эта запись будет опущена.