磁贴
定义和用法
“磁贴”可重用组件是一个小组件,用于以磁贴格式显示名称-值对(也称为属性)。“磁贴”可重用组件的用途是突出显示信息的关键部分,以便用户能够一目了然。属性值显示在磁贴的上半部分,属性名称显示在磁贴的下半部分。如果名称或值太长而无法放在磁贴中,则会被截断,并以省略号表示。磁贴通常在一行中排列。如果一行中的磁贴过多,则磁贴尺寸会相应缩小加以适合。如果一行中的磁贴仍然过多,则磁贴显示会扩展至第二行。
可通过以下方式配置“磁贴”可重用组件:
• 设置要显示的属性的最大数量
• 添加自定义属性
• 定义属性的显示顺序
下面是一个显示“磁贴”可重用组件的示例图像:
“磁贴”可重用组件没有预定义配置。
绑定属性
适用于绑定的“磁贴”组件具有两个属性:
• Input - 此 JSON 需要从后端系统获取数据的输入 ID。此信息以 CCO (公用通信对象) 格式提供。以下是示例:
{
"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"
}
}