Validate chức năng

Áp dụng cho: Ứng dụng Canvas Ứng dụng dựa trên mô hình

Hàm Validate kiểm tra xem giá trị của một cột đơn hay bản ghi hoàn chỉnh có hợp lệ đối với nguồn dữ liệu hay không.

Mô tả

Trước khi người dùng gửi dữ liệu thay đổi, bạn có thể cung cấp phản hồi ngay lập tức về tính hợp lệ của nội dung gửi đó để mang lại trải nghiệm người dùng tốt hơn.

Nguồn dữ liệu có thể cung cấp thông tin về những gì tạo thành giá trị hợp lệ trong một bản ghi. Thông tin này có thể bao gồm nhiều ràng buộc, chẳng hạn như:

• cột có yêu cầu giá trị không
• chuỗi văn bản có thể dài bao nhiêu
• số có thể cao và thấp như thế nào
• ngày có thể sớm và muộn ra sao

Hàm Validate sử dụng thông tin này để xác định xem một giá trị có hợp lệ không và trả về một thông báo lỗi thích hợp nếu không. Bạn có thể sử dụng hàm DataSourceInfo để xem cùng một thông tin sử Validate dụng.

Các nguồn dữ liệu khác nhau về lượng thông tin xác thực sẽ cung cấp, bao gồm cả việc không cung cấp bất kỳ thông tin nào. Validate chỉ có thể xác minh các giá trị dựa trên thông tin này. Ngay cả khi Validate không tìm thấy sự cố, việc áp dụng thay đổi dữ liệu vẫn có thể không thành công. Bạn có thể dùng hàm Errors để có được thông tin về trường hợp không thành công này.

Nếu Validate tìm thấy sự cố, hàm sẽ trả về thông báo lỗi mà bạn có thể hiển thị cho người dùng ứng dụng. Nếu tất cả các giá trị đều hợp lệ, trả Validatevề giá trị trống. Khi bạn thao tác với bộ sưu tập không có thông tin xác thực, các giá trị luôn hợp lệ.

Cú pháp

Validate( DataSource, Column, Value )

• Nguồn dữ liệu – Bắt buộc. Nguồn dữ liệu để xác thực.
• Cột – Bắt buộc. Cột để xác thực.
• Giá trị – Bắt buộc. Giá trị của cột đã chọn sẽ được xác thực.

Validate( DataSource, OriginalRecord, Updates )

• Nguồn dữ liệu – Bắt buộc. Nguồn dữ liệu để xác thực.
• Bản ghi gốc - Bắt buộc. Bản ghi mà các bản cập nhật sẽ được xác thực.
• Cập nhật - Bắt buộc. Các thay đổi để áp dụng cho bản ghi gốc.

Ví dụ

Đối với những ví dụ này, các giá trị trong cột Percentage (Tỷ lệ phần trăm) của nguồn dữ liệu Scores (Điểm số) phải nằm trong khoảng từ 0 đến 100, tính toàn bộ. Nếu dữ liệu vượt qua quy trình xác thực, hàm sẽ trả về kết quả trống. Nếu không, hàm sẽ trả về một thông báo lỗi.

Validate với một cột duy nhất

Công thức	Mô tả	Kết quả
Validate( Điểm số, Phần trăm, 10 )	Kiểm tra xem 10 có phải là một giá trị hợp lệ của cột Percentage (Tỷ lệ phần trăm) trong nguồn dữ liệu Scores (Điểm số) hay không.	trống
Validate( Điểm số, Phần trăm, 120 )	Kiểm tra xem 120 có phải là một giá trị hợp lệ của cột Percentage (Tỷ lệ phần trăm) trong nguồn dữ liệu Scores (Điểm số) hay không.	"Các giá trị phải nằm trong khoảng từ 0 đến 100."

Validate với một bản ghi hoàn chỉnh

Công thức	Mô tả	Kết quả
Validate( Điểm số, EditRecord, Gallery.Updates )	Kiểm tra xem các giá trị trong tất cả các cột có hợp lệ cho nguồn dữ liệu Scores (Điểm số) hay không. Trong ví dụ này, giá trị trong cột Percentage (Tỷ lệ phần trăm) là 10.	trống
Validate( Điểm số, EditRecord, Gallery.Updates )	Kiểm tra xem các giá trị trong tất cả các cột có hợp lệ cho nguồn dữ liệu Scores (Điểm số) hay không. Trong ví dụ này, giá trị trong cột Percentage (Tỷ lệ phần trăm) là 120.	"Các giá trị phải nằm trong khoảng từ 0 đến 100."