圖標
定義與用法
圖標可重複使用的元件是一個小器具,可讓您以圖標格式顯示名稱值對,也稱為屬性。圖標可重複使用的元件目的是為了反白資訊的關鍵片段,讓使用者能夠一目了然地看到它們。屬性值會顯示在圖標的上半部,屬性名稱會顯示在圖標的下半部。如果名稱或值太長而不符合圖標大小,則會被截斷,以省略號表示。圖標通常會以單一列排列。如果要在單一列中容納太多的圖標,則會縮小圖標大小,使其符合。如果仍有過多的圖標要符合單一列,則會將圖示顯示在第二列上。
您可以透過下列方式配置圖標可重複使用的元件:
• 設定要顯示的最大屬性數
• 新增自訂屬性
• 定義屬性的顯示順序
以下是顯示圖標可重複使用元件的範例圖像:
圖標可重複使用的元件沒有預先定義的組態。
繫結內容
可用於繫結的圖標元件有兩個內容:
• Input - 是需要從後端系統獲取數據之輸入 ID 的 JSON。此資訊以 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 | N/A | 必要 |
id | 後端系統中屬性的內容名稱識別元,或屬性的自訂内容名稱。 | String | N/A | 必要 |
ordinal | 屬性在元件中顯示的順序。0 表示初始最左側的位置。 | Integer | N/A | 選用 |
objectType | 要擷取其屬性的物件類型。此類型也可以是自訂類型。 | String | N/A | 必要 |
adapter | 後端系統的來源組態。請參閱子内容: | JSON | N/A | 必要 |
| instanceName | 連接器實例,表示哪個連接器會用來連線後端系統。 | String | N/A | 必要 |
thingName | 從中擷取資料的後端系統或轉接器的名稱。 | String | N/A | 必要 |
inTailoring | 圖標元件在調整頁中是否可調整。選項:true、false。 | Boolean | false | 選用 |
maxTileCount | 請參閱子内容: | N/A | N/A | 必要 |
value | 要顯示為圖標的最大屬性數目。如果設定為空白字串,則所顯示的圖標數目沒有任何條件約束。 | Integer | N/A | 必填;JSON 金鑰為必填項,但可能是空字串。 |
version | 組態版本。 | String | 1.0.0 | 選用 |
modelThing | 請參閱子内容: | N/A | N/A | N/A |
entityName | 取得資料之模型物件的名稱。 | String | PTC.TileAttrib uteModelThing | 必要 |
version | 組態版本。 | String | 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"
}
}