속성 메타데이터와 지원 차이
속성(Property)의 메타데이터는 값의 의미, 자료형과 표시 방식을 정합니다. 가상의 Employee에서 start date 속성을 사용하는 예를 기준으로 항목을 구분합니다.
| 항목 | 의미와 예 |
|---|---|
| ID | 앱 구성에서 참조하는 속성 식별자입니다. 예는 start-date입니다. |
| Display name | 사용자 화면에 표시하는 이름입니다. 예는 Start date입니다. |
| Description | 속성 설명입니다. 예는 The day the employee began new hire training입니다. |
| RID | 플랫폼이 자동 생성한 리소스 식별자(Resource identifier)이며 오류 메시지에 사용합니다. |
| Status | active, experimental, deprecated 또는 example입니다. 기본값은 experimental입니다. 상태와 변경 보호를 따르며 promoted는 속성에 적용하지 않습니다. |
| API name | 코드에서 참조할 이름입니다. 예는 startDate입니다. |
| Keys | 기본 키(Primary key) 또는 제목 키(Title key) 여부입니다. |
| Base type | 기본 자료형(Base type)과 가능한 연산을 정합니다. start date가 date이면 앱에서 타임라인을 구성할 수 있습니다. |
| Value formatting | 숫자, 날짜 및 시각, 사용자 ID와 리소스 ID 등의 값을 읽기 쉬운 형태로 표시합니다. |
| Conditional formatting | 값의 색상과 정렬을 조건에 따라 정합니다. 입사일이 2주 이내면 full name을 녹색으로 표시하는 예입니다. |
| Type classes | 앱이 해석할 추가 메타데이터입니다. |
| Render hints | 같은 자료형 안에서도 다른 표시나 인덱싱 동작을 지정할 수 있습니다. |
| Visibility | prominent, hidden과 normal로 일반 표시의 우선순위를 정합니다. 기본값은 normal이며 접근 권한과 별개입니다. |
제목 키를 full name으로 설정하면 Melissa Chang이나 Diego Rodriguez 같은 가상 직원 이름을 객체의 표시 이름으로 사용합니다. 기본 키는 employee number처럼 실제 객체를 유일하게 구분하는 값입니다.
일부 렌더링 힌트는 인덱싱 비용에 영향을 줍니다. 구형 인덱싱에서 start date로 검색하거나 정렬하지 않는 구성이라면 searchable와 sortable을 해제하여 재인덱싱 부담을 줄이는 방식이 사용됩니다. 소비 앱이 실제로 요구하는 검색과 정렬 기능을 먼저 확인합니다.
자료형별 기능 지원
속성 편집기의 Limited support 표시는 그 자료형이 모든 앱과 연산에서 같은 기능을 제공하지 않음을 나타냅니다. 저장 자료형과 액션 매개변수(Parameter) 자료형을 구분합니다.
| 속성 자료형 | 액션에서 사용할 입력 |
|---|---|
| Byte | Integer |
| Short | Integer |
| Float | Double |
| Vector | Object Storage V2에서 Double 목록 |
벡터는 KNN 의미 기반 검색에 사용하며 최대 차원은 2048입니다. TypeScript v1의 KNN은 V2와 1~100개 이웃 조건을 따릅니다. TypeScript v2와 Python의 검색 경로도 있으므로 벡터 조회를 TypeScript v1에만 한정하지 않습니다. 의미 기반 검색 구성에서 각 버전의 입력과 정렬 차이를 확인합니다.
단일 값 지원이 배열 지원을 뜻하지는 않습니다. 예를 들어 Vector의 배열은 속성과 액션에서 지원하지 않습니다. 속성 자료형과 키, 속성 편집, 값 서식과 조건부 서식을 함께 확인합니다.