Στήλες σε εφαρμογές βάσει μοντέλου (αναφορά API προγράμματος-πελάτη)

Οι στήλες περιέχουν δεδομένα στη φόρμα ή τα πλέγματα εφαρμογών βάσει μοντέλου. Χρησιμοποιήστε τη formContext.data.entity.attributes συλλογή ή τη formContext.getAttribute μέθοδο συντόμευσης για να αποκτήσετε πρόσβαση σε μια συλλογή στηλών. Για περισσότερες πληροφορίες σχετικά με τις συλλογές, ανατρέξτε στο θέμα Συλλογές (αναφορά API προγράμματος-πελάτη).

Για να αποκτήσετε πρόσβαση σε μια στήλη μέσα στη συλλογή, μεταβιβάστε είτε το όνομα (συμβολοσειρά) είτε την τιμή ευρετηρίου (αριθμός) της στήλης ως όρισμα στη μέθοδο . Για παράδειγμα: formContext.getAttribute(arg). Εάν δεν καθορίσετε ένα όρισμα, η μέθοδος επιστρέφει μια συλλογή όλων των χαρακτηριστικών στη φόρμα.

Οι στήλες ταξινομούνται κατά τύπο. Χρησιμοποιήστε τη μέθοδο getAttributeType για να προσδιορίσετε τον τύπο της στήλης. Ορισμένες μέθοδοι στηλών είναι διαθέσιμες μόνο για συγκεκριμένους τύπους στηλών.

Αυτό το άρθρο παρέχει πληροφορίες σχετικά με τις διαθέσιμες μεθόδους για κάθε τύπο στήλης.

Όλοι οι τύποι στηλών

Η ιδιότητα στοιχείων ελέγχου παρέχει μια συλλογή στοιχείων ελέγχου που σχετίζονται με τη στήλη.

Οι ακόλουθες μέθοδοι είναι διαθέσιμες για όλους τους τύπους στηλών:

Μέθοδος	Περιγραφή
addOnChange	Προσθέτει μια συνάρτηση για εκτέλεση όταν προκύπτει το συμβάν της OnChange στήλης.
fireOnChange	Ενεργοποιεί το συμβάν της στήλης OnChange .
getAttributeType	Επιστρέφει τον τύπο της στήλης.
getFormat	Επιστρέφει τη μορφή της στήλης.
getIsDirty	Επιστρέφει εάν η στήλη έχει μη αποθηκευμένες αλλαγές.
getName	Επιστρέφει το λογικό όνομα της στήλης.
getParent	Επιστρέφει το γονικό formContext.data.entity αντικείμενο.
getRequiredLevel	Επιστρέφει εάν μια τιμή στήλης απαιτείται ή συνιστάται.
getSubmitMode	Επιστρέφει όταν υποβάλλονται τα δεδομένα της στήλης κατά την αποθήκευση.
getUserPrivilege	Επιστρέφει τα δικαιώματα του χρήστη για τη δημιουργία, την ανάγνωση ή την ενημέρωση της τιμής της στήλης.
getValue	Επιστρέφει την τιμή δεδομένων της στήλης.
isValid	Επιστρέφει εάν η τιμή της στήλης είναι έγκυρη.
removeOnChange	Καταργεί μια συνάρτηση από τα στοιχεία χειρισμού συμβάντων της OnChange στήλης.
setIsValid	Ορίζει την εγκυρότητα της στήλης και ένα μήνυμα σφάλματος.
setRequiredLevel	Ορίζει εάν μια τιμή στήλης απαιτείται ή συνιστάται πριν από την αποθήκευση.
setSubmitMode	Ορίζει εάν τα δεδομένα της στήλης υποβάλλονται κατά την αποθήκευση.
setValue	Ορίζει την τιμή δεδομένων της στήλης.

Τύπος στήλης δυαδικής τιμής

Εκτός από τις διαθέσιμες μεθόδους για όλους τους τύπους στηλών, ο τύπος στήλης δυαδικής τιμής παρέχει την ακόλουθη μέθοδο:

Μέθοδος	Περιγραφή
getInitialValue	Επιστρέφει την τιμή της στήλης όταν ανοίγει η φόρμα.

Τύπος στήλης αναζήτησης

Εκτός από τις διαθέσιμες μεθόδους για όλους τους τύπους στηλών, ο τύπος στήλης αναζήτησης παρέχει την ακόλουθη μέθοδο:

Μέθοδος	Περιγραφή
getIsPartyList	Επιστρέφει εάν η αναζήτηση επιτρέπει πολλές εγγραφές ως αναζήτηση λίστας μερών.

Επιλογές και τύποι στηλών επιλογής

Εκτός από τις διαθέσιμες μεθόδους για όλους τους τύπους στηλών, οι τύποι στηλών επιλογών και επιλογών παρέχουν τις ακόλουθες μεθόδους:

Μέθοδος	Περιγραφή
getInitialValue	Επιστρέφει την τιμή της στήλης όταν ανοίγει η φόρμα.
λήψηεπιλογή	Επιστρέφει την επιλογή που αντιστοιχεί σε μια καθορισμένη ετικέτα ή τιμή.
getOptions	Επιστρέφει τις έγκυρες επιλογές της στήλης.
getSelectedOption	Επιστρέφει την επιλεγμένη επιλογή ή επιλογές.
getText	Επιστρέφει το κείμενο της ενεργοποιημένης επιλογής ή επιλογών.

Τύπος στήλης αριθμού (δεκαδικός, διπλός, ακέραιος, χρηματικός αριθμός)

Οι ακόλουθες μέθοδοι είναι διαθέσιμες μόνο για τις στήλες δεκαδικών, διπλών και ακέραιων :

Μέθοδος	Περιγραφή
getMax	Επιστρέφει τη μέγιστη επιτρεπόμενη τιμή της στήλης.
getMin	Επιστρέφει την ελάχιστη επιτρεπόμενη τιμή της στήλης.
λήψηprecision	Επιστρέφει τον αριθμό των ψηφίων που επιτρέπονται μετά την υποδιαστολή.
ορισμόςprecision	Ορίζει τον αριθμό των ψηφίων που επιτρέπονται μετά την υποδιαστολή.

Τύπος στήλης συμβολοσειράς

Εκτός από τις διαθέσιμες μεθόδους για όλους τους τύπους στηλών, όπως εξηγήθηκε προηγουμένως, η ακόλουθη μέθοδος είναι διαθέσιμη μόνο για τη στήλη συμβολοσειράς :

Μέθοδος	Περιγραφή
getMaxLength	Επιστρέφει το μέγιστο μήκος συμβολοσειράς της στήλης.

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

Κατανόηση του μοντέλου αντικειμένου Xrm
Στοιχεία ελέγχου (αναφορά API προγράμματος-πελάτη)