Mengonfigurasi penanganan aktivitas untuk sebuah formulir
Topik ini berlaku untuk Dynamics 365 Customer Engagement (on-premises). Untuk versi Power Apps dari topik ini, lihat: Mengonfigurasi penanganan aktivitas formulir aplikasi berdasarkan model
Penanganan aktivitas untuk formulir Dynamics 365 Customer Engagement (on-premises) dapat dikonfigurasi untuk area berikut di formulir:
| Elemen | Aktivitas | Deskripsi |
|---|---|---|
| Formulir | OnLoad |
Terjadi jika formulir dimuat. |
OnSave |
Terjadi jika data disimpan. | |
| Tab | TabStateChange |
Terjadi jika tab dibuka atau ditutup. |
| Bidang | OnChange |
Terjadi jika data pada bidang berubah dan kontrol kehilangan fokus. |
| IFRAME | OnReadyStateComplete |
Terjadi jika konten muatan IFRAME. |
Penanganan aktivitas terdiri dari referensi untuk sumber daya JavaScript dan fungsi yang ditetapkan dalam sumber daya web yang akan dijalankan bila aktivitas terjadi. Masing-masing elemen dapat memiliki hingga 50 penanganan aktivitas terpisah yang dikonfigurasi.
Penting
Mengkonfigurasi penanganan aktivitas yang salah dapat mengakibatkan kegagalan skrip serta dapat menyebabkan formulir gagal dimuat atau berfungsi dengan benar. Jika Anda bukan pengembang skrip, pastikan bahwa Anda memahami dengan benar tentang opsi konfigurasi skrip yang diperlukan.
Jangan konfigurasi penanganan aktivitas skrip menggunakan pustaka yang tidak berasal dari sumber yang Anda percaya. Skrip dapat digunakan untuk menjalankan tindakan apa pun yang dapat dijalankan pengguna dan skrip ditulis dengan buruk dapat secara signifikan merusak performa formulir.
Setelah Anda mengkonfigurasi penanganan aktivitas, selalu uji untuk memverifikasi penanganan aktivitas berfungsi dengan benar.
Untuk mengkonfigurasi penanganan aktivitas
Pada editor formulir, pilih elemen dengan aktivitas jika Anda ingin mengkonfigurasi penanganan.
Pada tab Beranda , di grup Edit , pilih Ubah Properti atau cukup klik dua kali elemen.
Dalam dialog properti elemen, pilih tab Peristiwa .
Perluas area Pustaka Formulir . Jika pustaka yang berisi fungsi yang ingin Anda atur sebagai penanganan aktivitas tidak lagi terdaftar, tambahkan pustaka.
Untuk menambahkan pustaka formulir untuk penanganan aktivitas:
Di bagian Pustaka Formulir dari Daftar Peristiwa, pilih Tambahkan.
Cari sumber daya web JavaScript dalam daftar sumber daya web yang tersedia. Pilih lalu pilih Tambahkan.
Jika sumber daya web JavaScript yang Anda perlukan tidak ada, pilih Baru untuk membuka formulir sumber daya web baru dan membuatnya.
Untuk membuat sumber daya web JavaScript:
Di formulir sumber daya web atur properti berikut:
Properti Nilai Nama Wajib. Ketik nama sumber daya web. Nama Tampilan Wajib. Ketik nama yang akan ditampilkan di daftar sumber daya web. Deskripsi Opsional. Ketik deskripsi sumber daya web. Jenis Wajib. Pilih Skrip (JScript). Bahasa Opsional. Pilih salah satu bahasa yang tersedia untuk organisasi Anda. Jika Anda telah diberikan skrip, kami sangat menyarankan Anda menggunakan tombol Telusuri untuk menemukan file dan mengunggahnya.
Atau, Anda dapat memilih tombol Editor Teks dan menempelkan atau mengetikkan konten skrip di dialog Edit Konten .
Catatan
Karena editor teks sederhana tidak menyediakan fitur untuk memeriksa kebenaran skrip, secara umum Anda harus selalu mencoba untuk menggunakan aplikasi terpisah seperti Visual Studio untuk mengedit skrip dan mengunggahnya.
Pilih Simpan dan tutup dialog sumber daya web.
Sumber daya web yang Anda buat sekarang dipilih dalam dialog Cari Rekaman . Pilih Tambahkan untuk menutup dialog.
Di bagian Penanganan Peristiwa , pilih peristiwa yang ingin Anda atur penanganan aktivitasnya.
Pilih Tambahkan untuk membuka dialog Properti Pengendali.
Pada tab Detail, pilih pustaka yang sesuai dan ketik nama fungsi yang harus dijalankan untuk peristiwa tersebut.
Penanganan aktivitas diaktifkan secara default. Kosongkan kotak centang Diaktifkan jika Anda tidak ingin mengaktifkan peristiwa ini.
Beberapa fungsi memerlukan konteks eksekusi untuk diteruskan ke fungsi. Pilih Lulus konteks eksekusi sebagai parameter pertama jika diperlukan.
Beberapa fungsi dapat menerima rangkaian parameter untuk mengontrol perilaku fungsi. Jika ini diperlukan, masukkan ke dalam daftar parameter yang dipisahkan koma yang akan diteruskan ke fungsi.
Pada tab Dependensi , tambahkan bidang apa pun yang bergantung pada skrip ke area Bidang Dependen.
Pilih OK untuk menutup dialog Properti Handler.
Jika penanganan aktivitas dimasukkan, maka Anda dapat mengatur urutan fungsi yang akan dieksekusi, terkait pada fungsi lain dengan menggunakan panah hijau untuk menaikkan atau menurunkan.
Pilih OK untuk menutup dialog properti elemen.
Pilih Simpan untuk menerapkan perubahan. Pilih Terbitkan untuk menerbitkan formulir.
Catatan
Sementara user interface (UI) memungkinkan Anda untuk mengatur urutan bagaimana skrip dimuat dengan menggunakan panah hijau naik dan turun, skrip sebenarnya tidak dimuat secara berurutan.