Validate 함수
적용 대상: 캔버스 앱
모델 기반 앱
Validate 함수는 단일 열 또는 전체 레코드의 값이 데이터 원본에 대해 유효한지 여부를 확인합니다.
설명
사용자가 데이터 변경을 제출하기 전에 해당 제출의 유효성에 대한 즉각적인 피드백을 제공할 수 있으므로 사용자 경험이 향상됩니다.
데이터 원본은 레코드 내에서 유효한 값을 구성하는 항목에 대한 정보를 제공할 수 있습니다. 이 정보에는 다음 예제와 같은 많은 제약 조건이 포함될 수 있습니다.
- 열 값이 필요한지 여부
- 텍스트 문자열의 최대 길이
- 최고 및 최저 숫자
- 가장 빠른 날짜 및 느린 날짜
Validate 함수는 이 정보를 사용하여 값이 유효한지 확인하고 그렇지 않은 경우 적절한 오류 메시지를 반환합니다. DataSourceInfo 함수를 사용하여 Validate에서 사용하는 동일한 정보를 볼 수 있습니다.
데이터 원본은 전혀 제공하지 않는 경우를 포함하여 제공하는 유효성 검사 정보의 양에 따라 달라집니다. Validate는 이 정보에 따라 값을 확인만 할 수 있습니다. Validate에서 문제를 찾지 못해도 데이터 변경 적용이 여전히 실패할 수 있습니다. Errors 함수를 사용하여 오류에 대한 정보를 얻을 수 있습니다.
Validate에서 문제를 찾으면 함수는 앱 사용자에게 표시할 수 있는 오류 메시지를 반환합니다. 모든 값이 유효하면 Validate는 blank를 반환합니다. 유효성 검사 정보가 없는 컬렉션으로 작업하는 경우, 값은 항상 유효합니다.
구문
Validate( DataSource, Column, Value )
- DataSource – 필수 항목입니다. 유효성을 검사할 데이터 원본입니다.
- Column – 필수 항목입니다. 유효성을 검사할 열입니다.
- Value - 필수 항목입니다. 유효성을 검사할 선택한 열의 값입니다.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – 필수 항목입니다. 유효성을 검사할 데이터 원본입니다.
- OriginalRecord - 필수 항목입니다. 유효성을 검사할 업데이트의 레코드입니다.
- Updates - 필수 항목입니다. 원본 레코드에 적용할 변경 내용입니다.
예제
다음 예제의 경우 Scores 데이터 원본의 Percentage 열에 있는 값은 0~100이어야 합니다. 데이터가 유효성 검사를 통과하면 함수는 blank를 반환합니다. 그렇지 않으면 함수는 오류 메시지를 반환합니다.
단일 열로 유효성 검사
수식 | 설명 | 결과 |
---|---|---|
Validate( Scores, Percentage, 10 ) | Scores 데이터 원본의 Percentage 열에서 유효한 값이 10인지 확인합니다. | blank |
Validate( Scores, Percentage, 120 ) | Scores 데이터 원본의 Percentage 열에서 유효한 값이 120인지 확인합니다. | "값은 0~100이어야 합니다." |
전체 레코드로 유효성 검사
수식 | 설명 | 결과 |
---|---|---|
Validate( Scores, EditRecord, Gallery.Updates ) | Scores 데이터 원본에 대한 모든 열의 값이 유효한지 확인합니다. 이 예제에서 Percentage 열의 값은 10입니다. | blank |
Validate( Scores, EditRecord, Gallery.Updates ) | Scores 데이터 원본에 대한 모든 열의 값이 유효한지 확인합니다. 이 예제에서 Percentage 열의 값은 120입니다. | "값은 0~100이어야 합니다." |