항목 목록
정의 및 사용
항목 목록 재사용 가능 컴포넌트는 데이터 집합의 항목 목록을 그리드 보기로 표시할 수 있는 포함된 매쉬업입니다. 이 컴포넌트를 사용하면 사용자가 목록을 검색, 정렬 및 필터링할 수 있으며 전체 목록이나 특정 목록 항목에 대한 작업을 수행할 수 있습니다.
다음과 같은 방법으로 항목 목록 재사용 가능 컴포넌트를 구성할 수 있습니다.
• 목록에 입력을 제공하는 모델 사물 정의
• 검색 및 필터링 활성화 또는 비활성화
• 초기 필터링 및 정렬 옵션 설정
• 그리드의 최대 행 수 설정
• 목록에 대한 선택 유형 설정
• 포함된 작업 모음에서 사용할 수 있는 작업을 구성합니다. 자세한 내용은 작업 모음을 참조하십시오.
필터 드롭다운 메뉴 또는 검색 상자를 사용하여 항목 목록을 필터링하거나 검색할 수 있습니다. 그러나 JSON 구성 파일에서 필터 드롭다운 메뉴 및 검색 상자를 사용할 수 없는 경우 필터링 및 검색을 사용할 수 없습니다. 속성 이름을 클릭하여 목록을 속성별로 정렬할 수 있습니다. 정렬 순서를 반대로 하려면 속성 이름을 다시 클릭합니다.
항목 목록 재사용 가능 컴포넌트에는 포함된 작업 모음 재사용 가능 컴포넌트도 포함됩니다. 작업 모음을 구성하여 하나 이상의 목록 항목에 대한 작업 실행과 같은 추가 기능을 사용하도록 설정할 수 있습니다. 자세한 내용은
작업 모음을 참조하십시오. 기본적으로 항목 목록의 작업 모음에는 필터 조건과 일치하는 모든 속성 값을 CSV 파일로 내보내는
내보내기 작업이 포함되어 있습니다.
이 항목 목록에는 기본값 복원 버튼도 포함되어 있습니다. 기본값 복원 버튼은 열 정렬, 교체 및 표시/숨기기를 포함하여 필터링, 검색 및 그리드 레벨 작업을 위한 기본 설정을 복원합니다.
다음은 항목 목록 재사용 가능 컴포넌트를 보여주는 샘플 이미지입니다.
항목 목록 재사용 가능 컴포넌트에는 작업 목록(Task List), 영향 받는 항목 목록, 첨부 파일 목록 및 작업 목록(Activity List)과 같은 미리 정의된 네 가지 구성을 사용할 수 있습니다. 미리 정의된 특정 구성에 대한 자세한 내용은 해당 항목 페이지를 참조하십시오.
바인딩 속성
항목 목록 컴포넌트에는 바인딩에 사용할 수 있는 네 가지 속성이 있습니다.
• input - 백 엔드 시스템에서 데이터를 가져와야 하는 입력 ID인 JSON입니다. 이 정보는 CCO(Common Communication Object) 형식으로 제공됩니다. 이 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 | 그리드 영역에 표시할 최대 행 수입니다. 10,000 이하의 값을 입력하는 것이 좋습니다. | 정수 | 50 | 선택 사항 |
modelThingName | 데이터를 가져오는 모델 사물의 이름입니다. | 문자열 | PTC.ItemListModelThing입니다. | 필수 사항 |
label | 항목 목록의 제목입니다. | 문자열 | [[PTC.ItemList]] | 선택 사항 |
selectionType | 그리드에서 한 번에 선택할 수 있는 항목 수를 결정합니다. 사용 가능한 옵션은 none, single 또는 multi입니다. | 문자열 | multi | 선택 사항 |
waitForInput | 그리드를 채우는 항목의 검색을 트리거하기 전에 런타임 시 값이 항목 목록의 입력 매쉬업 매개 변수에 전달될 때까지 기다릴지 여부입니다. 사용 가능한 옵션은 true, false입니다. | 부울 | false | 선택 사항 |
filterFieldID | 필터링 기준이 되는 백 엔드 시스템의 필드 ID입니다. 비어 있는 경우 필터링할 옵션이 없습니다. | MultiValueSelector | 해당 없음 | 선택 사항 |
filterLabelOverride | 모델에서 반환된 표시 값을 재정의하는 필터에 대한 레이블입니다. | 문자열 | 해당 없음 | 선택 사항 |
defaultSelectedFilterValue | 필터링 기준이 되는 초기 선택된 값입니다. 비어 있으면 기본 필터링이 없습니다. | 문자열 | 해당 없음 | 선택 사항 |
defaultSortField | 정렬 기준이 되는 초기 열입니다. 비어 있으면 항목 목록이 첫 번째 열에 따라 정렬됩니다. | MultiValueSelector | 해당 없음 | 선택 사항 |
defaultSortDirection | 해당하는 경우 기본 정렬의 방향입니다. 사용 가능한 옵션은 asc(오름차순 표시) 및 dsc(내림차순 표시)입니다. 필드를 비워 두면 정렬 방향이 오름차순입니다. | 문자열 | asc | 선택 사항 |
enableSearch | 검색 필드를 표시할지 여부입니다. 옵션은 true, false입니다. | 부울 | true | 선택 사항 |
findHintText | 검색 상자에 표시되는 힌트 텍스트입니다. | 문자열 | "[[PTC.ItemListFindHintText]]" | 선택 사항 |
attributes | 그리드에 표시할 속성입니다. 자세한 내용은 MultiValueSelector 설명서를 참조하십시오. 다음 추가 하위 속성을 참조하십시오. | MultiValueSelector | 해당 없음 | 필수 사항 |
fieldTitleOverride | 모델에서 가져온 필드 이름을 재정의하는 속성에 대한 대체 표시 이름입니다. | 문자열 | 해당 없음 | 선택 사항 |
showExportAction | 내보내기 작업을 활성화하거나 비활성화합니다. 옵션은 true, false입니다. | 부울 | true | 선택 사항 |
actionBarConfiguration | 포함된 작업 모음의 구성입니다. 자세한 내용은 작업 모음을 참조하십시오. | JSON | 해당 없음 | 선택 사항 |
modelConfigurations | 컴포넌트를 추가로 사용자 정의하기 위해 응용 프로그램 빌더가 모델에 추가 값을 전달하는 진입점입니다. | JSON | 해당 없음 | 선택 사항 |
샘플 구성
{
"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
}
}
