Validate 함수

적용 대상: Canvas 앱 모델 기반 앱

Validate 함수는 단일 열 또는 전체 레코드의 값이 데이터 원본에 대해 유효한지 여부를 확인합니다.

설명

사용자가 데이터 변경을 제출하기 전에 해당 제출의 유효성에 대한 즉각적인 피드백을 제공할 수 있으므로 사용자 경험이 향상됩니다.

데이터 원본은 레코드 내에서 유효한 값을 구성하는 항목에 대한 정보를 제공할 수 있습니다. 이 정보에는 다음 예제와 같은 많은 제약 조건이 포함될 수 있습니다.

• 열 값이 필요한지 여부
• 텍스트 문자열의 최대 길이
• 최고 및 최저 숫자
• 가장 빠른 날짜 및 느린 날짜

Validate 함수는 이 정보를 사용하여 값이 유효한지 확인하고 그렇지 않은 경우 적절한 오류 메시지를 반환합니다. DataSourceInfo 함수를 사용하여 Validate에서 사용하는 동일한 정보를 볼 수 있습니다.

데이터 원본은 전혀 제공하지 않는 경우를 포함하여 제공하는 유효성 검사 정보의 양에 따라 달라집니다. Validate 는 이 정보에 기반한 값만 검증할 수 있습니다. Validate에서 문제를 찾지 못해도 데이터 변경 적용이 여전히 실패할 수 있습니다. Errors 함수를 사용하여 오류에 대한 정보를 얻을 수 있습니다.

Validate에서 문제를 찾으면 함수는 앱 사용자에게 표시할 수 있는 오류 메시지를 반환합니다. 모든 값이 유효하면 Validate는 blank를 반환합니다. 유효성 검사 정보가 없는 컬렉션으로 작업하는 경우, 값은 항상 유효합니다.

구문

검증( 데이터 소스, 열, 값 )

• DataSource – 필수. 유효성을 검사할 데이터 원본입니다.
• 열 – 필수. 유효성을 검사할 열입니다.
• 값 – 필수. 유효성을 검사할 선택한 열의 값입니다.

검증( 데이터 소스, 원본 레코드, 업데이트 )

• DataSource – 필수. 유효성을 검사할 데이터 원본입니다.
• OriginalRecord - 필수. 유효성을 검사할 업데이트의 레코드입니다.
• 업데이트 - 필수. 원본 레코드에 적용할 변경 내용입니다.

예제

다음 예제의 경우 Scores 데이터 원본의 Percentage 열에 있는 값은 0~100이어야 합니다. 데이터가 유효성 검사를 통과하면 함수는 blank를 반환합니다. 그렇지 않으면 함수는 오류 메시지를 반환합니다.

단일 열로 유효성 검사

수식	설명	결과
검증(점수, 백분율, 10)	Scores 데이터 원본의 Percentage 열에서 유효한 값이 10인지 확인합니다.	공백
검증(점수, 백분율, 120)	Scores 데이터 원본의 Percentage 열에서 유효한 값이 120인지 확인합니다.	"값은 0~100이어야 합니다."

전체 레코드로 유효성 검사

수식	설명	결과
검증(점수, EditRecord, Gallery.Updates)	Scores 데이터 원본에 대한 모든 열의 값이 유효한지 확인합니다. 이 예제에서 Percentage 열의 값은 10입니다.	공백
검증(점수, EditRecord, Gallery.Updates)	Scores 데이터 원본에 대한 모든 열의 값이 유효한지 확인합니다. 이 예제에서 Percentage 열의 값은 120입니다.	"값은 0~100이어야 합니다."