Các sự kiện trong biểu mẫu và lưới trong ứng dụng dựa trên mô hình

Các sự kiện trong biểu mẫu và lưới khởi tạo tất cả mã phía máy khách trong các ứng dụng dựa trên mô hình. Bạn liên kết một hàm cụ thể trong thư viện JavaScript (Tài nguyên web tập lệnh) sẽ được thực thi khi xảy ra sự kiện. Hàm này được gọi là trình xử lý sự kiện. Mỗi bộ xử lý sự kiện chỉ định một hàm duy nhất trong một thư viện JavaScript và bất kỳ tham số nào có thể truyền cho hàm.

Bạn có thể liên kết trình xử lý sự kiện chỉ với một số sự kiện bằng cách sử dụng giao diện người dùng. Đối với các sự kiện mà bạn không thể liên kết thông qua giao diện người dùng, API Máy khách cung cấp các phương pháp mà bạn có thể sử dụng để đính kèm trình xử lý sự kiện.

Thêm hoặc loại bỏ các hàm của trình xử lý sự kiện trong biểu mẫu bằng cách sử dụng giao diện người dùng

Để thêm hoặc loại bỏ các hàm của trình xử lý sự kiện cho các sự kiện trong Giao diện Hợp nhất mới:

  1. Truy cập Power Apps.

  2. Trong ngăn dẫn hướng bên trái, chọn Dữ liệu , rồi chọn Bảng.

  3. Từ danh sách bảng, chọn bảng bạn muốn thêm bộ xử lý sự kiện.

  4. Chọn tab Biểu mẫu từ thanh lệnh, rồi chọn biểu mẫu bạn muốn thêm bộ xử lý sự kiện.

    Ảnh chụp màn hình tab Biểu mẫu hiển thị danh sách biểu mẫu cho bảng trong Power Apps.

  5. Chọn tab Sự kiện. Bạn sẽ thấy cả bộ xử lý sự kiệnKhi Lưu và Khi Tải.

    Ảnh chụp màn hình tab Sự kiện hiển thị bộ xử lý sự kiện biểu mẫu Khi Lưu và Khi Tải.

  6. Để thêm bộ xử lý sự kiện cho sự kiện thay đổi, hãy chọn cột đó, rồi chọn tab Sự kiện.

    Ảnh chụp màn hình tab Sự kiện cột hiển thị thiết đặt bộ xử lý sự kiện Khi Thay đổi.

Sửa hàng loạt biểu mẫu

Theo mặc định, trình xử lý sự kiện không chạy khi một biểu mẫu ở chế độ sửa hàng loạt.

Để bật trình xử lý sự kiện trong chế độ sửa hàng loạt, hãy sửa đổi XML event Biểu mẫu bằng cách tìm thành phần liên quan và tạo hoặc đặt thuộc BehaviorInBulkEditForm tính thành Enabled. Hiện tại, hành vi này chỉ được hỗ trợ cho các sự kiện OnLoad.

Để biết thêm thông tin về tùy chỉnh XML biểu mẫu, hãy xem mục Khi nào chỉnh sửa tệp tùy chỉnh, Tùy chỉnh biểu mẫu và sơ đồ XML Biểu mẫu.

Để xác định khi nào trình xử lý sự kiện chạy trên biểu mẫu ở chế độ sửa hàng loạt, hãy sử dụng phương getFormType pháp.

Thêm hoặc loại bỏ các chức năng của trình xử lý sự kiện bằng cách sử dụng mã API Máy khách

Sử dụng các phương pháp sau đây để thêm và loại bỏ trình xử lý sự kiện cho các sự kiện mà bạn không thể liên kết thông qua giao diện người dùng:

Sự kiện Trình xử lý sự kiện
Thuộc tính OnChange phương pháp addOnChangevà loại bỏOnChange
Tải Biểu mẫu phương pháp formContext.ui addOnLoad và removeOnLoad
Biểu mẫu đã Tải formContext.ui addLoaded và removeLoaded
Tải dữ liệu biểu mẫu phương pháp formContext.data addOnLoad và removeOnLoad
Lưu Biểu mẫu phương pháp addOnSavevà removeOnSave
Tìm kiếm Trước điều khiển tra cứu thêmPreSearch vàloại bỏ các phương phápPreSearch
điều khiển kbsearch OnResultOpened phương pháp addOnResultOpenedvà removeOnResultOpened
điều khiển tìm kiếm kb OnSelection phương pháp addOnSelectionvà removeOnSelection
kbsearch điều khiển PostSearch addOnPostSearch và loại bỏ các phương phápOnPostSearch

Quan trọng

Ngữ cảnh thực thi được tự động chuyển qua làm tham số đầu tiên cho các hàm mà bạn đặt bằng cách sử dụng mã. Để biết thêm thông tin, hãy xem Ngữ cảnh thực thi API máy khách.

Quy trình sự kiện biểu mẫu

Bạn có thể xác định tối đa 50 bộ xử lý sự kiện cho mỗi sự kiện. Phần Bộ xử lý Sự kiện trong tab Sự kiện của hộp thoại Thuộc tính Biểu mẫu hiển thị thứ tự của các bộ xử lý sự kiện và mỗi bộ xử lý sự kiện sẽ chạy theo thứ tự đó.

Sử dụng setSharedVariable vàgetSharedVariable để truyền biến số chung giữa các bộ xử lý sự kiện (hàm). Sử dụng phương pháp getDepth ngữ cảnh thực thi để hiểu trình tự thực thi trình xử lý sự kiện liên quan đến các bộ xử lý sự kiện khác.

Hiểu mô hình đối tượng API máy khách
Ngữ cảnh thực thi API máy khách
Sự kiện (Tài liệu tham khảo về API máy khách)