Framework Frappe: Menetapkan Aturan Penamaan dan Menciptakan Record di Frappe
- Author: Rio Pramana
- Editor: Ana Widiyawati
- March 8, 2024
Dalam dunia basis data dan manajemen aplikasi, penamaan record adalah aspek kritis yang menentukan kejelasan, penelusuran, dan integritas data. Di episode ini, kita akan mempelajari berbagai metode penamaan yang tersedia di Frappe dan bagaimana menerapkannya pada DocType yang telah kita buat di aplikasi Ride Management. Kemudian, kita akan beranjak ke pembuatan record untuk masing-masing DocType, sebuah proses penting yang menghidupkan struktur data kita.
Penamaan di Frappe
Di Frappe, setiap record/data dari doctype memiliki unique id/primary key-nya masing-masing yang disimpan pada kolom name di database, yang diatur menggunakan naming. Frappe menyediakan berbagai opsi untuk menetapkan aturan penamaan atau naming pada record yang Anda buat. Opsi ini memungkinkan developer dan pengguna sistem untuk mengidentifikasi record dengan mudah dan memastikan bahwa data yang dihasilkan konsisten dan dapat diindeks dengan baik. Berikut adalah opsi penamaan yang bisa digunakan:
- Set by User: Memungkinkan pengguna untuk secara manual menentukan nama record.
- Autoincrement: Membuat sistem penomoran yang otomatis bertambah.
- By Fieldname: Menggunakan nilai dari field tertentu dalam DocType sebagai nama record.
- By “Naming Series” Field: Menggunakan seri penamaan yang telah ditentukan dan dikonfigurasi dalam sistem.
- Expression: Memungkinkan penamaan berdasarkan ekspresi yang ditentukan, sering kali menggabungkan nilai dari beberapa field.
- Random: Menghasilkan nama record secara acak. Metode ini merupakan metode default jika Anda tidak menentukan aturan penamaan apapun.
- By Script: Memanfaatkan custom script untuk menghasilkan nama.
Mengimplementasikan Aturan Penamaan
Untuk memberi aturan penamaan, kita dapat melihat bagian Naming pada Settings doctype kita.
Pemilihan Metode Penamaan:
Tentukan metode penamaan yang paling sesuai dengan kebutuhan data aplikasi Anda. Misalnya, untuk DocType ‘Vehicle’, kita mungkin memilih By "Naming Series" Field atau Expression untuk memberikan identifikasi yang konsisten dan mudah dikenali.
Konfigurasi Naming Series:
Jika menggunakan Naming Series, atur format penamaan di DocType tersebut, seperti “VEH-.YYYY.-.#####”, yang mencerminkan jenis kendaraan, tahun, dan nomor urut.
Ekspresi Penamaan:
Anda juga dapat menggunakan format penamaan Expression seperti pada gambar diatas yang menggambarkan jenis model mobil, tahun, dan nomor urut dari setiap Vehicle yang akan kita buat. Untuk metode Expression, buat formula yang menggabungkan field-field tertentu, seperti “{field_1}-{field_2}-{field_3}”, yang memberikan fleksibilitas dalam menentukan struktur nama.
Setelah menentukan aturan penamaan, setiap record yang Anda buat akan memiliki primary key secara otomatis mengikuti aturan tersebut.
Menciptakan Record
Untuk membuat record, Anda dapat langsung mencari List dari doctype yang Anda inginkan. Untuk membuat record Vehicle Type, cukup cari “Vehicle Type List” pada search bar, kemudian tekan tombol “Add Vehicle Type”.
Pembuatan Record untuk ‘Vehicle Type’:
Dengan aturan penamaan yang telah ditetapkan, mulailah membuat record untuk ‘Vehicle Type’. Masukkan tipe kendaraan seperti ‘Sedan’, ‘SUV’, atau ‘Sport’, yang akan menjadi kategori untuk DocType Vehicle kita. Setelah itu, klik tombol “Save” untuk menyimpan record tersebut pada database dan dapat kita lihat pada List View dari doctype ini.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.
Lanjutkan dengan mengisi detail-detail seperti model kendaraan, tahun kendaraan, dan tipe kendaraan dari dropdown yang telah dihubungkan ke Vehicle Type yang kita buat. Dapat dilihat bahwa kita sekarang sudah dapat memilih record dari Vehicle Type yang ada sebagai nilai dari field type dari Vehicle.
Untuk Driver, masukkan informasi seperti nama pengemudi, lisensi, dan informasi kontak.
Praktik Terbaik dalam Penamaan
- Konsistensi: Pastikan aturan penamaan yang Anda pilih konsisten di seluruh aplikasi untuk memudahkan pemeliharaan dan pengembangan.
- Kejelasan: Pilih aturan penamaan yang membuat identitas record jelas bagi pengguna.
- Skalabilitas: Pertimbangkan bagaimana aturan penamaan Anda akan berskala seiring waktu dan peningkatan jumlah record.
Kesimpulan
Penerapan aturan penamaan yang tepat akan menambah nilai yang signifikan ke dalam aplikasi Ride Management. Ini tidak hanya memudahkan pengguna untuk mengidentifikasi dan berinteraksi dengan data tetapi juga memungkinkan sistem untuk mengelola dan mengindeks informasi dengan lebih efisien.