Συνάρτηση Validate

Ισχύει για: Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου

Η συνάρτηση Validate ελέγχει εάν η τιμή μιας μεμονωμένης στήλης ή μιας πλήρους εγγραφής είναι έγκυρη για μια προέλευση δεδομένων.

Περιγραφή

Πριν ένας χρήστης υποβάλλει μια αλλαγή δεδομένων, μπορείτε να παρέχετε σχόλια αμέσως σχετικά με την εγκυρότητα αυτής της υποβολής, δημιουργώντας έτσι μια καλύτερη εμπειρία χρήστη.

Οι προελεύσεις δεδομένων μπορούν να παρέχουν πληροφορίες για το τι συνιστά έγκυρες τιμές μέσα σε μια εγγραφή. Αυτές οι πληροφορίες μπορεί να περιλαμβάνουν πολλούς περιορισμούς, όπως αυτά τα παραδείγματα:

• εάν μια στήλη απαιτεί μια τιμή
• πόσο μήκος μπορεί να έχει μια συμβολοσειρά κειμένου
• πόσο υψηλός και χαμηλός μπορεί να είναι ένας αριθμός
• πόσο νωρίτερα και καθυστερημένα μπορεί να είναι μια ημερομηνία

Η συνάρτηση Validate χρησιμοποιεί αυτές τις πληροφορίες για να προσδιορίσει αν μια τιμή είναι έγκυρη και, εάν δεν είναι, για να επιστρέψει ένα κατάλληλο μήνυμα σφάλματος. Μπορείτε να χρησιμοποιήσετε τη συνάρτηση DataSourceInfo για να προβάλετε τις ίδιες πληροφορίες που χρησιμοποιεί η συνάρτηση Validate.

Οι προελεύσεις δεδομένων ποικίλλουν ως προς τον όγκο των πληροφοριών επικύρωσης που παρέχουν και ενδέχεται να μην παρέχουν καθόλου πληροφορίες. Η επικύρωση μπορεί να επαληθεύσει μόνο τιμές με βάση αυτές τις πληροφορίες. Ακόμα κι αν η Επικύρωση δεν εντοπίσει πρόβλημα, η εφαρμογή της αλλαγής δεδομένων ενδέχεται να αποτύχει. Μπορείτε να χρησιμοποιήσετε τη συνάρτηση Errors για να λάβετε πληροφορίες σχετικά με την αποτυχία.

Εάν η συνάρτηση Validate εντοπίσει πρόβλημα, επιστρέφει ένα μήνυμα σφάλματος που μπορείτε να το εμφανίσετε στον χρήστη της εφαρμογής. Εάν όλες οι τιμές είναι έγκυρες, η συνάρτηση Validate επιστρέφει blank. Όταν εργάζεστε με μια συλλογή που δεν έχει πληροφορίες επικύρωσης, οι τιμές είναι πάντα έγκυρες.

Σύνταξη

Validate( DataSource; Στήλη; Τιμή )

• DataSource – Απαιτείται. Η προέλευση δεδομένων που χρησιμοποιείται για επικύρωση.
• Στήλη – Απαιτείται. Η στήλη προς επικύρωση.
• Τιμή – Απαιτείται. Η τιμή για την επιλεγμένη στήλη προς επικύρωση.

Validate( DataSource; OriginalRecord; Ενημερώσεις )

• DataSource – Απαιτείται. Η προέλευση δεδομένων που χρησιμοποιείται για επικύρωση.
• OriginalRecord - Απαιτείται. Η εγγραφή στην οποία οι ενημερώσεις πρέπει να επικυρωθούν.
• Ενημερώσεις - Απαιτείται. Οι αλλαγές προς εφαρμογή για την αρχική εγγραφή.

Παραδείγματα

Για αυτά τα παραδείγματα, τις τιμές στη στήλη Percentage της προέλευσης δεδομένων Scores πρέπει να είναι μεταξύ 0 και 100, συμπεριλαμβανομένων των ακραίων τιμών. Εάν τα δεδομένα επικυρωθούν, η συνάρτηση επιστρέφει κενό. Διαφορετικά, η συνάρτηση επιστρέφει μήνυμα σφάλματος.

Επικύρωση με μία μόνο στήλη

Τύπος	Περιγραφή	Αποτέλεσμα
Validate( βαθμολογίες, ποσοστό, 10 )	Ελέγχει εάν το 10 είναι μια έγκυρη τιμή για τη στήλη Percentage στην προέλευση δεδομένων Scores.	λευκός
Validate( βαθμολογίες, ποσοστό, 120 )	Ελέγχει εάν το 120 είναι μια έγκυρη τιμή για τη στήλη Percentage στην προέλευση δεδομένων Scores.	"Οι τιμές πρέπει να είναι μεταξύ 0 και 100."

Επικύρωση με μια πλήρη εγγραφή

Τύπος	Περιγραφή	Αποτέλεσμα
Επικύρωση ( Βαθμολογίες, EditRecord, Gallery.Updates )	Ελέγχει αν οι τιμές σε όλες τις στήλες είναι έγκυρες για την προέλευση δεδομένων Scores. Σε αυτό το παράδειγμα, η τιμή της στήλης Percentage είναι 10.	λευκός
Επικύρωση ( Βαθμολογίες, EditRecord, Gallery.Updates )	Ελέγχει αν οι τιμές σε όλες τις στήλες είναι έγκυρες για την προέλευση δεδομένων Scores. Σε αυτό το παράδειγμα, η τιμή της στήλης Percentage είναι 120.	"Οι τιμές πρέπει να είναι μεταξύ 0 και 100."