타일
정의 및 사용
타일 재사용 가능 컴포넌트는 이름-값 쌍(또는 속성)을 타일 형식으로 표시할 수 있는 위젯입니다. 타일 재사용 가능 컴포넌트의 목적은 사용자가 한 눈에 볼 수 있도록 주요 정보를 강조 표시하는 것입니다. 속성 값이 타일의 위쪽 절반에 표시되고 속성 이름이 타일의 아래쪽 절반에 표시됩니다. 이름 또는 값이 너무 길어서 타일에 맞지 않으면 잘리게 되며 줄임표로 표시됩니다. 타일은 일반적으로 한 행으로 정렬됩니다. 타일이 너무 많아 한 행에 맞지 않으면 행에 맞게 타일 크기가 줄어듭니다. 그래도 타일이 너무 많이 한 행에 맞지 않으면 타일 표시가 두 번째 행으로 넘어갑니다.
다음과 같은 방법으로 타일 재사용 가능 컴포넌트를 구성할 수 있습니다.
• 표시할 최대 속성 수 설정
• 사용자 지정 속성 추가
• 속성이 표시되는 순서 정의
다음은 타일 재사용 가능 컴포넌트를 보여주는 샘플 이미지입니다.
타일 재사용 가능 컴포넌트에 사용할 수 있는 미리 정의된 구성이 없습니다.
바인딩 속성
타일 컴포넌트의 두 가지 속성을 바인딩에 사용할 수 있습니다.
• Input - 백 엔드 시스템에서 데이터를 가져와야 하는 입력 ID인 JSON입니다. 이 정보는 CCO(Common Communication Object) 형식으로 제공됩니다. 다음은 샘플입니다.
{
"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 | 해당 없음 | 필수 사항 |
id | 백 엔드 시스템의 속성에 대한 속성-이름 식별자 또는 속성의 사용자 지정 속성-이름입니다. | 문자열 | 해당 없음 | 필수 사항 |
ordinal | 컴포넌트에 속성이 표시되는 순서입니다. 0은 초기 맨 왼쪽 위치를 나타냅니다. | 정수 | 해당 없음 | 선택 사항 |
objectType | 속성을 가져올 객체 유형입니다. 이 유형은 사용자 지정 유형일 수도 있습니다. | 문자열 | 해당 없음 | 필수 사항 |
adapter | 백 엔드 시스템에 대한 소스 구성입니다. 다음 하위 속성을 참조하십시오. | JSON | 해당 없음 | 필수 사항 |
| instanceName | 백 엔드 시스템에 연결하는 데 사용할 커넥터를 의미하는 커넥터 인스턴스입니다. | 문자열 | 해당 없음 | 필수 사항 |
thingName | 데이터를 검색할 백 엔드 시스템 또는 어댑터의 이름입니다. | 문자열 | 해당 없음 | 필수 사항 |
inTailoring | 수정 페이지에서 타일 컴포넌트를 수정할 수 있는지 여부입니다. 옵션은 true, false입니다. | 부울 | false | 선택 사항 |
maxTileCount | 다음 하위 속성을 참조하십시오. | 해당 없음 | 해당 없음 | 필수 사항 |
value | 타일로 표시할 최대 속성 수입니다. 빈 문자열로 설정되면 표시되는 타일 수에 제약 조건이 없습니다. | 정수 | 해당 없음 | 필수 사항 - JSON 키는 필수 사항이지만 빈 문자열일 수 있습니다. |
version | 구성 버전입니다. | 문자열 | 1.0.0 | 선택 사항 |
modelThing | 다음 하위 속성을 참조하십시오. | 해당 없음 | 해당 없음 | 해당 없음 |
entityName | 데이터를 가져오는 모델 사물의 이름입니다. | 문자열 | PTC.TileAttrib uteModelThing | 필수 사항 |
version | 구성 버전입니다. | 문자열 | 1.0.0 | 선택 사항 |
샘플 구성
사용자 지정 속성을 사용하지 않는 샘플 JSON:
{
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "RecurringCost",
"ordinal": 0
},
{
"id": "NonRecurringCost",
"ordinal": 1
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"modelThing": {
"entityName": "PTC.TileAttributeModelThing",
"version": "1.0.0"
},
"maxTileCount": {
"value": 5,
"version": "1.0.0"
}
}
사용자 지정 속성을 사용하는 샘플 JSON:
아래 샘플에는 두 개의 사용자 지정 속성인 Attachments 및 AffectedObjects가 있습니다. 해당 ObjectType은 기본 속성과 구분하기 위한 PTC.ChangeMgmt.ChangeRequest.Custom입니다.
{
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "RecurringCost",
"ordinal": 0
},
{
"id": "NonRecurringCost",
"ordinal": 1
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
},
{
"items": [
{
"id": "Attachments",
"ordinal": 2
},
{
"id": "AffectedObjects",
"ordinal": 3
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"modelThing": {
"entityName": "PTC.TileAttributeModelThing",
"version": "1.0.0"
},
"maxTileCount": {
"value": 5,
"version": "1.0.0"
}
}
