Peristiwa dalam formulir dan kisi di aplikasi berbasis model

Peristiwa memulai semua kode sisi klien. Di aplikasi berbasis model, Anda mengaitkan fungsi tertentu di pustaka JavaScript (sumber daya web Skrip) yang akan dijalankan saat peristiwa terjadi. Fungsi ini disebut penanganan aktivitas. Setiap penanganan aktivitas menentukan satu fungsi dalam pustaka JavaScript dan parameter apa pun yang dapat diteruskan ke fungsi.

Anda dapat mengaitkan penanganan aktivitas hanya ke beberapa peristiwa menggunakan UI. Untuk peristiwa yang tidak tersedia untuk dikaitkan melalui UI, CLIENT API menyediakan metode yang dapat digunakan untuk melampirkan penanganan aktivitas ke peristiwa tersebut.

Menambahkan atau menghapus fungsi penanganan aktivitas ke peristiwa menggunakan UI

Warisan

Gunakan bagian Penanganan Aktivitas dari kotak dialog Properti Formulir untuk mengaitkan skrip Anda dengan peristiwa untuk formulir dan kolom.

Antarmuka Terpadu

Untuk menambahkan atau menghapus fungsi penanganan aktivitas ke peristiwa di Antarmuka Terpadu baru:

1. Membuka Power Apps.

2. Di panel navigasi kiri, pilih Data lalu pilih Tabel.

3. Dari daftar tabel, pilih tabel tempat Anda ingin menambahkan penanganan aktivitas.

4. Pilih tab Formulir dari bilah perintah lalu pilih formulir tempat Anda ingin menambahkan.

   

5. Pilih tab Peristiwa . Perhatikan penanganan aktivitas On Save dan On Load .

   

6. Jika Anda ingin menambahkan penanganan aktivitas untuk peristiwa perubahan, pilih kolom lalu pilih tab Peristiwa .

   

Formulir pengeditan massal

Secara default, penanganan peristiwa tidak dipanggil saat formulir berada dalam mode pengeditan massal.

Untuk mengaktifkan penanganan aktivitas dalam mode pengeditan massal, ubah XML Formulir dengan menemukan elemen yang relevan event dan membuat/mengatur BehaviorInBulkEditForm atribut ke Enabled. Saat ini, ini hanya didukung untuk peristiwa OnLoad.

Untuk informasi selengkapnya tentang kustomisasi XML Formulir, lihat Kapan harus mengedit file kustomisasi, Mengkustomisasi formulir, dan skema XML Formulir.

Untuk menentukan kapan penanganan aktivitas dipanggil pada formulir dalam metode penggunaan getFormType mode pengeditan massal.

Menambahkan atau menghapus fungsi penanganan aktivitas ke peristiwa menggunakan kode

Menggunakan metode berikut untuk menambahkan dan menghapus penanganan aktivitas untuk peristiwa yang tidak dapat dikaitkan melalui UI:

Events	Pengendali acara
Atribut OnChange	metode addOnChange dan removeOnChange
Formulir OnLoad	metode formContext.ui addOnLoad dan removeOnLoad
Formulir Dimuat	metode formContext.ui addLoaded dan removeLoaded
Data formulir OnLoad	metode formContext.data addOnLoad dan removeOnLoad
Formulir AktifSimpan	metode addOnSave dan removeOnSave
Kontrol pencarian PreSearch	metode addPreSearch dan removePreSearch
kbsearch control OnResultOpened	addOnResultOpened dan removeOnResultOpened methods
kbsearch control OnSelection	metode addOnSelection dan removeOnSelection
kbsearch control PostSearch	metode addOnPostSearch dan removeOnPostSearch

Penting

Konteks eksekusi secara otomatis diteruskan sebagai parameter pertama ke fungsi yang diatur menggunakan kode. Informasi selengkapnya: Konteks eksekusi API Klien

Alur peristiwa formulir

Anda dapat menentukan hingga 50 penanganan aktivitas untuk setiap peristiwa. Setiap penanganan aktivitas dijalankan dalam urutan yang ditampilkan di bagian Penanganan Aktivitas di tab Peristiwa pada kotak dialog Properti Formulir .

Gunakan metode setSharedVariable dan getSharedVariable untuk meneruskan variabel umum antara penanganan aktivitas (fungsi). Gunakan metode getDepth konteks eksekusi untuk mengetahui urutan bahwa penanganan aktivitas sedang dijalankan relatif terhadap penanganan aktivitas lainnya.

Artikel terkait

Memahami model objek Client API
Konteks eksekusi API Klien
Peristiwa (referensi API Klien)