항목 목록
정의 및 사용
항목 목록 구성 요소는 데이터 집합의 항목 목록을 그리드 보기로 표시할 수 있는 포함된 매쉬업입니다. 이 구성 요소를 사용하면 최종 사용자가 목록을 검색, 정렬 및 필터링할 수 있으며 전체 목록이나 특정 목록 항목에 대한 작업을 수행할 수 있습니다.
다음은 항목 목록 구성 요소를 보여주는 샘플 이미지입니다.
다음과 같은 방법으로 항목 목록 구성 요소를 구성할 수 있습니다.
• 검색 및 필터링 활성화 또는 비활성화
• 초기 필터링 및 정렬 옵션 설정
• 그리드의 최대 행 수 설정
• 목록에서 항목을 선택할 수 있는지 여부와, 그렇다면 항목을 하나 또는 여러 개 선택할 수 있는지 여부를 정의합니다.
• 포함된 작업 모음에서 사용할 수 있는 작업 구성
• 내보내기 작업을 표시할지 여부를 선택합니다.
사용자는 필터 상자 또는 검색 상자를 사용하여 항목 목록을 필터링하거나 검색할 수 있습니다. 그러나 구성에서 필터 상자 및 검색 상자를 사용할 수 없는 경우 필터링 및 검색을 사용할 수 없습니다. 열 제목을 클릭하여 해당 열을 기준으로 목록을 정렬할 수 있습니다. 정렬 순서를 반대로 하려면 열 제목을 다시 클릭합니다.
항목 목록 구성 요소에는 포함된 작업 모음 구성 요소가 포함됩니다. 작업 모음을 구성하여 하나 이상의 목록 항목에 대한 작업 실행과 같은 추가 기능을 사용하도록 설정할 수 있습니다. 자세한 내용은 작업 모음(베타)을 참조하십시오. 기본적으로 항목 목록에는 필터 조건과 일치하는 모든 항목을 CSV 파일로 내보내는 내보내기 작업이 포함되어 있습니다.
이 항목 목록에는 기본값 복원 버튼도 포함되어 있습니다. 기본값 복원 버튼은 열 정렬, 교체 및 표시/숨기기를 포함하여 필터링, 검색 및 그리드 레벨 작업을 위한 기본 설정을 복원합니다.
바인딩 속성
입력 | ||
|---|---|---|
속성 이름 | 설명 | 속성 유형 |
input | 백엔드 시스템에서 불러올 데이터를 식별하는 데 사용됩니다. 입력이 필수인 경우 waitForInput 구성 속성을 true로 설정합니다. 샘플 JSON: { "version":"1.0.0", "data":[ { "adapter":{ "instanceName":"windchill", "thingName":"PTC.WCAdapter" }, "itemListsData":[ { "items":[ { "id":{ "value":"OR:wt.workflow.work.WorkItem:1432583" } } ], "objectType":"PTC.Workflow.WorkItem" } ] } ] } | CCO 형식의 JSON |
tailoringName | 항목 목록 구성 요소의 인스턴스를 고유하게 식별합니다. 이 값은 특정 인스턴스에 대한 수정 정보를 보기 위해 내부적으로 사용됩니다. 사용자 지정 작업에 대한 전용 수정 페이지가 있는 경우에만 이 바인딩 속성을 사용합니다. | |
출력 | ||
|---|---|---|
속성 이름 | 설명 | 속성 유형 |
totalItemsNumber | 검색 및 필터 조건과 일치하는 목록 항목의 수입니다. | 정수 |
selectedItems | 선택한 그리드 항목과 해당 속성을 식별하는 데 사용됩니다. 이 속성은 다른 구성 요소의 input 바인딩 속성에 바인딩될 수 있습니다. 샘플 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" } | CCO 형식의 JSON |
구성 등록 정보
다음 표에는 이 구성 요소를 구성하는 데 사용되는 JSON 필드가 나와 있습니다.
구성 구조에 대한 자세한 내용은 구성 요소 구성 구조를 참조하십시오.
하위 속성에 대한 자세한 내용은 하위 속성 및 컨테이너 키를 참조하십시오.
속성 이름 | 설명 | 속성 유형 | 기본값 | 필수 사항 또는 선택 사항 | |
|---|---|---|---|---|---|
actionBarConfiguration | 포함된 작업 모음의 구성입니다. 자세한 내용은 작업 모음(베타)을 참조하십시오. | 해당 없음 | 선택 사항 | ||
attributes | 표시할 속성입니다. 그리드에 열 제목으로 나타납니다. | 해당 없음 | 필수 사항 | ||
defaultSelectedFilterValue | 필터링 기준이 되는 초기 선택된 값입니다. 비어 있으면 기본 필터링이 없습니다. 이 속성은 filterFields에 대한 하위 속성이며 filterFields가 구성에 포함된 경우에만 관련이 있습니다. 컨테이너 키는 itemListFilterFieldDefinition입니다. | 해당 없음 | 선택 사항 | ||
defaultSortDirection | 기본 정렬의 방향입니다. 옵션: asc는 오름차순 순서를 나타내고 dsc는 내림차순을 나타냅니다. 비어 있으면 정렬 방향이 오름차순입니다. 이 속성은 defaultSortField에 대한 하위 속성이며 defaultSortField가 구성에 포함된 경우에만 관련이 있습니다. 컨테이너 키는 itemListDefaultSortFieldDefinition입니다. | asc | 선택 사항 | ||
defaultSortField | 정렬 기준이 되는 초기 열입니다. 비어 있으면 항목 목록이 첫 번째 열에 따라 정렬됩니다. | 해당 없음 | 선택 사항 | ||
enableSearch | 검색 필드를 표시할지 여부입니다. 옵션은 true, false입니다. | true | 선택 사항 | ||
filterFields | 데이터를 필터링할 필드의 백엔드 시스템에 있는 ID입니다. 비어 있는 경우 데이터를 필터링할 옵션이 없습니다. | 해당 없음 | 선택 사항 | ||
filterLabelOverride | GetItems 서비스에서 반환된 표시 값을 재정의하는 필터에 대한 레이블입니다. 이 속성은 filterFields에 대한 하위 속성이며 filterFields가 구성에 포함된 경우에만 관련이 있습니다. 컨테이너 키는 itemListFilterFieldDefinition입니다. | 해당 없음 | 선택 사항 | ||
implementationConfigurations | 구성 요소를 추가로 사용자 지정하기 위해 응용 프로그램 빌더가 구현에 필요한 추가 값을 전달하는 진입점입니다. | 해당 없음 | 선택 사항 | ||
label | 항목 목록의 제목입니다. | [[PTC.ItemList]] | 선택 사항 | ||
maxNumberOfRowsInGrid | 그리드 영역에 표시할 최대 행 수입니다. 10,000보다 작은 값을 입력하는 것이 좋습니다. | 500 | 선택 사항 | ||
searchHintText | 검색 상자에 표시되는 힌트 텍스트입니다. 이 속성은 enableSearch에 대한 하위 속성이며 enableSearch이 true로 설정된 경우에만 관련이 있습니다. 컨테이너 키는 itemListSearchDefinition입니다. | Find Item | 선택 사항 | ||
selectionType | 그리드에서 한 번에 선택할 수 있는 항목 수를 결정합니다. 옵션: • none - 그리드 항목을 선택할 수 없습니다. • single - 한 번에 하나의 그리드 항목을 선택할 수 있습니다. • multi - 한 번에 하나 이상의 그리드 항목을 선택할 수 있습니다. | multi | 선택 사항 | ||
showExportAction | 내보내기 작업을 활성화하거나 비활성화합니다. 옵션은 true, false입니다. | true | 선택 사항 | ||
waitForInput | 그리드를 채우는 항목의 검색을 트리거하기 전에 런타임 시 값이 항목 목록의 입력 매쉬업 매개 변수에 전달될 때까지 기다릴지 여부입니다. 옵션은 true, false입니다. | false | 선택 사항 | ||
샘플 구성
사용자 지정 서비스
구성 외에도 각 구성 요소는 비즈니스 로직을 확장하여 구성 요소를 사용자 지정할 수 있도록 지원합니다. 각 구성 요소의 비즈니스 로직에는 확장하고 재정의할 수 있는 사물 템플릿의 재정의 가능 서비스가 포함되어 있습니다. 이 구성 요소에 대한 재정의 가능 서비스는 다음 표에 자세히 설명되어 있습니다.
각 서비스에 대한 반환 및 매개 변수 예는 사용자 정의 서비스에 대한 입력/출력의 예를 참조하십시오..
 | CCO 형식의 JSON 객체를 비즈니스 로직 구현 구성 요소에서 항목 목록 구성 요소로 반환할 때 단일 객체 유형의 속성만 포함합니다. 현재, 항목 목록은 서로 다른 객체 유형의 속성을 포함하는 것을 지원하지 않습니다. |
이름 | 설명 |
|---|---|
GetConfigurations | 구성 요소 구현에 사용할 수 있는 구성을 반환합니다. 매개 변수: 없음 반환: JSON |
GetImplementationLabel | 번역된 이름을 얻기 위해 사용할 수 있는 구성 요소 또는 토큰의 번역된 이름을 반환합니다. 이 번역된 이름은 Mashup Builder 사용자 인터페이스에 표시됩니다. 매개 변수: 없음 반환: 문자열 |
GetItems | 백엔드 시스템에서 항목 목록을 반환합니다. 항목 목록의 사용자 정의 구현을 작성하려면 이 서비스를 재정의하여 사용자 정의 데이터를 읽어들입니다. 매개 변수: input(선택 사항) – 백엔드 시스템에서 불러올 데이터의 입력 ID와 백엔드 시스템에 대한 어댑터 정보를 포함하는 CCO 형식의 JSON입니다. 이 매개 변수를 사용하는 경우 waitForInput 구성 속성이 true로 설정되어 있는지 확인합니다. configuration(필수 사항) – 수정 매니저 리소스에서 가져온 최종 결합된 구성을 포함하는 JSON입니다. 반환: CCO 형식의 JSON |
InitializeFilters | 구성의 각 필터 필드에 대한 필터 유형 정의를 반환합니다. 매개 변수: input(선택 사항) – 백엔드 시스템에서 불러올 데이터의 입력 ID와 백엔드 시스템에 대한 어댑터 정보를 포함하는 CCO 형식의 JSON입니다. configuration(필수 사항) – 수정 매니저 리소스에서 가져온 최종 병합된 구성을 포함하는 JSON입니다. 반환: CCO 형식의 JSON |
DefHookImplementationConfigurationDefinitionGroup | 구현에 대한 사용자 지정 구성을 사용하여 구현별 정의를 반환합니다. 매개 변수: 없음 반환: JSON:Array |
DefHookImplementationAttributesDefinition | 선택한 속성에 대한 구현별 정의를 반환합니다. 매개 변수: 없음 반환: JSON:Array |
DefHookMaxRowsProperties | 그리드 영역에 표시할 최대 행 수에 대한 속성을 반환합니다. 매개 변수: 없음 반환: JSON |
구현 정의