Создание комплексного атрибута

Комплексный атрибут представляет собой объект модели данных, который способен содержать в себе другие атрибуты различного типа.

Для создания комплексного атрибута требуется наличие вложенного объекта.

Примечание

Создание комплексного атрибута доступно только для реестра

Создание атрибута

Чтобы создать комплексный атрибут:

1. Убедитесь, что создан минимум 1 вложенный объект.

2. Убедитесь, что активна закладка "Атрибуты".

3. Нажмите кнопку Добавить атрибут, расположенную в списке атрибутов текущего реестра.

4. В открывшемся списке выберите пункт "Комплексный атрибут".

5. Заполните обязательные поля атрибута:

   • "Имя": уникальное системное имя атрибута. Уникальность проверяется на одном уровне вложенности. Таким образом, если простой атрибут используется в составе комплексного, то в другом комплексном атрибуте может быть использовано это же имя. После сохранения имя нельзя будет изменить.

   • "Отображаемое имя": имя атрибута, которое будет отображаться в интерфейсе системы.

   • "Вложенный объект": выберите требуемый вложенный объект из списка ранее созданных. В результате действия в комплексный атрибут будут добавлены атрибуты выбранного вложенного объекта. Если вложенный объект содержит собственные комплексные атрибуты, то в структуре атрибутов реестра будет вложенность 2 уровня и глубже. При необходимости, нажмите кнопку Перейти в [имя выбранного объекта] чтобы перейти на экран вложенного объекта.

6. Настройте свойства атрибута:

   • "Описание": текст, который выводится оператору данных при наведении курсора мыши на атрибут.

   • Параметр "Скрытый". Если установлено значение "да", то атрибут не отображается в общем представлении записи.

   • "Мин" и "Макс". Минимальное и максимальное количество вложенных атрибутов в соответствующих полях.

   • "Ключевой атрибут". Выбор строкового/целочисленного атрибута вложенного объекта в качестве ключевого. См. подробнее ниже.

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

7. При необходимости сохраните изменения. Нажмите кнопку Сохранить, расположенную в верхнем правом углу экрана. Если при сохранении будут обнаружены ошибки заполнения, то на экране отобразится соответствующее сообщение. Будут сохранены все изменения в реестре.

Использование ключевого атрибута

Ключевой атрибут - атрибут, значение которого проверяется на уникальность между экземплярами комплексного атрибута внутри записи. Не является обязательным, может быть редактируемым.

В качестве ключевого атрибута может быть выбран простой строковый или целочисленный атрибут.

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

В xml структуре данных в файле model.xml назначение автогенерации на простой строковый атрибут вложенного объекта задается в свойстве valueGenerationStrategy; назначение атрибута ключевым в комплексном атрибуте реестра задается в свойстве complexAttribute - признак nestedEntityKeyAttribute.

Вариант 1. Использование для идентификатора экземпляра комплексного атрибута в записи

1. Создайте вложенный объект.

2. Для вложенного объекта создайте простой строковый атрибут, установите флаг "Только для чтения" и выберите стратегию "Автогенерация (GUID)".

3. Для комплексного атрибута необходимого реестра (в разделе "Модель данных") определите этот атрибут как ключевой.

Таким образом при создании записи с экземплярами комплексного атрибута, при сохранении черновика или публикации без черновика, значения атрибута будут сгенерированы автоматически (Рисунок 1). Значения атрибута не будут изменяться, поскольку атрибут имеет свойство только для чтения.

Вариант 2. Связывание экземпляров комплексного атрибута с объектами пользователя при интеграции

1. Создайте вложенный объект.

2. Для вложенного объекта создайте простой строковый или целочисленный атрибут. В поле "Выбрать стратегию" оставьте вариант "Не используется".

   • Важно: атрибут должен быть редактируемым.

3. Для комплексного атрибута необходимого реестра (в разделе "Модель данных") определите этот атрибут как ключевой.

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

Примечание

Нарушение уникальности ключа внутри записи (уникальность внутри всех записей реестра не проверяется) вызывает ошибку при публикации, которая отобразится в интерфейсе пользователя

Рисунок 1 – Автоматически сгенерированные значения атрибута uuid