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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • «Описание». Дополнительная текстовая информация об атрибуте.

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

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

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

   • «Базовый». Если параметр включен, то созданный атрибут будет наследоваться типами активов, идущими ниже по иерархическому дереву. Атрибут недоступен для редактирования из наследованных типов активов.

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

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

Чтобы отредактировать атрибут:

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

2. Внесите требуемые изменения. и сохраните их с помощью кнопки «Сохранить» в правом верхнем углу экрана.

Чтобы удалить атрибут:

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

2. Нажмите кнопку «Удалить», которая отобразится в правом конце строки при наведении.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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