Form Tours
TechMaju menyediakan cara yang mudah untuk menghasilkan tutorial formulir untuk doctype kompleks Anda dengan konfigurasi yang sangat sedikit.
Membuat Form Tour
Untuk membuat Form Tour, ketik "new form tour" di AwesomeBar dan tekan enter.
Masukkan Judul. Misalnya, 'Membuat Custom Field'
Pilih Reference DocType.
Tambahkan langkah-langkah yang mendefinisikan setiap field.
Simpan dokumen.
Tur untuk menjelaskan pembuatan Custom Fields
Opsi Konfigurasi
Form Tour
Is Standard: Untuk membuat Form Tour standar yang akan disimpan sebagai JSON. Hanya dapat diatur di instance Pengembangan.
Save on Completion: Jika dicentang, langkah terakhir dari Form Tour akan meminta pengguna untuk menyimpan dokumen.
Show First Document Tour: Jika Anda ingin menampilkan tur dari dokumen yang sudah ada, bukan dari formulir baru, aktifkan ini. Seperti namanya, ini memberikan tur dari dokumen pertama yang dibuat untuk DocType ini.
Include Name Field: Untuk beberapa doctype, nama diatur oleh pengguna. Dengan mengaktifkan ini, field nama menjadi langkah pertama dari tur.
Langkah-langkah Form Tour
Field: Sebuah field dari doctype yang dipilih. Ini akan disorot dengan Judul & Deskripsi.
Title & Description: Untuk menjelaskan field terkait penggunaannya, dampaknya, dan konfigurasi tersembunyi lainnya.
Position: Posisi popover yang menyoroti ditentukan oleh field ini. Ada beberapa opsi untuk dipilih tergantung pada posisi field yang disorot.
Next Condition: Sebuah field kode yang mengharapkan kondisi JS yang valid yang diterapkan pada dokumen. Misalnya, untuk Task DocType Tour, kita dapat memeriksa apakah prioritas tugas diatur sebelum melanjutkan ke kondisi berikutnya dengan mengatur kondisi berikutnya seperti ini:
eval: doc.priority != ""Is Table Field: Dicentang jika field yang akan disorot berada di bawah tabel child.
Parent Field: Field tabel dari doctype yang dipilih. Hanya terlihat jika Is Table Field dicentang. Memungkinkan pengguna untuk memilih field tabel child.
Memicu Tours
Setelah Anda selesai menjelaskan Form & field-nya, Anda sekarang siap untuk memicu tur dengan menggunakan Form API. Anda hanya perlu menginisialisasi tur dengan tour_name yang sesuai dan kemudian cukup mulai tur dengan frm.tour.start().
// Pada Load DocType
const tour_name = 'Nama Form Tour Anda';
frm.tour.init({ tour_name }).then(() => frm.tour.start());