Pahami hubungan versi dokumen, strong ETag, If-Match, serta respons 412 dan 428 agar penyunting website dapat menangani benturan perubahan dengan jelas.
Ketika tombol simpan berhasil tetapi tulisan rekan hilang
Dua pengelola website dapat membuka dokumen yang sama sebelum salah satunya selesai menyunting. Pengelola pertama memperbarui alamat kantor, sedangkan pengelola kedua memperbaiki uraian layanan pada salinan yang masih memuat alamat lama. Jika aplikasi menerima seluruh isi salinan kedua tanpa memeriksa versi dasarnya, alamat yang baru diperbaiki dapat tertimpa. Inilah persoalan kehilangan pembaruan yang perlu dibahas dalam rancangan editor. Kecepatan koneksi atau keberhasilan tombol simpan saja tidak menjelaskan apakah perubahan rekan tetap terjaga.
ETag dan If-Match memberi bahasa protokol untuk menyatakan syarat versi ketika aplikasi mendukungnya. Pembahasannya relevan bagi pemilik website dengan beberapa penyunting, katalog yang diperbarui staf berbeda, atau panel informasi yang disunting bergantian. Namun keberadaan hosting tidak dengan sendirinya membuat setiap editor menerapkan pemeriksaan ini. Pemilik situs perlu menanyakan perilaku aplikasi secara konkret: versi apa yang dibaca saat formulir dibuka, kapan dibandingkan, serta apa yang dilakukan ketika ada perubahan selama penyuntingan.

ETag adalah penanda representasi yang diberikan server
Menurut dokumentasi MDN, ETag mengidentifikasi versi tertentu sebuah sumber daya. Server mengirimkannya sebagai header respons. Aplikasi yang membaca dokumen dapat menyimpan penanda itu bersama salinan yang sedang disunting. Nilai contoh berupa string di antara tanda kutip, seperti "revisi-a". Penamaan pada artikel ini hanya ilustrasi; jangan menganggap nilai ETag nyata selalu berupa nomor yang dapat ditambah, tanggal yang dapat dibaca, atau urutan yang bisa dibandingkan secara alfabet.
Cara pembentukan nilai tidak ditentukan sebagai satu rumus universal. Karena itu, klien sebaiknya memperlakukannya sebagai penanda dari server dan mengirim kembali sesuai kontrak layanan. Pemilik website tidak perlu menghafal cara menghitung hash untuk memahami fungsi bisnisnya. Yang dibutuhkan adalah kepastian bahwa penanda yang berkaitan dengan salinan awal tidak tertukar dengan dokumen lain atau diperbarui diam-diam pada sisi klien. Catatan versi yang keliru dapat membuat layar tampak mutakhir padahal dasar penyuntingannya sudah berbeda.

If-Match menyertakan syarat pada permintaan perubahan
Dalam pola pembaruan bersyarat, klien menyertakan If-Match dengan ETag yang diterima saat membaca dokumen. RFC 9110 menjelaskan pemeriksaan syarat tersebut sebelum metode dijalankan. Contoh konseptualnya adalah permintaan perubahan yang membawa If-Match: "revisi-a" ketika representasi saat ini masih memiliki penanda yang cocok. Nilai itu berbeda tugas dari isi dokumen baru yang hendak disimpan. Satu menjelaskan syarat versi, sementara yang lain menjelaskan perubahan yang diminta oleh penyunting.
RFC mewajibkan perbandingan kuat untuk If-Match. Penanda lemah dengan awalan W/ tidak cocok untuk pemeriksaan kuat ini. Jangan mengubah penanda lemah menjadi seolah kuat dengan sekadar menghapus awalan di browser. Tim pengembang harus memilih mekanisme versi yang benar pada layanan asal. Karakter bintang juga perlu dibaca dengan benar: If-Match: * berkaitan dengan keberadaan representasi saat ini, bukan janji bahwa versi persis sama dengan yang pernah dibuka oleh penyunting sebelumnya.
Contoh dua editor tanpa mengarang hasil layanan nyata
Anggap Rani dan Dimas sama-sama membaca dokumen pada versi A. Rani menyimpan perubahan berdasarkan A dan server menerima pembaruan itu, sehingga versi saat ini menjadi B. Dimas kemudian mencoba menyimpan salinannya sambil tetap membawa syarat A. Dalam contoh biasa ketika perubahan Dimas belum diterapkan dan syarat tidak cocok, server menolak menjalankan perubahan itu serta mengembalikan 412 Precondition Failed. Diagram memperlihatkan skenario rekaan untuk penjelasan, bukan rekaman permintaan ke website tertentu.
Poin utamanya adalah salinan Dimas masih berharga sebagai draf, tetapi tidak aman diterapkan seolah tidak ada perubahan lain. Penolakan tersebut dapat mencegah tulisan Rani hilang tanpa disadari. Ia belum menyelesaikan perselisihan isi secara otomatis. Aplikasi masih perlu membantu Dimas melihat versi terbaru, menemukan bagian yang berbeda, dan menentukan apakah perbaikannya tetap diperlukan. Menambahkan header tanpa merancang pengalaman setelah penolakan membuat pengguna bingung dan berisiko menyalin ulang seluruh teks dengan cara yang salah.
Bedakan syarat tidak cocok dari syarat yang tidak dikirim
MDN menjelaskan 412 sebagai kegagalan prasyarat yang diberikan pada permintaan. Sementara itu, 428 Precondition Required digunakan ketika server mengharuskan permintaan bersyarat. Pada sebuah API yang menerapkan kebijakan wajib, permintaan pembaruan tanpa syarat dapat ditolak dengan 428. Kedua situasi layak ditampilkan dengan pesan berbeda: satu meminta penyunting meninjau perubahan yang lebih baru, sedangkan yang lain menunjukkan bahwa alur klien belum memenuhi kontrak pengiriman versi yang disyaratkan.
Jangan menyimpulkan bahwa setiap layanan pasti memberikan 428 jika If-Match hilang. Itu bergantung pada kebijakan dan implementasi aplikasi. Demikian pula, pembahasan ini tidak menyatakan semua konflik bisnis mempunyai kode yang sama. Misalnya, perubahan yang secara logika tidak diizinkan oleh aturan status dokumen memerlukan penanganan tersendiri. Untuk diagnosis, minta contoh kontrak API dan hasil pengujian pada lingkungan latihan. Menebak dari nama tombol atau teks pesan umum sering mencampurkan kesalahan jaringan, izin, validasi isi, dan syarat versi.
Rancang pemulihan yang menjaga pekerjaan penyunting
Saat konflik terdeteksi, pertahankan draf lokal yang sedang dibaca pengguna dan jelaskan bahwa versi dasar sudah berubah. Berikan pilihan melihat isi terbaru serta membandingkan bidang yang berbeda. Apabila aplikasi menyediakan penyatuan perubahan, pengguna harus memahami bagian mana yang diambil dari masing-masing versi. Jangan mengganti seluruh formulir dengan data server tanpa pemberitahuan. Kebijakan yang mengamankan data bersama akan terasa gagal jika pengguna justru kehilangan tulisan yang belum pernah tersimpan.
Pengambilan ulang versi terbaru bukan alasan untuk langsung mengirim ulang seluruh draf lama. Penyunting perlu menilai ulang perubahannya di atas dasar terbaru. Contohnya, koreksi uraian layanan mungkin tetap relevan, tetapi alamat kantor yang dibawa salinan lama harus mengikuti pembaruan rekan. Untuk bidang yang sensitif terhadap operasi bisnis, tetapkan penanggung jawab keputusan. Pola ini membuat konflik terlihat sebagai pekerjaan peninjauan isi, bukan hambatan yang diatasi dengan menekan tombol simpan berkali-kali sampai salah satu permintaan diterima.
Pemeriksaan aplikasi harus berpusat pada perubahan yang benar
Pengembang perlu memastikan pemeriksaan versi dan penerapan perubahan merupakan satu keputusan konsisten pada tempat penyimpanan. Memeriksa versi, menunggu, lalu menyimpan tanpa pengaman terhadap perubahan di antaranya dapat membuka celah benturan lagi. Ini merupakan pertimbangan desain aplikasi, bukan kemampuan yang dibuktikan oleh header semata. Pastikan jalur pembaruan lain, seperti impor atau integrasi, juga mengikuti aturan yang sesuai. Satu endpoint yang disiplin tidak melindungi dokumen dari seluruh jalur penulisan yang melewati aturan tersebut.
ETag juga tidak menggantikan otorisasi pengguna. Memegang penanda versi bukan bukti seseorang berhak mengubah dokumen. Pemeriksaan identitas, izin, dan validasi isi tetap diperlukan pada server. Pisahkan pertanyaan akses dari pertanyaan kesegaran salinan ketika menulis kriteria penerimaan. Sebagai contoh, akun yang hanya membaca tetap harus ditolak melakukan perubahan walaupun membawa versi terbaru, sedangkan penyunting yang berwenang tetap dapat mengalami konflik ketika versinya sudah lama. Dua contoh ini membantu tim menilai rancangan secara lebih jelas.
Bukti yang dapat diminta pemilik website
Minta pengembang memperagakan dua sesi penyuntingan pada data latihan. Catat versi awal yang sama, hasil pembaruan sesi pertama, lalu perilaku sesi kedua ketika memakai versi lama. Bukti perlu mencakup isi akhir yang tersimpan, bukan hanya kode respons. Tambahkan pemeriksaan bahwa draf sesi kedua tetap tersedia untuk ditinjau. Periksa pula alur tanpa syarat versi jika kebijakan layanan memang mewajibkannya. Pengujian ini sebaiknya dilakukan oleh tim yang mengelola aplikasi di lingkungan yang disiapkan khusus.
Untuk membahas kebutuhan pengelolaan situs, kunjungi JagoWeb https://www.jagoweb.com/ serta halaman Website Perusahaan https://www.jagoweb.com/website-perusahaan. Jelaskan jumlah penyunting, bidang yang sering diperbarui, dan akibat jika perubahan tertimpa. Artikel ini tidak menyatakan fitur If-Match tersedia pada paket atau CMS tertentu. Gunakan pemahaman protokol sebagai bahan menetapkan perilaku yang ingin dibuktikan: perubahan terbaru tetap utuh, konflik dapat dipahami, dan penyunting memiliki jalan melanjutkan pekerjaannya setelah peninjauan.



