Xác thực 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 hoặc một bản ghi hoàn chỉnh là hợp lệ cho một nguồn dữ liệu.

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ệ hay 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ể dùng hàm DataSourceInfo để xem cùng một thông tin mà hàm Validate sử 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. Hàm Validate chỉ có thể xác minh các giá trị dựa trên thông tin này. Ngay cả khi hàm Validate không tìm thấy vấn đề, thì 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 hàm Validate tìm thấy một vấn đề, thì hàm này sẽ trả về một 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ị là hợp lệ, thì hàm Validate trả về kết quả blank. 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 )

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

Validate( DataSource, OriginalRecord, Updates )

• DataSource – Bắt buộc. Nguồn dữ liệu để xác thực.
• OriginalRecord - Bắt buộc. Bản ghi mà các bản cập nhật sẽ được xác thực.
• Updates - 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.

Xác thực với một cột

Công thức	Mô tả	Kết quả
Validate( Scores, Percentage, 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.	blank
Validate( Scores, Percentage, 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."

Xác thực với một bản ghi hoàn chỉnh

Công thức	Mô tả	Kết quả
Validate( Scores, 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.	blank
Validate( Scores, 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."