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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

Система Юниверс 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. Нажмите "Добавить вложенную группу".

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

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

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

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

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