DocType
DocType adalah konsep inti yang mewakili struktur data dari database relasional di platform. Ini mendefinisikan bidang, perilaku, dan aturan untuk jenis dokumen atau catatan tertentu di dalam sistem.
Gambaran Umum
Tujuan: DocType digunakan untuk mendefinisikan struktur dan perilaku dokumen di TechMaju. Ini memungkinkan pengembang untuk membuat dan menyesuaikan berbagai form dan catatan, memungkinkan manajemen data yang dinamis.
Fungsi: DocType memungkinkan pengembang untuk:
Mendefinisikan bidang dan properti dokumen.
Mengatur perilaku dan aturan kustom untuk pemrosesan dokumen.
Mengorganisasikan data ke dalam catatan terstruktur yang dapat dikelola, dicari, dan dilaporkan.
Docstatus
Setiap DocType menggunakan konsep "Docstatus" untuk melacak status dokumen. Docstatus akan selalu memiliki salah satu dari tiga nilai berikut:
Draft (nilai: 0)
Submitted (nilai: 1)
Cancelled (nilai: 2)
Dokumen yang tidak dapat disubmit akan selalu tetap dalam status "draft". Dokumen yang dapat disubmit dapat pindah dari status draft ke "submitted", dan kemudian ke status "cancelled".
Dokumen dalam status submitted dan cancelled tidak dapat diedit, dengan satu pengecualian: untuk bidang tertentu kita dapat secara eksplisit mengizinkan pengeditan, bahkan saat dokumen dalam status submitted.
Docstatus disimpan sebagai nilai integer dalam setiap tabel Doctype di database.
Role yang Diperlukan
System Manager: Dapat membuat, menulis, dan menghapus DocTypes.
Buat Bidang DocType Baru
Bidang | Deskripsi |
|---|---|
DocType Name | Nama DocType. |
Application | Aplikasi tempat DocType ini berada. |
Is Submittable | Menunjukkan apakah dokumen dapat disubmit, membuatnya tidak dapat diubah kecuali untuk pembatalan dan amandemen. |
Is Child Table | Menunjukkan apakah DocType adalah tabel anak, ditampilkan sebagai grid dalam DocTypes lainnya. |
Is Single | Menunjukkan apakah DocType hanya memiliki satu catatan tanpa tabel terkait. |
Is Tree | Menunjukkan apakah DocType menggunakan set bersarang untuk struktur pohon. |
Is Virtual | Menunjukkan apakah DocType bersifat virtual, dengan data tidak disimpan di database. |
Prosedur
Arahkan ke Develop > DocType.
Membuat DocType Baru:
Klik '+ Add DocType'.
Isi bidang yang diperlukan seperti DocType Name dan Application.
Konfigurasi opsi tambahan seperti submittable, child table, single, tree, dan virtual sesuai kebutuhan.
Klik 'Create & Continue'.
Konfigurasi pengaturan doctype.
Sesuaikan form dengan menambahkan bagian dan bidang.
Simpan:
Setelah semua pengaturan dikonfigurasi, simpan DocType.
Praktik Terbaik
Konfigurasi DocType harus dilakukan di lingkungan Pengembangan sehingga perubahan dicapture di source control dan dapat dipromosikan dengan benar.
Hindari melakukan perubahan langsung pada DocTypes non-kustom seperti modul aplikasi TechMaju Core karena perubahan ini tidak dapat diterapkan ke lingkungan yang lebih tinggi. Sebaliknya, gunakan Customize Form dan Custom Fields.
Gunakan aturan penamaan yang bermakna karena nama DocType dapat bertentangan jika sama, jadi tambahkan prefiks apa pun untuk nama DocType yang merupakan nama umum dan mungkin bertentangan di masa mendatang.
Mengganti nama DocTypes dapat dilakukan tetapi sangat berisiko - terutama jika DocType sudah matang di mana banyak hubungan yang ada yang dapat berpotensi rusak.
Menghapus DocTypes dianggap berisiko tinggi, oleh karena itu, hanya dapat dilakukan oleh pengguna Administrator. Berhati-hatilah dan rencanakan apakah Anda ingin menghapus DocTypes karena dapat menyebabkan kesalahan jika sangat terkait dengan artefak lain.