setSubmitMode (αναφορά API προγράμματος-πελάτη)

Ορίζει εάν τα δεδομένα από τη στήλη θα υποβάλλονται κατά την αποθήκευση της εγγραφής.

Υποστηριζόμενοι τύποι στηλών

Όλοι

Σύνταξη

formContext.getAttribute(arg).setSubmitMode(mode)

Παράμετροι

Τύπος: Συμβολοσειρά.

Περιγραφή: Ορίστε μία από τις παρακάτω τιμές λειτουργίας:

• always: Τα δεδομένα αποστέλλονται πάντα με αποθήκευση.
• never: Τα δεδομένα δεν αποστέλλονται ποτέ με αποθήκευση. Όταν χρησιμοποιείται αυτή η τιμή, δεν είναι δυνατή η επεξεργασία των στηλών στη φόρμα για αυτήν τη στήλη.
• dirty: Προεπιλεγμένη συμπεριφορά. Τα δεδομένα αποστέλλονται με την αποθήκευση όταν έχουν αλλάξει.

Παρατηρήσεις

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

Σημείωμα

Τα δεδομένα σε μια στήλη θα ανανεώνονται πάντα μετά την αποθήκευση της λειτουργίας, ακόμα και αν η λειτουργία υποβολής της στήλης έχει οριστεί σε never. Για παράδειγμα, εάν η τιμή μιας στήλης στον διακομιστή είναι null και η λειτουργία υποβολής της στήλης έχει οριστεί σε neverκαι η στήλη τροποποιηθεί με κάποια τιμή από τον χρήστη, αφού ο χρήστης αποθηκεύσει τη φόρμα, η τιμή της στήλης θα αντικατασταθεί με null.

Οι στήλες που δεν ενημερώνονται μετά την αρχική αποθήκευση της εγγραφής, όπως createdby, ορίζονται έτσι ώστε να μην υποβάλλονται κατά την αποθήκευση. Για να επιβάλετε την υποβολή μιας τιμής στήλης είτε έχει αλλάξει είτε όχι, χρησιμοποιήστε αυτήν τη μέθοδο με την mode παράμετρο ορισμένη σε always.

Σχετικά άρθρα

getSubmitMode (αναφορά API προγράμματος-πελάτη)