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

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

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

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

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

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. Для комплексного атрибута необходимого типа актива (в разделе "Управление активами") определите этот атрибут как ключевой.

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

Примечание

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