Menyimpan draft dan menangani konflik versi
Panduan ini menjelaskan cara memastikan pekerjaanmu benar-benar tersimpan, dan apa yang dilakukan kalau penyimpanan gagal atau bentrok dengan sesi lain.
Intinya
Pekerjaan baru aman kalau sudah tersimpan di server dan masih ada saat dibuka ulang. Salinan lokal hanya cadangan darurat. Preview hanya untuk mengecek tampilan.
Cara kerjanya
Setiap undangan punya nomor versi di server. Saat kamu membuka editor, editor mencatat nomor versi itu. Saat kamu menyimpan, server mengecek: apakah versinya masih sama?
- Masih sama: simpanan diterima dan nomor versi bertambah.
- Sudah berubah (misalnya pelanggan atau Admin menyimpan dari tab lain): simpanan ditolak. Ini konflik versi. Penolakan ini melindungi pekerjaan orang lain agar tidak tertimpa diam-diam.
Karena itu, sebisa mungkin buka satu undangan di satu tab saja. Undo/Redo hanya berlaku di sesi yang sedang berjalan, dan hilang setelah tab ditutup.
| Editor formulir | Studio | |
|---|---|---|
| Simpan ke server | Simpan Draft | Simpan draft undangan |
| Salinan lokal | Unduh salinan perubahan (muncul saat simpan error) | Export JSON lokal |
| Membaca versi server | Buka ulang undangan dari daftar | Buka ulang versi server |
Langkah A: Simpan di editor formulir
- Pilih Simpan Draft dan tunggu status Tersimpan. Jangan tutup halaman selama proses.
- Kalau status kembali Belum disimpan, berarti ada perubahan baru saat proses simpan berjalan. Simpan lagi.
- Kembali ke daftar, buka lagi undangan yang sama, dan cocokkan perubahan terakhir.
Status Tersimpan saat editor baru dibuka hanya berarti dokumen awal sudah dimuat.
Langkah B: Kalau simpan gagal di editor formulir
- Jangan tutup tab dan jangan menekan simpan berulang kali.
- Pilih Unduh salinan perubahan di panel error, lalu cek filenya. Kalau gagal, salin perubahan penting secara manual.
- Buka lagi undangan untuk melihat versi server terbaru.
- Bandingkan dengan salinanmu, terapkan ulang perubahan yang masih perlu, lalu simpan.
File salinan ini berisi teks dan referensi media (bukan foto/musik aslinya), dan belum bisa diimpor ke editor formulir. Simpan secara privat karena berisi data pelanggan.
Langkah C: Simpan dan pulihkan di Studio
- Pilih Simpan draft undangan dan tunggu Draft privat tersimpan, versi ….
- Kalau simpan gagal atau konflik, biarkan tab terbuka dan pilih Export JSON lokal. File ini bisa memuat gambar dalam desain.
- Setelah file aman, pilih Buka ulang versi server. Studio akan mengingatkan bahwa perubahan lokal akan diganti.
- Cocokkan pesan Draft privat dibuka, versi … dengan isinya.
- Untuk mengembalikan cadangan, pakai Import JSON lokal. Cadangan dimuat sebagai draft lokal, tidak digabung otomatis dengan versi server. Cek isinya, lalu simpan.
Kalau sesi atau akses berakhir, editor langsung dibersihkan demi keamanan. Peringatan saat menutup tab bukan autosave.
Preview dan publikasi
- Live Preview (editor formulir) dan Pratinjau visual statis (Studio) hanya menampilkan simulasi. Pratinjau statis tidak menjalankan custom code.
- Jalankan custom code menjalankan kode di area terisolasi, bukan publikasi.
- Preview Publik dan tombol publish di editor formulir belum berfungsi. Di Studio pelanggan, tombol publikasi disembunyikan. Ini memang belum tersedia, bukan error.
Kalau berhasil
Dokumen yang dibuka ulang dari server berisi perubahan yang kamu maksud. Untuk langkah sebelum dibagikan, lihat kesiapan publikasi.
Kalau ada masalah
| Gejala | Penyebab | Solusi |
|---|---|---|
| Pesan draft server sudah berubah | Konflik versi, ada simpanan dari sesi lain | Amankan salinan lokal, baca versi server, lalu terapkan ulang perubahanmu. |
| Simpan gagal karena jaringan | Koneksi putus, hasilnya belum pasti | Baca versi server dulu sebelum menyimpan ulang. Simpanan mungkin sudah masuk. |
| Editor tiba-tiba kosong | Sesi berakhir | Masuk lagi. Perubahan yang belum tersimpan tidak bisa dipulihkan. |
Saat minta bantuan, sebutkan editor, waktu, undangan, nomor versi yang terlihat, dan pesan error. Jangan kirim seluruh file JSON pelanggan.