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

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

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

  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. Не используется. Генерация не будет производиться. Будут импортированы внешние ключи записей из сторонней системы. Записи с отсутствующим внешним ключом будут отброшены в процессе валидации.

    • В случае если записи импортируются из Excel - генерация внешнего ключа будет производиться в любом случае. Ключи генерируются по тому же алгоритму, как и при создании записей в пользовательском интерфейсе.

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

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

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

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

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

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

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

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

Примечание

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

Примечания:

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

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

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

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

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

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

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

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

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

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

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

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

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