進階自訂 > 使用可重複使用的元件 > 可用可重複使用的元件 > 項目標識
  
項目標識
定義與用法
項目識別可重複使用的元件是一個小器具，可讓您顯示特定項目的基本資訊，也稱為標識資訊。資訊會顯示在面板中，通常位於項目頁的頂部。此面板包含項目的主要標題、次要標題及各種標識屬性。它也包含內嵌的動作列，其中包含您可以針對項目執行的動作。您可以使用面板左上角的箭頭來展開或摺疊項目標識面板。摺疊後，只有主要標題與動作列可見。
您可以透過下列方式配置項目標識可重複使用的元件：
• 定義要顯示的標識屬性
• 配置內嵌動作列中的可用動作
• 定義主要標題與次要標題
以下是顯示項目標識可重複使用元件的範例圖像：
任務標識是可用於項目標識可重複使用元件的唯一預定義組態。如需詳細資訊與範例組態，請參閱任務標識。
繫結內容
項目標識元件有兩個可用於繫結的屬性：
• 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
N/A
選用
id
後端系統中屬性的内容名稱識別元。例如，“Category#Display”。
String
""
必要
ordinal
屬性在元件中顯示的順序。0 表示初始最左側的位置。
Integer
N/A
選用
objectType
要擷取其屬性的物件類型。
String
""
必要
adapter
後端系統的來源組態。請參閱子内容：
JSON
N/A
必要
instanceName
連接器實例，表示用來連結後端系統的連接器。
String
""
必要
thingName
從中擷取資料的後端系統或轉接器的名稱。
String
""
必要
inTailoring
項目標識元件在調整頁中是否可調整。選項：true、false。
Boolean
false
選用
title
顯示在項目標識面板頂部的主要標題。請參閱子内容：
N/A
N/A
必要
pattern
在元件使用者介面中顯示為主要標題的字串。模式包含動態取代的數值識別元。字串中的每個數值識別元與 id 欄位中提供的内容名稱之一對應。
String
""
必要
id
後端系統中屬性的内容名稱識別元。例如，“Subject|SubjectName”。
String
""
必要
numericIdentifier
每個 id 都有一個數值識別元。該數值識別元在模式字串中替代為針對 id 擷取的值。
Integer
1
必要
objectType
要擷取其屬性的物件類型。
String
""
必要
adapter
後端系統的來源組態。請參閱子内容：
adapter
N/A
必要
instanceName
連接器實例，表示用來連結後端系統的連接器。
String
""
必要
thingName
從中擷取資料的後端系統或轉接器的名稱。
String
""
必要
secondaryTitle
次要標題會顯示在項目標識面板中主要標題的下方。請參閱子内容：
N/A
N/A
必要
pattern
在元件使用者介面中顯示為次要標題的字串。模式包含動態取代的數值識別元。字串中的每個數值識別元與 id 欄位中提供的内容名稱之一對應。
String
""
必要
id
後端系統中屬性的内容名稱識別元。例如，“Activity|Name”。
String
""
必要
numericIdentifier
每個 id 都有一個數值識別元。該數值識別元在模式字串中替代為針對 id 擷取的值。
Integer
1
必要
objectType
要擷取其屬性的物件類型。
String
""
必要
adapter
後端系統的來源組態。請參閱子内容：
adapter
N/A
必要
instanceName
連接器實例，表示用來連結後端系統的連接器。
String
""
必要
thingName
從中擷取資料的後端系統或轉接器的名稱。
String
""
必要
modelThing
請參閱子内容：
N/A
N/A
必要
entityName
取得資料之模型物件的名稱。
String
"PTC.ItemIdentity
ModelThing"
必要
version
組態版本。
String
“1.0.0”
選用
actions
要在使用者介面的動作列中顯示的動作。如需詳細資訊與子内容，請參閱動作列可重複使用的元件。
N/A
N/A
選用
範例組態
下列範例 JSON 組態適用于其預設組態中的項目標識。
{
"secondaryTitle": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": ""
},
{
"items": [
{
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
},
"inTailoring": true
},
"title": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"actions": {
"maxItemsToShow": {
"value": 2
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThing": {
"entityName": "PTC.ItemIdentityModelThing",
"version": "1.0.0"
}
}