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이어야 합니다."