Συνάρτηση Validate

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

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

Περιγραφή

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

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

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

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

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

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

Σύνταξη

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

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

Validate( DataSource, OriginalRecord, Updates )

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

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

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

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

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

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

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