속성
정의 및 사용
속성 구성 요소는 이름-값 쌍을 표시하는 위젯입니다. 이 값은 항상 이름 아래에 표시됩니다. 다른 데이터 유형의 값을 표시할 수 있습니다. 그룹 이름을 사용하여 속성 세트를 그룹으로 표시할 수 있습니다.
다음은 속성 구성 요소를 보여주는 샘플 이미지입니다.
다음과 같은 방법으로 속성 구성 요소를 구성할 수 있습니다.
• 표시할 속성 정의
• 레이아웃 및 관련 디스플레이 설정 지정
• 속성 그룹의 제목을 정의합니다. 세로 레이아웃의 속성 그룹에만 사용할 수 있습니다.
속성 일반은 속성 구성 요소에 사용할 수 있는 일반 사전 정의된 구성입니다.
바인딩 속성
입력 | ||
|---|---|---|
속성 이름 | 설명 | 속성 유형 |
Input | 백엔드 시스템에서 불러올 데이터를 식별하는 데 사용됩니다. 샘플 JSON: { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] } | CCO 형식의 JSON |
TailoringName | 속성 구성 요소의 인스턴스를 고유하게 식별합니다. 이 값은 특정 인스턴스에 대한 수정 정보를 보기 위해 내부적으로 사용됩니다. 사용자 지정 작업에 대한 전용 수정 페이지가 있는 경우에만 이 바인딩 속성을 사용합니다. | 문자열 |
SubComponentConfiguration | 이 구성 요소가 다른 구성 요소 내에서 하위 구성 요소로 사용되거나 포함된 매쉬업 내에 있는 경우 이 속성에 구성을 바인딩합니다. 샘플 JSON: { "implementationThingName":"PTC.Nav.AttributesGenericBusinessLogicThing", "configuration":{ "layout":{ "selectedKey":"horizontal", "additionalData":{ }, "version":"1.0.0" }, "attributes":{ "sets":[ { "data":{ "selectedValues":{ "data":[ { "itemListsData":[ { "items":[ { "id":"Role#Display", "ordinal":0 }, { "id":"Activity|Deadline", "ordinal":5 }, { "id":"Status#Display", "ordinal":4 } ], "objectType":"PTC.Workflow.WorkItem" }, { "items":[ { "id":"Category#Display", "ordinal":1 }, { "id":"RequestPriority#Display", "ordinal":3 } ], "objectType":"PTC.ChangeMgmt.ChangeRequest" } ], "adapter":{ "instanceName":"windchill", "thingName":"PTC.WCAdapter" } } ] } } } ] } } } | JSON |
구성 속성
다음 표에는 이 구성 요소를 구성하는 데 사용되는 JSON 속성이 나와 있습니다.
구성 구조에 대한 자세한 내용은 구성 요소 구성 구조를 참조하십시오.
하위 속성에 대한 자세한 내용은 하위 속성 및 컨테이너 키를 참조하십시오.
속성 이름 | 설명 | 속성 유형 | 기본값 | 필수 사항 또는 선택 사항 | |
|---|---|---|---|---|---|
attributes | 백엔드 시스템에서 데이터를 불러와야 하는 속성 목록입니다. Windchill의 경우 이러한 속성 이름은 Windchill REST Services EDM에 정의된 이름과 일치해야 합니다. | 해당 없음 | 필수 사항 | ||
isMultiLine | 콘텐츠 래핑 여부를 결정합니다. 옵션은 true, false입니다. 이 속성은 layout에 대한 하위 속성이며 layout이 vertical로 설정된 경우에만 관련이 있습니다. 컨테이너 키는 isMultilineDefinition입니다. | 해당 없음 | 필수 사항 | ||
layout | 사용자 인터페이스에서 속성이 정렬되는 방법을 결정합니다. 사용 가능한 옵션은 다음과 같습니다. • vertical: 속성이 위아래로 누적됩니다. • horizontal: 속성이 나란히 정렬됩니다. | 해당 없음 | 필수 사항 | ||
maxHeight | 사용자 인터페이스의 속성 이름 및 값 모두에 대한 최대 높이입니다. 콘텐츠가 maxHeight 속성 값을 초과하는 경우 "자세히 표시/간단히 표시" 링크나 버튼이 표시됩니다. 이 속성은 다음 두 가지 경우에만 관련이 있습니다. • layout이 horizontal로 설정된 경우입니다. 이 경우에는 layout의 하위 속성입니다. • layout이 vertical로 설정되고 isMultiLine이 true로 설정된 경우입니다. 이 경우에는 isMultiLine의 하위 속성입니다. 컨테이너 키는 dimensionDefinition입니다. | 해당 없음 | 필수 사항 | ||
maxWidth | 사용자 인터페이스의 속성 이름 및 값에 대한 최대 너비입니다. 이 속성은 다음 두 가지 경우에만 관련이 있습니다. • layout이 horizontal로 설정된 경우입니다. 이 경우에는 layout의 하위 속성입니다. • layout이 vertical로 설정되고 isMultiLine이 false로 설정된 경우입니다. 이 경우에는 isMultiLine의 하위 속성입니다. 컨테이너 키는 dimensionDefinition입니다. | 해당 없음 | 필수 사항 | ||
샘플 구성
속성 구성 요소에 대한 샘플 구성은 일반 속성 구성을 참조하십시오.
사용자 지정 서비스
구성 외에도 각 구성 요소는 비즈니스 로직을 확장하여 구성 요소를 사용자 지정할 수 있도록 지원합니다. 각 구성 요소의 비즈니스 로직에는 확장하고 재정의할 수 있는 사물 템플릿의 재정의 가능 서비스가 포함되어 있습니다. 이 구성 요소에 대한 재정의 가능 서비스는 다음 표에 자세히 설명되어 있습니다.
각 서비스에 대한 반환 및 매개 변수의 예는 사용자 정의 서비스에 대한 입력/출력의 예를 참조하십시오.
이름 | 설명 |
|---|---|
GetConfigurations | 구성 요소 구현에 사용할 수 있는 구성을 반환합니다. 매개 변수: 없음 반환: JSON |
GetImplementationLabel | 번역된 이름을 얻기 위해 사용할 수 있는 구성 요소 또는 토큰의 번역된 이름을 반환합니다. 이 번역된 이름은 Mashup Builder 사용자 인터페이스에 표시됩니다. 매개 변수: 없음 반환: 문자열 |
ProcessAttributesConfiguration | 속성 구성을 처리하고 속성을 기본 속성 및 추가 속성으로 분할합니다. 다음 형식의 키 값 쌍이 있는 JSON을 반환합니다. • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON 속성은 해당 객체 유형에 따라 기본 및 추가 속성으로 분할됩니다. 객체 유형이 .Custom.Adapter 또는 Custom.Implementation으로 끝나는 속성은 추가 속성으로 처리됩니다. 다른 모든 속성은 기본 속성으로 간주됩니다. 매개 변수: attributes(필수 사항) – 기본 속성 및 추가 속성 목록을 포함하는 JSON입니다. configuration(선택 사항) – 수정 매니저 리소스에서 가져온 최종 결합된 구성을 포함하는 JSON입니다. 반환: CCO 형식의 JSON |
GetAttributesValues | 속성 및 해당 값을 포함하여 JSON을 반환합니다. 매개 변수: input(필수 사항) – 백엔드 시스템에서 불러올 데이터의 입력 ID와 백엔드 시스템에 대한 어댑터 정보를 포함하는 CCO 형식의 JSON입니다. configuration(선택 사항) – 수정 매니저 리소스에서 가져온 최종 결합된 구성을 포함하는 JSON입니다. attributes(필수 사항) – 기본 속성 및 추가 속성 목록을 포함하는 JSON입니다. 반환: CCO 형식의 JSON |
GetAdditionalAttributesValues | 추가 속성에 대한 값이 포함된 JSON을 반환합니다. 이 서비스는 구성 요소 구현에 의해 구현되어야 합니다. 매개 변수: input(필수 사항) – 백엔드 시스템에서 불러올 데이터의 입력 ID와 백엔드 시스템에 대한 어댑터 정보를 포함하는 CCO 형식의 JSON입니다. configuration(선택 사항) – 수정 매니저 리소스에서 가져온 최종 결합된 구성을 포함하는 JSON입니다. attributes(필수 사항) – 추가 속성 목록을 포함하는 JSON입니다. OOTBAttributesValues(선택 사항) – GetAttributesValues에서 반환된 기본 속성 값을 포함하는 CCO 형식의 JSON입니다.이 값을 사용하여 추가 속성에 대한 값을 계산할 수 있습니다. 반환: CCO 형식의 JSON |
GetAdditionalAttributes | 사용 가능한 기본 속성 목록에 추가될 추가 속성 목록을 반환합니다. 매개 변수: 없음 반환: JSON |
UpdateAvailableAttributes | 속성 목록에서 속성을 하나 이상 업데이트하고 최종 목록을 반환합니다. 매개 변수: attributes(필수 사항) – 기본 속성 및 추가 속성 목록을 포함하는 JSON입니다. 반환: JSON |
구현 정의
속성 구성 요소에 대한 구현은 속성 일반 구성을 참조하십시오.