Συμβάντα σε φόρμες και πλέγματα σε εφαρμογές βάσει μοντέλου

Συμβάντα σε φόρμες και πλέγματα εκκινούν όλο τον κώδικα από την πλευρά του προγράμματος-πελάτη σε εφαρμογές βάσει μοντέλου. Συσχετίζετε μια συγκεκριμένη συνάρτηση σε μια βιβλιοθήκη JavaScript (πόρος Web δέσμης ενεργειών) που θα εκτελεστεί όταν προκύπτει ένα συμβάν. Αυτή η συνάρτηση ονομάζεται χειρισμός συμβάντων. Κάθε χειρισμός συμβάντων καθορίζει μια μοναδική συνάρτηση μέσα σε μια βιβλιοθήκη JavaScript και τυχόν παραμέτρους που μπορούν να διαβιβαστούν στη συνάρτηση.

Μπορείτε να συσχετίσετε χειρισμούς συμβάντων μόνο σε ορισμένα συμβάντα χρησιμοποιώντας το περιβάλλον εργασίας χρήστη. Για συμβάντα που δεν μπορείτε να συσχετίσετε μέσω του περιβάλλοντος εργασίας χρήστη, το API προγράμματος-πελάτη παρέχει μεθόδους που μπορείτε να χρησιμοποιήσετε για να επισυνάψετε χειρισμούς συμβάντων.

Προσθήκη ή κατάργηση συναρτήσεων προγράμματος χειρισμού συμβάντων σε φόρμες με χρήση του περιβάλλοντος εργασίας χρήστη

Για να προσθέσετε ή να καταργήσετε συναρτήσεις προγράμματος χειρισμού συμβάντων για συμβάντα στη νέα Ενοποιημένη διασύνδεση:

  1. Μετάβαση σε Power Apps.

  2. Στο αριστερό παράθυρο περιήγησης, επιλέξτε Δεδομένα και, στη συνέχεια, επιλέξτε Πίνακες.

  3. Από τη λίστα πινάκων, επιλέξτε τον πίνακα στον οποίο θέλετε να προσθέσετε τα στοιχεία χειρισμού συμβάντων.

  4. Επιλέξτε την καρτέλα Φόρμες από τη γραμμή εντολών και, στη συνέχεια, επιλέξτε τη φόρμα όπου θέλετε να προσθέσετε το πρόγραμμα χειρισμού συμβάντων.

    Στιγμιότυπο οθόνης της καρτέλας Φόρμες που εμφανίζει τη λίστα φορμών για έναν πίνακα σε Power Apps.

  5. Επιλέξτε την καρτέλα Συμβάντα . Βλέπετε αμφότερα τα στοιχεία χειρισμού συμβάντων "Ενεργοποίηση αποθήκευσης" και " Κατά τη φόρτωση ".

    Στιγμιότυπο οθόνης της καρτέλας Συμβάντα που εμφανίζει τα προγράμματα χειρισμού συμβάντων

  6. Για να προσθέσετε ένα πρόγραμμα χειρισμού συμβάντων για το συμβάν αλλαγής, επιλέξτε τη στήλη και, στη συνέχεια, επιλέξτε την καρτέλα Συμβάν .

    Στιγμιότυπο οθόνης της καρτέλας Συμβάντα στήλης που εμφανίζει τις ρυθμίσεις προγράμματος χειρισμού συμβάντων

Φόρμες μαζικής επεξεργασίας

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

Για να ενεργοποιήσετε ένα πρόγραμμα χειρισμού συμβάντων σε λειτουργία μαζικής επεξεργασίας, τροποποιήστε το XML φόρμας, βρίσκοντας το σχετικό event στοιχείο και δημιουργώντας ή ορίζοντας το BehaviorInBulkEditForm χαρακτηριστικό σε Enabled. Προς το παρόν, αυτή η συμπεριφορά υποστηρίζεται μόνο για συμβάντα OnLoad.

Για περισσότερες πληροφορίες σχετικά με την προσαρμογή XML φόρμας, ανατρέξτε στο θέμα Πότε μπορείτε να επεξεργαστείτε το αρχείο προσαρμογών, Προσαρμογή φορμών και το σχήμα XML φόρμας.

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

Προσθήκη ή κατάργηση συναρτήσεων προγράμματος χειρισμού συμβάντων με χρήση κώδικα API προγράμματος-πελάτη

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

Εκδηλώσεις Χειρισμός συμβάντων
Χαρακτηριστικό OnChange addOnChange και καταργήστε τις μεθόδουςOnChange
OnLoad φόρμας formContext.ui addOnLoad και removeOnLoad μέθοδοι
Φόρτωση φόρμας formContext.ui addLoaded και removeLoaded methods
OnLoad δεδομένων φόρμας formContext.data addOnLoad και removeOnLoad μέθοδοι
Αποθήκευση φόρμας addOnSave και removeOnSave methods
Προεπιλογή στοιχείου ελέγχου αναζήτησης addPreSearch και removePreSearch methods
Στοιχείο ελέγχου kbsearch OnResultOpened addOnResultOpened και removeOnResultOpened methods
Στοιχείο ελέγχου kbsearch OnSelection addOnSelection και removeOnSelection methods
στοιχείο ελέγχου kbsearch PostSearch addOnPostSearch και καταργήστε τις μεθόδουςOnPostSearch

Σημαντικό

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

Διοχέτευση συμβάντων φόρμας

Μπορείτε να ορίσετε έως και 50 χειρισμούς συμβάντων για κάθε συμβάν. Η ενότητα Χειρισμός συμβάντων στην καρτέλα Συμβάντα του παραθύρου διαλόγου Ιδιότητες φόρμας εμφανίζει τη σειρά των χειρισμού συμβάντων και κάθε χειρισμός συμβάντων εκτελείται με αυτή τη σειρά.

Χρησιμοποιήστε τις μεθόδους setSharedVariable και getSharedVariable για να διαβιβάσετε μια κοινή μεταβλητή μεταξύ των προγραμμάτων χειρισμού συμβάντων (συναρτήσεις). Χρησιμοποιήστε τη μέθοδο getDepth περιβάλλοντος εκτέλεσης για να κατανοήσετε τη ακολουθία εκτέλεσης προγράμματος χειρισμού συμβάντων σε σχέση με άλλους χειρισμούς συμβάντων.

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

  • Τελευταία ενημέρωση στις