Region (Indonesia)

Region (Indonesia) digunakan untuk memilih wilayah administratif Indonesia secara bertingkat: provinsi, kabupaten/kota, kecamatan, lalu desa/kelurahan. Cocok untuk wilayah alamat perusahaan, lokasi proyek, atau domisili. Setiap tingkat menyimpan kode wilayah dan namanya.

Mapping ke Engine

Keterangan isi nilai:

• Key tingkat: province, regency, district, dan village. Tingkat yang tidak ditampilkan tidak ada di objek.
• Kode ditulis tanpa titik, misalnya 35 untuk provinsi dan 3578 untuk kabupaten/kota.
• Tingkat di bawah provinsi juga menyimpan kode induknya, misalnya province_code.

Properties

• Name: Nama komponen. Mendukung dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Digenerate otomatis dan dapat disesuaikan.
• Levels shown: Tingkat terakhir yang dapat dipilih. Provinsi selalu tampil.
  • To city: provinsi dan kabupaten/kota.
  • To district: sampai kecamatan.
  • To village: sampai desa/kelurahan. Ini pilihan default.
• Data source: Sumber data wilayah. Saat ini hanya Built-in dataset yang dapat dipilih. Master data dan External API tampil dengan keterangan "Not available yet".
• Default province: Provinsi yang otomatis terpilih saat form dibuka, atau None. Disimpan sebagai kode provinsi, misalnya 35.
• Disabled: Menonaktifkan komponen sehingga nilainya hanya bisa dibaca dan tidak dapat diisi.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation: Bila properti berikut diisi, form hanya dapat disubmit ketika kondisinya terpenuhi; jika tidak, muncul pesan validasi.
  • Required: Semua tingkat yang ditampilkan wajib diisi.
  • Required If: Komponen wajib diisi hanya bila ekspresi FEEL terpenuhi (validasi bersyarat).

Perilaku saat diisi

• Setiap tingkat adalah dropdown yang bisa dicari berdasarkan nama atau kode.
• Tingkat bawah nonaktif sampai induknya dipilih, dengan teks seperti "Pick province first" atau "Pick district first".
• Mengganti pilihan induk mengosongkan semua tingkat di bawahnya.
• Opsi "None / Tidak memilih" mengosongkan tingkat tersebut.
• Bila wajib, tingkat kosong pertama ditandai dengan pesan "Pick a province", "Pick a regency / city", "Pick a district", atau "Pick a village".
• Daftar provinsi tersedia di aplikasi. Daftar kabupaten/kota, kecamatan, dan desa/kelurahan dimuat dari layanan publik emsifa.com saat tingkat induknya dipilih. Bila layanan itu tidak dapat diakses, daftar tingkat tersebut kosong.
• Di bawah komponen tampil sumber data, misalnya "Source: Built-in dataset".