Generator alamat Amerika Serikat di situs ini menyusun catatan alamat lengkap yang terdiri dari nomor rumah, nama jalan, keterangan unit, kota, singkatan negara bagian dua huruf, dan kode pos lima digit yang saling cocok. Catatan tersebut dibuat untuk mengisi formulir, menguji aturan validasi, dan menyiapkan basis data staging, bukan untuk dikirim melalui pos kepada siapa pun. Banyak tim baru menyadari pentingnya kecocokan antar bidang setelah menemukan kasus uji yang gagal karena alasan yang tidak ada hubungannya dengan kode mereka. Uraian berikut menjelaskan susunan satu alamat Amerika Serikat, cakupan wilayah yang perlu diperhatikan penguji, dan daftar kasus uji yang layak disiapkan sebelum formulir dirilis.
Susunan satu alamat Amerika Serikat
Alamat pos di negara itu biasanya menempati dua baris inti. Baris pertama memuat nomor rumah bersama nama jalan, dan bila penerima berada di unit tertentu, keterangan unit ditambahkan pada baris yang sama atau baris berikutnya. Baris kedua memuat nama kota, singkatan negara bagian, dan kode pos yang dipisahkan tanda baca. Pada kiriman dari luar negeri, nama negara muncul di baris paling bawah, sedangkan pada surat domestik nama negara tidak ditulis sama sekali.
Urutan ini terasa wajar bagi pembaca setempat karena nomor rumah mendahului nama jalan. Membalik urutan tersebut membuat alamat tetap terbaca oleh manusia, tetapi sistem pengiriman dan banyak basis data alamat akan salah menafsirkannya. Karena itu, saat merancang formulir, pisahkan bidang nomor rumah dari bidang nama jalan sejak awal meski tampilan akhirnya menggabungkan keduanya menjadi satu baris.
Keterangan unit punya kebiasaan sendiri yang mudah terlewat. Sebagian orang tinggal di rumah tunggal tanpa unit, sebagian lain memakai penanda seperti apartemen, suite, atau nomor unit, dan sebagian memakai beberapa penanda sekaligus. Menyimpannya sebagai bidang tersendiri memudahkan pengurutan dan pencocokan, dan membuat pengujian tetap masuk akal ketika catatan tanpa unit muncul di daftar yang sama. Rincian susunan ini dibahas lebih panjang pada struktur alamat Amerika Serikat.
Lima puluh negara bagian, District of Columbia, dan wilayah teritori
Amerika Serikat bukan hanya lima puluh negara bagian. Ada District of Columbia sebagai pusat pemerintahan, lalu wilayah teritori seperti Puerto Riko, Guam, dan Kepulauan Virgin yang tetap memakai sistem pos negara itu meski penanda wilayahnya berbeda. Bagi penguji, perbedaan ini penting karena daftar singkatan yang hanya memuat lima puluh negara bagian akan menolak alamat dari wilayah teritori meski alamatnya benar.
Wilayah teritori juga punya kebiasaan kode pos yang tidak selalu mengikuti pola negara bagian. Sebagian memakai awalan kode pos tertentu, dan sebagian lain memakai kode pos khusus yang tidak terbagi menurut wilayah seperti biasa. Bila sistem Anda memeriksa kecocokan antara wilayah dan kode pos dengan daftar yang disederhanakan, wilayah teritori akan gagal pada pemeriksaan yang sebenarnya tidak perlu gagal.
Karena itu, daftar rujukan sebaiknya mencakup seluruh penanda wilayah yang diterima sistem pos, termasuk yang tidak mewakili negara bagian, dan mencakup pula singkatan militer yang dipakai untuk kiriman ke pangkalan di luar negeri. Perlakuan khusus untuk kelompok wilayah yang kecil dibahas pada panduan wilayah kecil dan kode khusus, dan pola itu berlaku cukup umum di banyak negara, bukan hanya di Amerika Serikat.
Mengapa kode pos dan negara bagian harus cocok?
Karena kode pos di negara itu dibagi menurut wilayah, bukan dibagi secara acak. Setiap negara bagian memiliki rentang awalan kode pos tertentu, dan kode pos yang bentuknya sah tetapi berada di negara bagian lain adalah jenis kesalahan yang paling sulit disadari manusia. Deretan lima digit terlihat masuk akal bagi siapa pun yang tidak menghafal pembagiannya, sementara program pemeriksa dapat menemukannya dalam hitungan milidetik.
Di sinilah nilai kecocokan antar bidang terlihat. Generator yang hanya mengambil angka acak lalu menempelkannya ke kota mana pun akan menghasilkan catatan yang secara bentuk benar tetapi secara isi bertentangan. Catatan seperti itu memang masih bisa dipakai untuk menguji panjang kolom, tetapi tidak lagi berguna untuk menguji logika validasi lintas bidang, dan justru itu yang paling sering menjadi sumber kutu di formulir alamat.
Untuk pengujian yang serius, kota, negara bagian, dan kode pos harus berasal dari satu himpunan yang konsisten. Situs ini menyusun catatan dari himpunan kota dan kode pos yang sudah dipasangkan menurut negara bagiannya, sehingga Anda menerima kombinasi yang benar-benar muncul di dunia nyata tanpa perlu menyusun daftar sendiri. Pembagian kode pos menurut negara juga berguna ketika formulir Anda melayani banyak negara, seperti diuraikan pada format kode pos per negara.
Berapa luas cakupan data yang layak dipakai?
Cakupan data menentukan seberapa banyak sudut yang bisa Anda uji tanpa menulis kasus satu per satu. Situs ini memuat lebih dari dua ratus kota, hampir dua ribu wilayah administrasi, dan lebih dari tiga belas ribu kode pos untuk negara tersebut. Cakupan sebesar itu membuat pengujian berbasis volume menjadi mungkin: Anda dapat menghasilkan ribuan catatan berbeda tanpa pengulangan yang mengganggu, lalu memeriksa bagaimana daftar, pencarian, dan ekspor bekerja ketika isinya besar.
Cakupan juga membantu menemukan masalah tata letak. Nama kota di sana bervariasi panjangnya, mulai dari yang sangat pendek sampai yang cukup panjang untuk memotong kolom tabel. Nama jalan mengikuti pola yang berbeda-beda pula, ada yang hanya satu kata dan ada yang memuat arah mata angin atau nama tokoh. Jika uji Anda selalu memakai catatan yang sama yang kebetulan pendek, kolom yang terpotong tidak akan pernah terlihat sampai ada pengguna sungguhan.
Perlu diingat bahwa cakupan luas bukan berarti keluaran yang tidak terkendali. Anda memilih negara, memilih kunci, dan seluruh bidang lain diturunkan dari pilihan itu. Kunci yang sama akan selalu membangun catatan yang sama, sehingga laporan kutu dapat menyebut satu contoh yang pasti dapat dibuka ulang oleh rekan satu tim.
Kesalahan pengisian yang paling sering muncul
Kesalahan yang paling sering ditemui bukanlah kesalahan ketik, melainkan kesalahan struktur. Orang menuliskan nama negara bagian dengan singkatan karangan, menyingkat nama jalan sehingga tidak lagi unik, atau menaruh nomor unit di baris yang salah. Ketiganya lolos dari pemeriksaan mata karena hasilnya tetap terbaca, dan ketiganya baru terlihat ketika sistem lain menolak catatan itu.
Kelompok kesalahan kedua berkaitan dengan tipe data. Kode pos yang disimpan sebagai bilangan akan kehilangan angka nol di depan, dan nomor rumah yang disimpan sebagai bilangan kehilangan huruf yang kadang menyertainya. Kode pos lima digit yang disimpan dengan tipe yang salah juga membuat pencarian berdasarkan awalan menjadi tidak mungkin, sehingga fitur pencarian wilayah yang seharusnya mudah justru menjadi rumit.
Kelompok kesalahan ketiga muncul dari pembersihan data yang terlalu bersemangat. Arah mata angin pada nama jalan, kata penanda jenis jalan, dan nomor unit semuanya sering dihapus oleh aturan pembersihan yang menganggapnya berlebihan. Padahal ketiganya adalah bagian dari alamat, dan menghapusnya mengubah alamat tersebut menjadi alamat lain yang mungkin juga ada. Aturan membersihkan dan menormalkan alamat dibahas tersendiri pada validasi dan normalisasi alamat.
Apakah alamat hasil generator bisa dipakai untuk kiriman sungguhan?
Tidak, dan memang bukan itu tujuannya. Catatan yang dihasilkan adalah data uji sintetis: bentuknya mengikuti aturan penulisan yang berlaku, lengkap dengan kecocokan antara kota, negara bagian, dan kode pos, tetapi tidak menunjuk lokasi yang benar-benar ada dan tidak terkait dengan penghuni mana pun. Alamat seperti ini tidak dapat dipakai untuk mengirim paket, tidak mewakili seseorang, dan tidak boleh dipakai untuk mengajukan layanan atas nama orang lain.
Yang membuatnya berguna justru sifat sintetis itu. Karena tidak menunjuk siapa pun, catatan tersebut aman disalin ke lingkungan pengujian, disimpan di berkas acuan, dan dibagikan ke seluruh tim tanpa membawa tanggung jawab atas data pribadi. Pembahasan mengenai batas pemakaian data semacam ini ada pada privasi data alamat, dan garis besarnya sederhana: pakai untuk menguji sistem Anda sendiri, jangan pakai untuk melewati pemeriksaan identitas yang sungguhan.
Satu hal yang perlu dijaga adalah pemisahan antara lingkungan. Data uji tidak boleh tercampur ke basis data produksi, sekalipun bentuknya mirip data asli. Labeli dengan penanda yang jelas misalnya dari kunci yang dipakai, dan jangan biarkan proses impor yang sama dipakai untuk keduanya.
Kasus uji yang sebaiknya disiapkan sejak awal
Siapkan setidaknya satu catatan tanpa unit, satu catatan dengan unit dan nama gedung, satu catatan dengan kode pos lima digit tanpa tambahan, satu catatan dengan empat digit tambahan, dan satu pasangan negara bagian dengan kode pos yang sengaja tidak cocok. Kelima kasus itu menutup sebagian besar kesalahan yang nyata terjadi. Tambahkan satu catatan dari wilayah teritori dan satu catatan dengan nama jalan yang panjang agar tata letak ikut teruji.
Selain itu, uji pula masukan yang cacat dengan sengaja: kode pos yang hanya empat digit, kode pos dengan huruf, nama negara bagian dalam huruf kecil semua, dan jarak berlebih di dalam nama jalan. Formulir yang baik akan menormalkan masukan yang bisa dinormalkan dan menolak yang memang tidak sah dengan pesan yang menyebut bagian mana yang perlu diperbaiki. Ringkasan kasus untuk formulir pengiriman ada pada kasus uji formulir alamat pengiriman.
Untuk mengisi kasus-kasus itu, generator alamat di situs ini dapat menghasilkan catatan dengan format setempat pada kunci yang Anda tentukan, sehingga hasilnya tetap sama setiap kali dijalankan ulang. Bila Anda ingin membandingkan kebiasaan penulisan dengan negara lain, halaman Amerika Serikat merangkum pola dasarnya dalam satu tempat.
Bagaimana kunci tetap menolong saat kutu dilaporkan
Salah satu kebiasaan yang membedakan tim yang pengujiannya rapi adalah kesediaan memakai catatan yang dapat dibuka ulang. Bila laporan kutu hanya menyebut bahwa kolom kode pos terpotong pada suatu alamat, pengembang harus menebak alamat mana yang dimaksud, dan sering kali menebaknya salah. Bila laporan menyebut kunci yang dipakai, alamat yang sama dapat dibangun kembali dalam beberapa detik tanpa perlu menyimpan berkas apa pun.
Kunci tetap juga membuat pengujian otomatis menjadi masuk akal. Pada setiap perubahan kode, rangkaian pengujian berjalan dari nol dan memerlukan masukan yang sama seperti eksekusi sebelumnya. Masukan yang berubah setiap kali dijalankan membuat kegagalan sulit diulang, karena masalahnya bisa hilang begitu pengujian dijalankan ulang. Sebaliknya, bila Anda memang ingin keragaman, hasilkan sekumpulan besar catatan sekali saja, simpan sebagai berkas acuan, lalu perlakukan berkas itu seperti data tetap lainnya.
Langkah berikutnya
Mulailah dari pemeriksaan yang paling murah, yaitu kecocokan antara kota, negara bagian, dan kode pos. Periksa apakah formulir Anda memakai daftar singkatan wilayah yang resmi dan lengkap, lalu simpan daftar itu di satu tempat agar dapat dipakai bersama oleh tampilan, validasi, dan lapisan penyimpanan. Setelah itu, patok lima kasus uji tetap dari daftar di atas dan pastikan setiap rilis melewatinya.
Akhirnya, ingat kembali batasnya. Seluruh catatan dari generator ini adalah data sintetis untuk pengujian perangkat lunak, demo formulir, dan pengisian basis data staging. Formatnya sengaja dibuat benar agar sistem Anda bisa diuji dengan jujur, tetapi tidak ada satu pun catatan di dalamnya yang mewakili orang, rumah tangga, atau rekening yang sungguh ada.