값 유형의 검증 제약
값 유형(Value type)은 선택적으로 검증 제약을 가질 수 있습니다. Value Types Manager에서 생성하거나 버전을 갱신할 때 기본 자료형(Base type)에 맞는 조건을 선택합니다.
열거형과 범위
| 제약 | 사용할 수 있는 자료형 | 동작 |
|---|---|---|
| Enum, one of | String, Boolean, Decimal, Double, Float, Integer, Short | 정해진 허용 값 중 하나인지 검사합니다. String은 대소문자 구분 여부를 선택할 수 있습니다. |
| Range | Decimal, Double, Float, Integer, Short, Date, Timestamp, String, Array | 최솟값, 최댓값 또는 허용 범위를 지정합니다. String은 문자열 길이, Array는 원소 수를 제한합니다. |
지원 목록에 없는 자료형으로 같은 제약을 확장해서 적용하지 않습니다. 액션 입력의 자료형 호환 여부는 사용 경로에서도 확인합니다.
문자열 전용 조건
- Regex는 정규식과의 일치를 검사합니다. 전체 값이 아니라 부분 문자열이 일치해도 통과하도록 설정할 수 있습니다.
- RID는 유효한 리소스 식별자(Resource identifier)인지 검사합니다.
- UUID는 유효한 UUID 형식인지 검사합니다.
배열 조건
Uniqueness는 모든 원소가 서로 다른지 검사합니다. Nested는 배열의 각 원소에 다른 값 유형 제약을 적용합니다. 예를 들어 문자열 배열의 모든 원소에 정규식 조건을 적용할 수 있습니다.
구조체 조건
Element constraints는 구조체(Struct) 필드 식별자와 값 유형 참조를 연결합니다. 지정한 필드에 해당 값 유형을 적용하는 방식입니다.
이 구조체 값 유형의 기능과 액션 매개변수의 지원 범위를 구분합니다. 현재 액션의 구조체 매개변수나 그 필드에는 값 유형 제약을 사용할 수 없습니다. 속성과 파이프라인의 값 유형 구성에는 해당 소비 경로의 조건을 적용합니다.
검증 실패 시 표시할 Failure validation message는 생성에서 정합니다. 실제 실패는 속성의 인덱싱 또는 액션의 검증 및 제출 단계에서 나타날 수 있습니다.