進階自訂 > 使用可重複使用的元件 > 可用可重複使用的元件 > 項目清單
  
項目清單
定義與用法
項目清單可重複使用的元件是包含的混搭，可讓您在格點檢視中顯示資料集中的項目清單。它也可讓使用者搜尋、排序及篩選清單，以及對整個清單或特定清單項目執行動作。
您可以使用下列方式設定項目清單可重複使用的元件：
• 定義為清單提供輸入的模型物件
• 啟用或禁用搜尋與篩選
• 設定初始篩選與排序選項
• 設定格點中的最大列數目
• 設定清單的選取項類型
• 配置內嵌動作列中的可用動作；如需詳細資訊，請參閱動作列
您可以使用篩選器下拉選單或搜尋方塊來篩選或搜尋項目清單。但是，如果在 JSON 組態檔案中未啟用篩選器下拉選單與搜尋方塊，則篩選與搜尋不可用。您可以按一下屬性名稱來依屬性排序清單。若要反轉排序順序，請再次按一下屬性名稱。
項目清單可重複使用的元件也包含內嵌動作列可重複使用的元件。透過配置動作列，您可以啟用其他功能，例如對一個或多個清單項目執行動作。如需詳細資訊，請參閲動作列。依預設，項目清單中的動作列包含「匯出」動作，它會將符合篩選條件的所有屬性值匯出至 CSV 檔案。
項目清單也包含「還原預設值」按鈕。「還原預設值」按鈕還原篩選、搜尋及格點層級操作的預設設定，包含排序、交換及顯示與隱藏欄。
以下是顯示項目清單可重新使用元件之格式的範例圖像：
項目清單可重複使用的元件有四個預先定義的組態：任務清單、受影響項目清單、附件清單和活動清單。如需有關特定預先定義組態的詳細資訊，請參閱其主題頁。
繫結內容
項目清單元件有四個可用於繫結的屬性：
• input - 是需要從後端系統獲取數據之輸入 ID 的 JSON。此資訊以 CCO (通用通訊物件) 格式提供。此 JSON 中包含的金鑰取決於項目清單需要作為輸入接收的資料。例如，附件清單需要與受影響項目清單不同的輸入。
• tailoringName - 是元件實例名稱的字串。它與調整緊密結合。tailoringName 用於擷取每個元件之儲存的調整資訊。
• totalItemsNumber - 是符合搜尋與篩選條件之清單項目總數的整數。
• selectedItems - 具有格點中所選項目之清單的 JSON。以下是範例：
{
"timeStamp":"2019-08-25 18:53:33.476",
"data":[
{
"itemListsData":[
{
"items":[
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143921"
}
},
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143928"
}
}
],
"objectType":"PTC.Workflow.WorkItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
],
"version":"1.0.0",
"statusMessage":"OK",
"status":"200"
}
組態欄位
下表顯示用來配置此元件的 JSON 欄位。
屬性名稱
描述
類型
預設值
必要或選用
maxNumberOfRowsInGrid
要在格點區域中顯示的最大列數。建議輸入等於或小於10000 的值。
Integer
50
選用
modelThingName
取得資料之模型物件的名稱。
String
PTC.ItemListModelThing.
必要
label
項目清單的標題。
String
[[PTC.ItemList]]
選用
selectionType
決定一次可以選取格點中的多少項目。可用選項：none、single 或 multi。
String
multi
選用
waitForInput
在觸發對填入格點之項目的擷取之前，是否要在執行時間等候值傳遞至項目清單的輸入混搭參數。可用選項：true、false。
Boolean
false
選用
filterFieldID
後端系統中用來篩選的欄位 ID。若為空白，則沒有可篩選的選項。
MultiValueSelector
N/A
選用
filterLabelOverride
篩選器的標籤，會取代從模型傳回的顯示值。
String
N/A
選用
defaultSelectedFilterValue
作為篩選依據的初始選取值。若為空白，則沒有預設篩選。
String
N/A
選用
defaultSortField
要作為排序依據的初始欄。當為空白時，項目清單將按第一欄排序。
MultiValueSelector
N/A
選用
defaultSortDirection
預設排序方向 (若適用)。可用選項：asc 表示遞增，dsc 表示遞減。當將欄位保留空白時，排序方向為遞增。
String
asc
選用
enableSearch
是否要顯示搜尋欄位。選項：true、false。
Boolean
true
選用
findHintText
在搜尋方塊中顯示的提示文字。
String
"[[PTC.ItemListFindHintText]]"
選用
attributes
要在格點中顯示的屬性。如需詳細資訊，請參閱 MultiValueSelector 文件集。請參閱其他子内容：
MultiValueSelector
N/A
必要
fieldTitleOverride
屬性的替代顯示名稱，它會取代從模型中提取的欄位名稱。
String
N/A
選用
showExportAction
啟用或禁用「匯出」動作。選項：true、false。
Boolean
true
選用
actionBarConfiguration
內嵌動作列的配置。如需詳細資訊，請參閲動作列。
JSON
N/A
選用
modelConfigurations
應用程式建立器的進入點，可將其他值傳入至模型，以進一步自訂元件。
JSON
N/A
選用
範例組態
{
"modelConfigurations":{
},
"filterFieldId":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"defaultSortField":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"actionBarConfiguration":{
"maxItemsToShow":{
"value":2
},
"modelThingName":{
"entityName":"PTC.ActionBarModel.Thing"
},
"actions":{
"selectedValues":{
"data":[
{
"itemListsData":[
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
},
"modelThingName":{
"entityName":"PTC.ItemListModelThing"
},
"label":{
"value":"[[PTC.ItemListLabel]]"
},
"showExportAction":{
"value":true
},
"selectionType":{
"selectedKey":"multi"
},
"waitForInput":{
"value":false
},
"filterLabelOverride":{
"value":""
},
"defaultSortDirection":{
"selectedKey":"asc"
},
"attributes":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"",
"additionalData":{
"fieldTitleOverride":{
"value":""
}
}
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"defaultSelectedFilterValue":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"enableSearch":{
"value":true
},
"maxNumberOfRowsInGrid":{
"value":50
}
}