Tambahkan field sendiri ke data master dan form transaksi — tanpa mengubah skema inti aplikasi. Custom field menyimpan informasi tambahan yang dibutuhkan bisnis Anda: kode HS, nomor kontrak, serial number peralatan, atau klasifikasi wilayah.
| Konsep | Deskripsi |
|---|---|
| Definisi | Blueprint sebuah field — nama, tipe data, di mana ia muncul, dan perilakunya |
| Placement | Form entitas mana yang menampilkan field ini (mis. Pihak, Barang, Faktur Penjualan) |
| Nilai | Data aktual yang diisi per record — tersimpan di dalam setiap entitas |
Nilai custom field tidak terpengaruh oleh perubahan atau penghapusan definisi. Menghapus definisi menghilangkan field dari form, namun tidak menghapus nilai yang sudah tersimpan.
Buka Administrasi → Custom Fields.
Halaman ini mengelompokkan field berdasarkan tipe entitas. Gunakan dropdown filter di bagian atas untuk menyaring daftar ke entitas tertentu.
| Field | Deskripsi |
|---|---|
| Nama | Label yang ditampilkan di form |
| Tipe Data | Jenis input yang ditampilkan (lihat di bawah) |
| Ukuran | Lebar field di grid form |
| Placement | Form entitas mana yang menampilkan field ini — satu field bisa mencakup beberapa entitas sekaligus |
| Urutan Tampil | Angka urutan di dalam placement-nya; angka lebih kecil tampil lebih awal |
| Deskripsi | Teks bantuan opsional yang ditampilkan di bawah input |
| Opsi List | Satu opsi per baris — hanya untuk tipe List (dropdown) |
Klik ikon pensil untuk edit, atau ikon tempat sampah untuk hapus. Menghapus definisi menghilangkan field dari semua form namun nilai yang sudah tersimpan tetap ada di database.
Gunakan tombol ↑ / ↓ pada setiap kartu untuk mengubah urutan tampil, atau atur Urutan Tampil langsung di dialog edit. Field dengan angka lebih kecil tampil lebih awal di form.
| Tipe | Input yang ditampilkan | Disimpan sebagai |
|---|---|---|
| Single Line | Text field (satu baris) | String |
| Paragraph | Text area (multi-baris) | String |
| Number | Field angka | Desimal |
| Date | Date picker | Tanggal |
| Yes / No | Checkbox | Boolean |
| List | Dropdown (pilihan tetap yang Anda definisikan) | String |
Mengatur lebar field di grid form.
| Ukuran | Mobile | Tablet | Desktop |
|---|---|---|---|
| Small | Penuh | 4 / 12 kolom | 3 / 12 kolom |
| Medium (default) | Penuh | 6 / 12 kolom | 4 / 12 kolom |
| Large | Penuh | Penuh | 8 / 12 kolom |
Satu definisi field bisa muncul di beberapa tipe entitas sekaligus. Placement yang tersedia:
Data Master — Pihak, Barang, Bagan Akun, Lokasi, Salesman, Kategori Pajak, Tarif Pajak, Konfigurasi PPh, Satuan, Kategori Barang, Level Harga, Proyek, Mata Uang, Bill of Materials
Header Transaksi — Faktur Penjualan, Nota Kredit, Faktur Pembelian, Nota Debit, Pesanan Penjualan, Pesanan Pembelian, Surat Jalan, Nota Penerimaan, Pembayaran, Penerimaan, Entri Jurnal, Contra Entry, Penyesuaian Persediaan, Transfer Persediaan, Manufaktur, Stock Opname
Baris Transaksi — Baris Faktur Penjualan, Baris Nota Kredit, Baris Faktur Pembelian, Baris Nota Debit, Baris Pesanan Penjualan, Baris Pesanan Pembelian, Baris Surat Jalan, Baris Nota Penerimaan, Baris Penyesuaian Persediaan, Baris Manufaktur, Baris Stock Opname
| Opsi | Deskripsi |
|---|---|
| Wajib diisi | Form tidak bisa disimpan tanpa mengisi field ini. Tidak bisa aktif bersamaan dengan Terkunci. |
| Tampilkan di dokumen cetak | Field dan nilainya muncul di PDF dan pratinjau cetak (jika template mendukungnya). |
| Tidak ikut saat duplikasi | Saat transaksi digandakan, nilai field ini tidak ikut disalin. Berguna untuk field seperti "Nomor PO" yang harus unik per dokumen. |
| Terkunci (tidak bisa diubah manual) | Pengguna tidak bisa mengetik di field ini. Nilai hanya bisa diset melalui Nilai Default (di bawah) atau API. Tidak bisa aktif bersamaan dengan Wajib diisi. |
| Nilai Default | Hanya muncul saat Terkunci aktif. Nilai yang otomatis diisi ke field untuk setiap record baru. Input menyesuaikan tipe — date picker untuk field Date, dropdown untuk field List, dll. |
| Auto-copy ke baris saat item ditambahkan | Hanya tersedia saat field ditempatkan di Barang dan tipe baris yang sesuai (mis. Barang + Baris Faktur Penjualan). Saat pengguna menambahkan item ke baris transaksi, nilai custom field dari item tersebut otomatis disalin ke field baris yang sesuai. Berguna untuk kode HS, grade kualitas, atau klasifikasi produk. |
| Aktif | Field yang tidak aktif disembunyikan dari semua form. Nilai yang tersimpan tetap ada. |
Custom field tampil di kartu Custom Fields di bagian bawah form data master dan header dokumen. Di dialog item baris, field tampil di samping field baris standar.
Field mengikuti flag Terkunci — field yang terkunci ditampilkan sebagai disabled (abu-abu) dan tidak bisa diedit langsung. Jika Nilai Default dikonfigurasi, field akan terisi otomatis saat record baru dibuat.
Saat Tampilkan di dokumen cetak diaktifkan, nama dan nilai field tersedia di template dokumen kustom melalui variabel document.custom_fields:
{% for cf in document.custom_fields %}
<tr>
<td>{{ cf.name }}</td>
<td>{{ cf.value }}</td>
</tr>
{% endfor %}
Untuk field tertentu berdasarkan nama:
{{ document.custom_fields["Kode HS"] }}
Hanya field dengan Tampilkan di dokumen cetak aktif dan nilai tidak kosong yang disertakan.
Saat membuat field baru, buka bagian Advanced untuk memasukkan GUID tertentu sebagai ID field. Ini berguna jika Anda sudah mengisi data custom field via API atau skrip impor menggunakan GUID yang diketahui, dan ingin mendaftarkan definisi yang cocok dengan data tersebut.
Biarkan kosong agar Basis membuat GUID secara otomatis.