BAB 3: Pilihan yang Dijaga: Domain Nilai dan Aturan Isian

#Studi kasus: "Satu kondisi, empat ejaan"

Kepala Seksi minta rekap jumlah pohon sehat. Anda mengelompokkan data survei berdasarkan kolom Kondisi, dan muncul tujuh baris, bukan tiga. Ada Sehat, sehat, dan Sehat (dengan spasi di ujung). Ada Terserang Hama dan Terserang hama. Dua baris lagi kosong.

Komputer menganggap semua ejaan itu berbeda. Rekap yang seharusnya selesai lima menit menjadi dua jam pembersihan. Bab ini mencegahnya sejak data dimasukkan.

#Konsep: domain dalam tiga kalimat

Domain adalah daftar nilai yang sah untuk satu kolom, seperti kotak pilihan di formulir kertas: surveyor tinggal mencentang, tidak mengetik bebas. Ada tiga bentuk umum: daftar (misalnya tiga kondisi pohon), rentang (tinggi pohon 0 sampai 60 m), dan pola teks. Domain mencegah salah ketik, tetapi tidak selalu menjadi gembok, dan di bab ini Anda akan melihat bedanya.

Istilah baru bagian ini:

• Domain: daftar atau rentang nilai sah untuk satu kolom.
• Value Map: pilihan tetap yang dibuat langsung di QGIS.
• Value Relation: pilihan yang diambil dari sebuah tabel acuan.
• Aturan isian (constraint): syarat sebuah isian, misalnya tidak boleh kosong.
• Nilai bawaan: isian yang terisi otomatis, misalnya tanggal hari ini.

#Tiga lapis penjagaan

Banyak orang mengira satu pengaturan sudah cukup. Hasil uji saya menunjukkan ada tiga lapis, dengan kekuatan berbeda. [terbukti: diuji di QGIS 4.0.2 dan GDAL 3.12]

Jadi untuk survei lapangan yang melibatkan banyak orang, pakai lapis pertama dan kedua agar formulir ramah. Bila datanya penting sekali, tambahkan lapis ketiga.

#Memilih jenis pilihan

• Pakai Value Map untuk daftar pendek yang jarang berubah, seperti Kondisi.
• Pakai Value Relation bila daftarnya bisa bertambah, seperti jenis pohon. Anda cukup menambah baris di tabel Ref_Jenis, tanpa mengutak-atik formulir.
• Pakai Range untuk angka, seperti tinggi pohon 0 sampai 60 m.

#Aturan isian dan nilai bawaan

Aturan isian punya dua kekuatan. Yang tegas menolak penyimpanan. Yang lunak hanya memberi peringatan. Dalam skrip I3.4, saya memakai tegas untuk hal yang pasti salah, dan lunak untuk hal yang masih mungkin terjadi.

Nilai bawaan menghemat waktu dan mengurangi salah ketik:

Angka 5 m pada Akurasi_m adalah contoh. Tetapkan batas Anda sendiri dari uji titik referensi di Bab 1.

Domain di berkas: ['Kondisi_Pohon', 'Tinggi_Pohon']
Widget Kondisi    : ValueMap
Widget Tinggi_Phn : Range
Nilai 'ngawur' dan tinggi 250 m: tertulis tanpa ditolak

# Inti skrip I3.4 (berkas lengkap: skrip/i3_04_formulir_widget.py)
widget("Kondisi", "ValueMap", {"map": [{p: p} for p in pilihan]})
widget("Jenis", "ValueRelation", {"Layer": ref_jenis.id(), "LayerName": "Ref_Jenis", "LayerSource": ref_jenis.source(),
                                  "LayerProviderName": "ogr", "Key": "Jenis", "Value": "Jenis", "AllowNull": False})
widget("Tinggi_Phn", "Range", {"Min": 0.0, "Max": 60.0, "Step": 0.1, "Style": "SpinBox", "Precision": 1, "AllowNull": False})
lyr.setConstraintExpression(idx("Tinggi_Phn"), '"Tinggi_Phn" BETWEEN 0 AND 60', "Tinggi pohon harus 0 sampai 60 m")
lyr.setFieldConstraint(idx("Tinggi_Phn"), QgsFieldConstraints.ConstraintExpression, QgsFieldConstraints.ConstraintStrengthHard)
lyr.setDefaultValueDefinition(idx("Tgl_Survei"), QgsDefaultValue("to_date(now())"))
lyr.saveStyleToDatabaseV2("Formulir_Survei", "Formulir survei pohon", True, "")

'SV-' || lpad(to_string(coalesce(maximum(to_int(substr("ID_Survei", 4))), 0) + 1), 3, '0')

Simpan gaya ke GeoPackage: SaveStyleResult.Success
Gaya bawaan terbaca: True
Fitur salah : ['Kondisi: value is NULL', 'Tinggi_Phn: Tinggi pohon harus 0 sampai 60 m check failed',
               'Akurasi_m: Akurasi lebih dari 5 m: ulangi pengukuran bila bisa check failed']
Fitur benar : []
Tabel acuan ditemukan: Ref_Jenis
Nilai bawaan -> ID_Survei: SV-001 | Tgl_Survei: tanggal hari uji | Surveyor: nama akun

CREATE TRIGGER cek_kondisi_tambah BEFORE INSERT ON Titik_Survei
WHEN NEW.Kondisi IS NULL OR NEW.Kondisi NOT IN ('Sehat','Terserang Hama','Tebangan Liar')
BEGIN SELECT RAISE(ABORT, 'Kondisi harus salah satu dari tiga pilihan baku'); END;

Kondisi 'sehat' -> DITOLAK: Kondisi harus salah satu dari tiga pilihan baku
Kondisi 'Sehat' -> DITERIMA

# [CEK] Cocokkan dengan versi Anda. Nama alat dari dokumentasi ArcGIS Pro.
import arcpy
gdb = r"D:/KPH_Contoh/Survei.gdb"
arcpy.management.CreateDomain(gdb, "Kondisi_Pohon", "Kondisi pohon", "TEXT", "CODED")
for nilai in ["Sehat", "Terserang Hama", "Tebangan Liar"]:
    arcpy.management.AddCodedValueToDomain(gdb, "Kondisi_Pohon", nilai, nilai)
arcpy.management.CreateDomain(gdb, "Tinggi_Pohon", "Tinggi 0 sampai 60 m", "DOUBLE", "RANGE")
arcpy.management.SetValueForRangeDomain(gdb, "Tinggi_Pohon", 0, 60)
arcpy.management.AssignDomainToField(gdb + "/Titik_Survei", "Kondisi", "Kondisi_Pohon")
arcpy.management.AssignDomainToField(gdb + "/Titik_Survei", "Tinggi_Phn", "Tinggi_Pohon")

#Cek paham

1. Mengapa Value Relation lebih baik daripada Value Map untuk daftar jenis pohon?
2. Apa beda aturan isian tegas dan lunak?
3. Mengapa domain di GeoPackage belum menjamin tidak ada nilai salah?

Jawaban:

1. Daftar jenis bisa bertambah. Dengan Value Relation, Anda cukup menambah baris di tabel acuan. Dengan Value Map, Anda harus mengubah pengaturan formulir.
2. Tegas menolak penyimpanan. Lunak hanya memberi peringatan, sehingga data tetap bisa disimpan.
3. Domain bekerja di formulir. Penulisan langsung lewat program tidak melewati formulir, sehingga nilai di luar daftar tetap bisa tertulis. Untuk jaminan kuat, perlu pagar di berkas atau pemeriksaan data berkala.

#Kesalahan umum

• Mengetik pilihan manual di banyak tempat. Tempatkan daftar di satu tabel acuan dan pakai ulang.
• Mengubah daftar setelah data terkumpul. Nilai lama yang tidak ada di daftar baru akan menjadi tidak sah. Ganti dengan hati-hati dan perbarui data lama.
• Menyimpan formulir hanya di proyek. Ponsel yang memuat GeoPackage saja tidak melihat pengaturan itu. Simpan gaya ke dalam GeoPackage, atau bawa proyeknya.
• Menganggap domain sama dengan gembok. Anggap domain sebagai penunjuk arah. Tetap periksa data (Bab 6).

#Ringkasan dan latihan

Ringkasan: domain membatasi pilihan satu kolom. Daftar tetap pakai Value Map, daftar yang bisa tumbuh pakai Value Relation, angka pakai Range. Aturan isian dan nilai bawaan melengkapinya. Penjagaan kuat butuh trigger atau pemeriksaan data.

Latihan: jalankan skrip I3.3 dan I3.4 pada Survei_KPH.gpkg. Lalu muat ulang berkas itu di proyek QGIS kosong, dan periksa apakah Kondisi tampil sebagai kotak pilihan. Tambahkan nilai keempat Lainnya ke tabel Ref_Kondisi. Mengapa nilai itu belum muncul di Value Map Kondisi?

Jawaban yang diharapkan: karena Kondisi memakai Value Map yang daftarnya tetap di pengaturan, bukan membaca tabel acuan.

#Tabel perbandingan: membatasi isian