속성과 속성값
속성(Property)은 객체 유형(Object type)이 가진 특징의 정의입니다. 속성값(Property value)은 객체(Object) 하나에 실제로 들어 있는 값입니다.
가상의 Employee에 employee number, start date와 role 속성이 있다면 Melissa Chang의 값은 각각 11502, October 9, 2016과 software engineer일 수 있습니다.
가상의 항공편 JFK → SFO 24-02-2021에는 departure date가 24-02-2021, arrival date가 25-02-2021, passenger count가 150인 값을 둘 수 있습니다. 날짜 문자열은 이 예제의 표시값입니다.
데이터셋(Dataset)의 열은 속성 정의에, 특정 행과 열의 값은 속성값에 대응합니다. 기반 데이터소스(Backing datasource)를 추가하여 조직의 실제 자료를 매핑하거나 액션(Action)이 객체와 값을 생성하도록 구성합니다. 모든 값을 액션으로 만들면 데이터소스 없는 유형도 사용할 수 있습니다.
제목 키와 기본 키
제목 키(Title key)는 객체를 표시할 이름이고 기본 키(Primary key)는 객체를 유일하게 식별하는 값입니다. 자료형을 선택할 때 두 역할의 지원 범위를 구분합니다.
| 기본 자료형(Base type) | 제목 키 | 기본 키 | 조건 |
|---|---|---|---|
| String, Integer, Short | 가능 | 가능 | 일반적으로 사용하는 종류입니다. |
| Date, Timestamp | 가능 | 권장하지 않음 | 저장 형식과 표시 형식의 차이 및 충돌 가능성을 고려하여 키에는 대체로 String을 권장합니다. |
| Boolean, Byte, Long | 가능 | 권장하지 않음 | 아래의 표현 범위와 편집 입력 조건을 확인합니다. |
| Float, Double, Decimal | 가능 | 불가 | 실수 계열을 기본 키로 사용하지 않습니다. |
| Vector | 불가 | 불가 | 의미 기반 검색용 벡터입니다. |
| Array | 내부 자료형에 따라 가능 | 불가 | 내부 자료형이 제목 키로 가능한 경우에만 가능합니다. null 원소와 V2의 중첩 배열은 지원하지 않습니다. |
| Struct | 불가 | 불가 | 중첩 구조체 및 구조체 필드의 배열은 지원하지 않습니다. 구조체 자체의 배열은 별도 지원합니다. |
| Media Reference, Time Series, Geotemporal Series, Attachment | 불가 | 불가 | 각 특수 자료형의 구성 조건을 따릅니다. |
| Geopoint | 가능 | 불가 | latitude,longitude 순서의 쉼표 구분 문자열로 저장합니다. 예는 57.64911,10.40744입니다. |
| Geoshape | 불가 | 불가 | 지리 도형을 표현합니다. |
| Marking | 불가 | 불가 | 보안 표지(Marking) 자료형입니다. |
| Cipher | 가능 | 불가 | 암호화된 문자열을 표현합니다. |
Boolean을 기본 키로 쓰면 가능한 고유 값이 두 개뿐이므로 객체도 최대 두 개입니다. Byte 속성은 액션에서 Integer 매개변수(Parameter)로 값을 받으므로 보통 Integer 속성이 더 편리합니다. Long은 특히 1e15보다 큰 값을 일부 프런트엔드와 코드에서 다루기 어려워 키에는 대체로 String을 권장합니다. 이는 모든 JavaScript 숫자가 1e15부터 부정확하다는 뜻은 아닙니다.
현재 액션은 Byte와 Short를 Integer 입력으로, Float를 Double 입력으로 편집할 수 있습니다. 속성의 자료형과 액션 매개변수의 자료형 이름이 반드시 같지는 않습니다. 액션의 자료형별 지원 표에서 단일 값과 배열의 차이도 확인합니다.
구조체 속성은 Object Storage V2에서 데이터셋 또는 제한 뷰(Restricted view)의 단일 구조체 열에 매핑합니다. 구조체 안에는 하나 이상의 필드가 필요하며 각 필드의 지원 자료형을 따릅니다.
유형 생성에서 속성과 키를 함께 구성하고 유형 변경에서 이미 사용 중인 속성을 바꿀 때의 영향을 확인합니다.
정의와 표시 구성
- 속성 편집: 열 매핑, 자료형, 키와 일괄 메타데이터 수정
- 속성 메타데이터: ID와 API 이름, 상태 및 기능별 자료형 지원
- 값 서식: 단위, 자릿수와 날짜 및 식별자 표시
- 조건부 서식: 기준 속성, 비교 조건과 규칙 복사
값 공급과 검증
- 기본 자료형: 특수 자료형과 미디어 참조의 구성
- 편집 전용 속성: 기반 열 없이 편집으로 값을 공급하는 방식
- 필수 속성: 인덱싱과 액션 검증 및 다중 원천의 예외
- 강제적 접근 통제 속성: 데이터소스별 표지와 조직 및 분류 요건
- 리듀서: 전체 배열을 유지하면서 대표 값을 표시하고 인터페이스에 제공하는 방식
구조화된 값
구조체 속성은 여러 필드를 하나의 값으로 묶습니다. 단일 기반 열, 배열의 필드 조건 평가와 앱별 지원을 구분하고 생성, 자동 매핑, 공유 정의 및 대표 필드를 구성합니다.
여러 유형의 공통 정의
공유 속성은 여러 객체 유형의 메타데이터를 한곳에서 관리합니다. 각 객체의 값은 독립적으로 유지하며, 적용할 때 로컬 ID와 API 이름을 보존하고 상속 및 연결 해제 조건을 따릅니다.
업무 의미와 재사용할 검증
값 유형은 필드 자료형에 업무 의미와 검증 제약을 더합니다. 정의한 공간 안에서 속성, 파이프라인과 액션 입력에 적용하며 실패 시점, 목록과 원소의 검증 및 버전 전파를 구분합니다.
앱 동작과 변경 상태
유형 클래스는 앱이 해석할 추가 의미를, 렌더링 힌트는 표시와 지원되는 검색 동작을 구성합니다. 상태는 운영 의존과 변경 보호, promoted 승격 및 관련 리소스의 일관성을 관리합니다.