Συνάρτηση Validate

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

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

Περιγραφή

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

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

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

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

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

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

Σύνταξη

Validate( Προέλευση δεδομένων, Στήλη, Τιμή )

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

Validate( DataSource, OriginalRecord, Updates )

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

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

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

Validate με μία μόνο στήλη

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

Validate με μια πλήρη εγγραφή

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