Добавление пользовательского атрибута в мозаику
В повторно используемом компоненте "Плитка" отображаются атрибуты, для которых в качестве серверной системы используется Windchill. Можно также добавить пользовательские атрибуты, которые должны отображаться в плитке. Это либо атрибуты, для которых не используется Windchill в качестве серверной системы, либо атрибуты, для получения значений которых требуется пользовательская логика.
Чтобы добавить пользовательский атрибут в компонент "Плитка", выполните шаги, приведенные в следующих разделах.
Создание пользовательского атрибута для плитки
1. Создайте новый шаблон вещи в ThingWorx Composer. Задайте для параметра Базовый шаблон вещи значение PTC.TileAttributeModelThingTemplate.
2. На вкладке
Сервисы щелкните значок
в строке
GetCustomAttributes.
3. Добавьте логику для создания одного или нескольких пользовательских атрибутов. ObjectType должен заканчиваться на .Custom. Выходные данные для этого интерфейса API должны иметь формат CCO (Common Communication Object) в формате JSON. Выходные данные должны иметь вид, как в приведенном ниже примере:
{
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": ""
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"version": "1.0.0"
}
4. Сохраните изменения в шаблоне вещи.
5. Создайте новую вещь в ThingWorx Composer. Задайте для Базового шаблона вещи шаблон вещи, созданный ранее. Сохраните вещь.
Добавьте ваш пользовательский атрибут на страницу настройки вкладки Мои задания
Если требуется, чтобы пользовательский атрибут отображался на странице настройки вкладки Мои задания, выполните следующие шаги.
1. Выполните поиск вещи с наименованием PTC.ViewMyTasks.TailoringPage.TilesAttributesThing в ThingWorx Composer. Выберите вещь.
2. На вкладке
Свойства и предупреждения щелкните значок
в строке
modelThing.
3. Введите наименование вещи, которая была создана выше. Сохраните PTC.ViewMyTasks.TailoringPage.TilesAttributesThing.
Теперь пользовательские атрибуты отображаются на странице настройки вкладки Мои задания.
Получение значений для пользовательского атрибута
1. Откройте шаблон вещи, созданный ранее.
2. На вкладке
Сервисы щелкните значок
в строке
GetCustomAttributesValues. Требуются следующие входные данные:
◦ Входные данные - идентификатор входных данных, для которого необходимо вызвать данные.
◦ Конфигурация - атрибуты, выбранные на странице настройки.
◦ Отклик OOTB - отклик для готовых к применению (OOTB) настроенных атрибутов.
3. При необходимости с помощью указанных выше параметров добавьте логику для вызова значений пользовательских атрибутов. Отклик должен быть в формате, аналогичном следующему примеру:
{
"timeStamp": "2019-08-14 15:40:45.175",
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": "5"
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"statusMessage": "OK",
"status": "200"
}
4. Сохраните шаблон вещи.
Добавление пользовательского атрибута в мэшап
1. Создайте мэшап или откройте существующий мэшап.
2. Вставьте компонент "Плитка" в ваш мэшап и щелкните значок
, чтобы сконфигурировать компонент.
3. Измените значение свойства modelThing так, чтобы его значение совпадало с наименованием вещи, созданной ранее.
4. Щелкните Готово и сохраните мэшап.
| Компонент мозаичного отображения поддерживает подключение пользовательских моделей для добавления пользовательских атрибутов при настройке компонента Мои задания. Если при настройке выбрать пользовательский атрибут, а затем изменить модель для настраиваемой вещи для добавления нового пользовательского атрибута, выбранный ранее пользовательский атрибут продолжит отображаться на странице свойств запроса на изменение набора заданий по управлению изменениями. Чтобы выбранный ранее атрибут не отображался на странице свойств, сохраните страницу настройки после обновления настраиваемой вещи. |
