UI Script
DocType UI Script di TechMaju memungkinkan pengembang untuk membuat dan mengelola skrip JavaScript kustom yang dapat diterapkan pada formulir, daftar, dan tabel anak untuk memperluas dan meningkatkan fungsionalitas aplikasi TechMaju. Skrip ini memungkinkan sistem untuk mengeksekusi JavaScript di klien (browser web) saat peristiwa berbasis klien terjadi.
Memahami DocType UI Script
Tujuan: DocType UI Script dirancang untuk memungkinkan kustomisasi antarmuka pengguna di dalam platform TechMaju. Ini memungkinkan pengembang menjalankan JavaScript di klien (browser web) sebagai respons terhadap peristiwa berbasis klien, dengan demikian secara dinamis memanipulasi formulir, daftar, dan tabel anak.
Fungsi: DocType ini menyediakan tempat terpusat untuk mengelola kode JavaScript yang dapat dijalankan dalam konteks berbagai elemen UI. UI Script dapat diterapkan pada formulir, daftar, atau tabel anak, memungkinkan berbagai macam perilaku dan interaksi kustom berdasarkan peristiwa sisi klien. Ini termasuk:
Menetapkan nilai di satu field berdasarkan nilai di field lain
Memodifikasi opsi dalam daftar pilihan berdasarkan peran pengguna
Menampilkan pesan berdasarkan nilai di sebuah field
Peran yang Diperlukan
TM Core Developer: Dapat membuat, menulis, dan menghapus UI Script.
Field UI Script
Field | Deskripsi |
|---|---|
Nama | Nama UI Script. |
DocType | DocType yang akan diterapkan skrip. |
Aplikasi | Aplikasi tempat skrip akan digunakan. |
Aktif | Sebuah checkbox untuk mengaktifkan atau menonaktifkan skrip. |
Diterapkan Pada | Elemen UI yang akan diterapkan skrip:
|
Peristiwa Formulir | Peristiwa pada tampilan Formulir yang memicu skrip:
|
Peristiwa Daftar | Peristiwa pada tampilan Daftar yang memicu skrip:
|
Child DocType | Child DocType yang akan diterapkan skrip (jika berlaku). |
Peristiwa Child DocType | Peristiwa pada Child DocType yang memicu skrip:
|
Script (JavaScript) | Kode JavaScript yang akan dijalankan. |
Peristiwa Formulir
Peristiwa Formulir | Deskripsi |
|---|---|
Setup | Dipicu sekali ketika formulir pertama kali dibuat. |
Sebelum Muat | Dipicu sebelum formulir dimuat. |
Saat Muat | Dipicu saat formulir dimuat dan akan dirender. |
Refresh | Dipicu saat formulir dimuat dan dirender. |
Saat Muat (Setelah Render) | Dipicu setelah formulir dimuat dan dirender. |
Validasi | Dipicu sebelum sebelum_simpan. |
Sebelum Simpan | Dipicu sebelum simpan dipanggil. |
Setelah Simpan | Dipicu setelah formulir disimpan. |
Sebelum Submit | Dipicu sebelum submit dipanggil. |
Setelah Submit | Dipicu setelah formulir disubmit. |
Sebelum Batal | Dipicu sebelum pembatalan dipanggil. |
Setelah Batal | Dipicu setelah formulir dibatalkan. |
Refresh Timeline | Dipicu setelah timeline formulir dirender. |
Perubahan Field | Dipicu saat nilai fieldname diubah. |
Peristiwa Daftar
Peristiwa Daftar | Deskripsi |
|---|---|
Saat Muat | Dipicu saat daftar dimuat dan akan dirender. |
Refresh | Dipicu saat daftar direfresh. |
Sebelum Render | Dipicu sebelum daftar dirender. |
Aksi Utama | Dipicu saat tombol aksi utama di daftar diklik. |
Format Field | Dipicu saat field di daftar diformat. |
Peristiwa Child DocType
Peristiwa Child DocType | Deskripsi |
|---|---|
Form Render | Dipicu saat baris dibuka sebagai formulir di field Tabel. |
Refresh | Dipicu saat tabel anak direfresh. |
Sebelum Hapus | Dipicu sebelum baris dihapus dari tabel anak. |
Setelah Hapus | Dipicu setelah baris dihapus dari tabel anak. |
Saat Tambah | Dipicu saat baris baru ditambahkan ke tabel anak. |
Saat Pindah | Dipicu saat baris dipindahkan di dalam tabel anak. |
Prosedur
Arahkan ke Develop > UI Script.
Menambahkan UI Script Baru:
Klik '+ Tambah UI Script' untuk membuka formulir pembuatan.
Isi field yang diperlukan: Nama, DocType, Aplikasi, dan Skrip (JavaScript).
Pilih nilai yang sesuai untuk 'Diterapkan Pada' (Formulir, Daftar, atau Tabel Anak).
Untuk 'Formulir' dan 'Daftar', pilih peristiwa terkait yang akan memicu skrip.
Untuk 'Tabel Anak', pilih Child DocType dan peristiwa yang akan memicu skrip.
Masukkan kode JavaScript di field 'Skrip (JavaScript)'.
Konfigurasi UI Script:
Sesuaikan kode JavaScript sesuai kebutuhan untuk memenuhi persyaratan spesifik DocType dan elemen UI.
Menyimpan dan Melihat UI Script:
Klik 'Terapkan' untuk menyimpan UI Script.
Skrip akan dijalankan dalam konteks yang ditentukan (Formulir, Daftar, atau Tabel Anak) kapan pun elemen UI terkait dimuat atau peristiwa yang ditentukan terjadi.
Praktik Terbaik
Uji kode JavaScript di lingkungan pengembangan sebelum menerapkannya ke produksi.
Jaga agar skrip tetap modular dan dapat digunakan kembali untuk menjaga kode tetap bersih dan mudah dikelola.
Secara berkala memperbarui dan meninjau skrip untuk memastikan kompatibilitas dengan versi baru platform TechMaju.
Dokumentasikan tujuan dan fungsi setiap skrip dalam kode untuk membantu pemeliharaan di masa mendatang.