自訂 ThingWorx Navigate > 建立自訂任務 > 在自訂任務中使用 ThingWorx Navigate 元件 > 可用元件 > 圖標
  
圖標
定義與用法
「圖標」元件是一個小器具,可讓您以圖標格式顯示名稱值對,也稱為屬性。「圖標」元件可用來反白關鍵資訊,從而讓使用者能夠一目了然。屬性值會顯示在圖標的上半部,屬性名稱會顯示在圖標的下半部。值可以佔用最多兩行,名稱可以佔用最多一行。如果值或名稱太長而不符合圖標大小,則會被截斷,以省略號表示。圖標通常會以單一列排列。如果要在單一列中容納太多的圖標,則會縮小圖標大小,使其符合。如果仍有過多的圖標要符合單一列,則會將圖示顯示在第二列上。
以下是顯示圖標元件的範例圖像:
您可以透過下列方式配置圖標元件:
設定要顯示的圖標的最大數目
新增其他屬性
泛用圖標是可用於「圖標」元件的泛用預先定義組態。
繫結內容
輸入
屬性名稱
描述
內容類型
Input
用來識別要從後端系統擷取的資料。
範例 JSON:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
CCO 格式的 JSON
TailoringName
唯一識別圖標元件的實例。此值可在內部用於尋找特定實例的調整資訊。
只有為自訂任務提供了專用調整頁的情況下,才可使用此繫結內容。
字串
組態內容
下表顯示用來配置此元件的 JSON 內容。
如需有關組態結構的詳細資訊,請參閱元件組態結構
如需有關子內容的詳細資訊,請參閱子內容與容器金鑰
屬性名稱
描述
內容類型
預設值
必要或選用
attributes
從後端系統獲取資料的屬性名稱。這些屬性可以從後端系統擷取,也可以是外加的。
N/A
必要
maxTileCount
要顯示為圖標的最大屬性數目。如果設定為空白字串,則不會顯示任何圖標數目條件約束。
N/A
選用
範例組態
如需圖標元件的範例組態,請參閱泛用圖標組態。
自訂服務
除組態以外,每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明:
如需每個服務的傳回結果與參數範例,請參閱自訂服務的輸入/輸出範例
名稱
描述
GetConfigurations
傳回元件實行的可用組態。
參數:
傳回:JSON
GetImplementationLabel
傳回元件的當地語系化名稱或可用於取得當地語系化名稱的權杖。此當地語系化名稱會顯示在 Mashup Builder 使用者介面中。
參數:
傳回:字串
ProcessAttributesConfiguration
處理屬性組態,並將屬性分為現成屬性與其他屬性。
以下列格式傳回 JSON,其中包含金鑰值對:
OOTBAttributes : OOTB Attributes configuration CCO JSON
additionalAttributes : Additional Attributes configuration CCO JSON
屬性會根據其物件類型分為現成屬性與其他屬性。物件類型以 .Custom.AdapterCustom.Implementation 結尾的屬性會被視為其他屬性。其他所有屬性都被視為現成屬性。
參數:
attributes (必要) - 包含現成屬性與其他屬性清單的 JSON。
configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。
傳回:CCO 格式的 JSON
GetAttributesValues
傳回 JSON,其中包含屬性及其值。
參數:
input (必要) - CCO 格式的 JSON,其中包括要從後端系統擷取之資料的輸入 ID,以及後端系統的轉接器資訊。
configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。
attributes (必要) - 包含現成屬性與其他屬性清單的 JSON。
傳回:CCO 格式的 JSON
GetAdditionalAttributesValues
傳回 JSON,其中包含其他屬性的值。此服務應該由元件實行來實行。
參數:
input (必要) - CCO 格式的 JSON,其中包括要從後端系統擷取之資料的輸入 ID,以及後端系統的轉接器資訊。
configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。
attributes (必要) - 包含其他屬性清單的 JSON。
OOTBAttributesValues (選用) - CCO 格式的 JSON,其中包括由 GetAttributesValues 傳回之現成屬性的值。這些值可用來計算其他屬性的值。
傳回:CCO 格式的 JSON
GetAdditionalAttributes
傳回要新增至可用現成屬性清單的其他屬性清單。
參數:
傳回:JSON
實行定義
如需圖標元件的實行定義,請參閱泛用圖標組態。