Peristiwa dalam formulir dan kisi di aplikasi berbasis model

Peristiwa dalam formulir dan kisi memulai semua kode sisi klien di aplikasi berbasis model. Anda mengaitkan fungsi tertentu dalam 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 dengan menggunakan UI. Untuk peristiwa yang tidak dapat Anda kaitkan melalui UI, CLIENT API menyediakan metode yang dapat Anda gunakan untuk melampirkan penanganan aktivitas.

Menambahkan atau menghapus fungsi penanganan aktivitas dalam formulir dengan menggunakan UI

Untuk menambahkan atau menghapus fungsi penanganan aktivitas untuk 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 penanganan aktivitas.

    Cuplikan layar tab Formulir memperlihatkan daftar formulir untuk tabel di Power Apps.

  5. Pilih tab Peristiwa . Anda melihat penanganan aktivitas On Save dan On Load .

    Cuplikan layar tab Peristiwa memperlihatkan penanganan aktivitas formulir Saat Disimpan dan Aktif Dimuat.

  6. Untuk menambahkan penanganan aktivitas untuk peristiwa perubahan, pilih kolom lalu pilih tab Peristiwa .

    Cuplikan layar tab Peristiwa kolom memperlihatkan pengaturan Penanganan aktivitas Saat Perubahan.

Formulir pengeditan massal

Secara default, penanganan aktivitas tidak berjalan 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 atau mengatur BehaviorInBulkEditForm atribut ke Enabled. Saat ini, perilaku 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 berjalan pada formulir dalam mode pengeditan massal, gunakan getFormType metode .

Menambahkan atau menghapus fungsi penanganan aktivitas dengan menggunakan kode API Klien

Gunakan metode berikut untuk menambahkan dan menghapus penanganan aktivitas untuk peristiwa yang tidak dapat Anda kaitkan 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 Anda tetapkan dengan menggunakan kode . Untuk informasi selengkapnya, lihat Konteks eksekusi API Klien.

Alur peristiwa formulir

Anda dapat menentukan hingga 50 penanganan aktivitas untuk setiap peristiwa. Bagian Penanganan Aktivitas di tab Peristiwa dari kotak dialog Properti Formulir memperlihatkan urutan penanganan aktivitas, dan setiap penanganan aktivitas berjalan dalam urutan tersebut.

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

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

  • Terakhir diperbarui pada