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. Xác thực 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
Xác thực( DataSource, Cột, Giá trị )
- 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.
Xác thực( Nguồn dữ liệu, Bản ghi gốc, Cập nhật )
- 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.
Xác thực với một cột
| Công thức | Mô tả | Kết quả |
|---|---|---|
| Xác thực (Điểm, 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 |
| Xác thực (Điểm, 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." |
Xác thực với một bản ghi hoàn chỉnh
| Công thức | Mô tả | Kết quả |
|---|---|---|
| Xác thực (Điểm, Chỉnh sửa hồ sơ, Thư viện.Cập nhật) | 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 |
| Xác thực (Điểm, Chỉnh sửa hồ sơ, Thư viện.Cập nhật) | 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." |