구조체 대표 필드

대표 필드(Main field)는 구조체(Struct) 안에서 요약 화면에 표시할 중심 값을 지정합니다. Address에 streetName과 postalCode를 대표로 두고 collectionDate와 collectorName을 수집 맥락으로 유지하는 예입니다. 대표는 하나 이상 지정할 수 있습니다.

이 기능은 베타이며 플랫폼 인스턴스(Enrollment)에 아직 제공되지 않거나 개발 중 동작이 바뀔 수 있습니다. 지원 구조체 필드 자료형을 대표 필드로 사용할 수 있습니다.

대표 필드 설정

Ontology Manager의 Object types에서 유형을 선택하고 Properties의 구조체 속성(Property)을 엽니다. 오른쪽 General의 Struct fields에서 대표로 사용할 필드를 선택합니다.

Edit {propertyName} struct field에서 Struct main field를 켜고 Confirm합니다. 여러 필드를 지정할 수 있으며 필드 패널을 끌어 순서를 바꿀 수 있습니다.

Save하면 Struct fields 목록에 Struct main field 표시가 붙습니다.

앱의 표시와 원본 값

지원하는 Workshop Object Table과 Object List 같은 요약 화면에서는 대표 값만 표시하고, 포인터를 올리거나 펼쳐 전체 구조체를 볼 수 있습니다. 앱은 대표 값만 보여 주거나 대표 값에 상세 도움말을 제공하고, 전체 정보가 필요한 상세 화면과 폼에서는 모든 필드를 보여 주는 구성을 사용할 수 있습니다.

대표 필드는 저장 방식을 바꾸지 않습니다. 전체 구조체와 부가 필드는 그대로 유지됩니다. 질의도 대표 필드에만 한정되지 않으며 앱과 SDK의 지원 범위에서 다른 필드로 검색하고 필터링할 수 있습니다.

인터페이스에 특정 필드 연결

인터페이스(Interface)가 cityName이라는 String 속성을 요구하면 Address 구조체의 city 필드를 연결할 수 있습니다. 인터페이스 선택기는 필드와 자료형을 보여 줍니다.

구현 결과에는 어떤 구조체와 필드를 사용하는지 표시됩니다.

대표 필드 표시는 선택기에서 찾기 쉽게 하는 역할도 합니다. 대표 필드로 지정하지 않은 필드도 인터페이스 속성에 직접 매핑할 수 있습니다.

대표 필드 구성을 바꾸면 그 표현에 의존하는 일부 인터페이스 구현이 유효하지 않게 될 수 있으므로 매핑을 함께 확인합니다.

구조체 배열과 리듀서

대표 필드는 단일 구조체와 구조체 배열 모두에 사용할 수 있습니다. 리듀서를 함께 구성하면 구조체 배열, 대표 필드의 배열, 단일 구조체 또는 대표 필드의 단일 값 형태로 계약을 구현할 수 있습니다.

SDK에서 반환 표현을 선택하는 방법은 리듀서와 SDK 옵션에 있습니다. 대표 값에서 원래 구조를 복원해야 하는 인터페이스 액션 편집에는 해당 변환의 제한이 적용됩니다.