Плитка
Определение и использование
Повторно используемый компонент "Плитка" - это виджет, позволяющий отображать пары наименование-значение, также называемые атрибутами, в формате плитки. Повторно используемый компонент "Плитка" предназначен для подсветки ключевых участков информации, чтобы пользователи могли быстро их увидеть. Значение атрибута отображается в верхней половине плитки, а наименование атрибута отображается в нижней половине плитки. Если наименование или значение слишком длинное и не умещается в плитке, оно обрезается и это обозначается многоточием. Все плитки, как правило, расположены в одной строке. Если плиток слишком много для одной строки, каждая плитка сжимается, чтобы все они вписались в размер строки. Если плиток все равно слишком много, чтобы поместить их в одной строке, отображение плиток переносится на вторую строку.
Можно сконфигурировать повторно используемый компонент "Плитка" следующими способами.
• Задание максимального числа отображаемых атрибутов
• Добавление пользовательского атрибута
• Определение порядка отображения атрибутов
На приведенном ниже изображении показан повторно используемый компонент "Плитка".
Для повторно используемого компонента "Плитка" нет доступных предопределенных конфигураций.
Свойства привязки
Существует два свойства компонента "Плитка", доступных для привязки:
• Input - объект JSON, представляющий собой идентификатор входного параметра, для которого необходимо получить данные из серверной системы. Эта информация должна быть указана в формате CCO (Common Communication Object). Ниже приведен пример:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
• TailoringName - строка, представляющая собой имя экземпляра компонента. Оно тесно связано с процессом настройки. TailoringName - используется для получения сохраненной информации о настройке для каждого компонента.
Поля конфигурации
В следующих таблицах показаны поля JSON, которые можно использовать для конфигурирования этого компонента.
Имя свойства | Описание | Тип | Значение по умолчанию | Обязательное или необязательное |
attributes | Наименования свойств, для которых ожидается поступление данных из серверной системы. Эти атрибуты могут либо загружаться из серверной системы, либо могут быть пользовательскими. См. подсвойства: | MultiValueSelector | Н/Д | Обязательное |
id | Идентификатор свойства-наименования атрибута в серверной системе или пользовательское свойство-наименование атрибута. | Строка | Н/Д | Обязательное |
ordinal | Порядок, в котором атрибуты отображаются в компоненте. 0 обозначает самую левую начальную позицию. | Целое число | Н/Д | Необязательное |
objectType | Тип объекта, для которого необходимо получить атрибуты. Этот тип может также быть пользовательским типом. | Строка | Н/Д | Обязательное |
adapter | Исходная конфигурация для серверной системы. См. подсвойства: | JSON | Н/Д | Обязательное |
| instanceName | Экземпляр соединителя, то есть соединитель, который должен использоваться для соединения с серверной системой. | Строка | Н/Д | Обязательное |
thingName | Наименование серверной системы или адаптера, из которого загружаются данные. | Строка | Н/Д | Обязательное |
inTailoring | Показывает, доступен ли компонент "Плитка" для настройки на странице настройки. Опции: true, false. | Логический | false | Необязательное |
maxTileCount | См. подсвойства: | Н/Д | Н/Д | Обязательное |
value | Максимальное число атрибутов, отображаемых в плитке. Если задано как пустая строка, число отображаемых плиток не ограничено. | Целое число | Н/Д | Обязательное; ключ JSON является обязательным, но может быть равен пустой строке. |
version | Версия конфигурации. | Строка | 1.0.0 | Необязательное |
modelThing | См. подсвойства: | Н/Д | Н/Д | Н/Д |
entityName | Наименование вещи модели, получающей эти данные. | Строка | PTC.TileAttrib uteModelThing | Обязательное |
version | Версия конфигурации. | Строка | 1.0.0 | Необязательное |
Примеры конфигураций
Пример формата JSON без пользовательских атрибутов:
{
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "RecurringCost",
"ordinal": 0
},
{
"id": "NonRecurringCost",
"ordinal": 1
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"modelThing": {
"entityName": "PTC.TileAttributeModelThing",
"version": "1.0.0"
},
"maxTileCount": {
"value": 5,
"version": "1.0.0"
}
}
Пример JSON с использованием пользовательских атрибутов:
В приведенном ниже примере имеются два пользовательских атрибута: Attachments и AffectedObjects. Их тип ObjectType имеет значение PTC.ChangeMgmt.ChangeRequest.Custom, чтобы отличать их от стандартных атрибутов.
{
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "RecurringCost",
"ordinal": 0
},
{
"id": "NonRecurringCost",
"ordinal": 1
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
},
{
"items": [
{
"id": "Attachments",
"ordinal": 2
},
{
"id": "AffectedObjects",
"ordinal": 3
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"modelThing": {
"entityName": "PTC.TileAttributeModelThing",
"version": "1.0.0"
},
"maxTileCount": {
"value": 5,
"version": "1.0.0"
}
}
