Создание опорного справочника

Создание справочника

Чтобы создать справочник:

  1. Откройте раздел "Управление справочниками", если это не сделано ранее.

  2. Убедитесь, что включен режим черновика.

  3. Нажмите кнопку image1 "Создать", расположенную в нижней части списка справочников, и выберите "Справочник".

  4. Во вкладке "Свойства" заполните основные свойства справочника:

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

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

    • Описание. Любая дополнительная информация.

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

    • Способ генерации внешнего ключа. Выбор способа генерации ExternalID для записей справочника.

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

    • Перечень существующих атрибутов может быть отфильтрован для удобства просмотра. Для этого нажмите кнопку image4 "Добавить фильтр" и выберите необходимые признаки или параметры для фильтрации.

  6. После ввода необходимых данных нажмите кнопку image2 "Сохранить" в правом верхнем углу раздела.

  7. Опубликуйте черновик с помощью кнопки image5 "Опубликовать", расположенной в нижней части списка справочников.

Примечание

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

Чтобы копировать справочник:

  1. Убедитесь, что включен режим черновика.

  2. Нажмите кнопку image1 "Создать", расположенную в нижней части списка справочников.

  3. В появившемся над кнопкой меню выберите "Скопировать из..".

  4. В результате действия откроется модальное окно со списком существующих справочников.

  5. Выберите необходимый и нажмите "Продолжить" в правом нижнем углу окна.

  6. Введите имя для нового справочника. При необходимости внесите дополнительные изменения и нажмите image2 "Сохранить" в правом верхнем углу.

  7. Копирование включает в себя все атрибуты (всех типов).

Чтобы удалить справочник:

  1. Выберите необходимый справочник из списка существующих.

  2. Нажмите кнопку image3 "Удалить" в правом верхнем углу экрана.

Способ генерации внешнего ключа

Система Юниверс DG использует уникальный идентификатор записи (внешний ключ) External ID, который используется при импорте записей и других операциях с записями.

Возможно создание внешних ключей в процессе импорта записей при помощи функции генерации External ID. При этом внешний ключ может быть сгенерирован одним из следующих способов:

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Примечания:

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

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

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

  • Параллельно с получением / генерацией External ID загружаемые записи получают Origin ID. Однако, получение Origin ID не связано с получением и генерацией внешних ключей. Существует два сценария с Origin ID:

    • Origin ID при загрузке приходит из системной системы-источника (по умолчанию universe). В этом случае Origin ID не создается, так как он уже есть.

    • Origin ID при загрузке приходит от сторонней системы-источника. В этом случае дополнительно создается Origin ID от имени системной системы-источника для служебных целей.

Группирование справочников

Cправочники могут быть объединены в одну группу по смыслу, значению и т.д. Группы можно переименовывать, перемещать и удалять.

Чтобы создать группу:

  1. Наведите курсор на любую существующую группу. Если групп нет, то наведите курсор на корневой каталог.

  2. Нажмите image1 "Добавить вложенную группу".

  3. Задайте имя группе и нажмите Enter (либо кликните по свободному пространству экрана).

  4. Перетащите справочники в новую группу.

  5. Изменения в структуре сохраняются автоматически.

Чтобы переименовать группу, наведите на нее курсор и кликните по иконке редактирования. Введите текст и нажмите Enter (либо кликните по свободному пространству экрана).

Чтобы удалить группу, наведите на нее курсор и кликните по иконке удаления. Подтвердите действие. После удаления, все вложенные элементы удаленной группы будут перемещены на первый уровень.