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:

  • Formulir

  • Daftar

  • Formulir (Tabel Anak)

Peristiwa Formulir

Peristiwa pada tampilan Formulir yang memicu skrip:

  • Setup

  • Sebelum Muat

  • Saat Muat

  • Refresh

  • Saat Muat (Setelah Render)

  • Validasi

  • Sebelum Simpan

  • Setelah Simpan

  • Sebelum Submit

  • Setelah Submit

  • Sebelum Batal

  • Setelah Batal

  • Refresh Timeline

  • Perubahan Field

Peristiwa Daftar

Peristiwa pada tampilan Daftar yang memicu skrip:

  • Saat Muat

  • Refresh

  • Sebelum Render

  • Aksi Utama

  • Format Field

Child DocType

Child DocType yang akan diterapkan skrip (jika berlaku).

Peristiwa Child DocType

Peristiwa pada Child DocType yang memicu skrip:

  • Form Render

  • Refresh

  • Sebelum Hapus

  • Setelah Hapus

  • Saat Tambah

  • Saat Pindah

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

  1. Arahkan ke Develop > UI Script.

  2. 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)'.

  3. Konfigurasi UI Script:

    • Sesuaikan kode JavaScript sesuai kebutuhan untuk memenuhi persyaratan spesifik DocType dan elemen UI.

  4. 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.

Discard
Save

On this page

Review Changes ← Back to Content
Message Status Space Raised By Last update on