Kontrol Versi
Lacak setiap perubahan pada simulasi RodSim. PetroBench menyimpan snapshot setiap kali Anda menjalankan, memulihkan, menggandakan, atau mengimpor. Bandingkan versi, pulihkan status sebelumnya, dan bersihkan versi lama.
Riwayat versi hanya tersedia pada paket Enterprise.
Setiap simulasi RodSim memiliki riwayat versi bawaan. PetroBench menyimpan snapshot setiap kali terjadi sesuatu yang signifikan (pengoperasian, duplikat, impor) dan setiap versi dapat dipulihkan sepenuhnya.
Bagaimana Versi Dibuat
PetroBench membuat versi secara otomatis. Dua kategori, tujuh pemicu.
| Kategori | Pemicu | Saat kebakaran |
|---|---|---|
| Base Case | Buat | Pertama kali simulasi dibuat |
| Impor | Diimpor dari file RodStar atau SRod | |
| Sinkronisasi | Disinkronkan dari integrasi eksternal | |
| Auto | Jalankan | Setelah simulasi statis atau dinamis selesai |
| Duplikat | Saat Anda menduplikasi simulasi | |
| Pulihkan | Saat Anda memulihkan versi sebelumnya | |
| Migrasi | Sistem memigrasikan skema simulasi |
Versi Kasus Dasar menandai keadaan asli simulasi. Versi otomatis ditutup dan dibersihkan seiring waktu.
1. Buka Riwayat Versi
- Buka simulasi
- Klik ikon Version History di toolbar kanan atas
- Lembar riwayat digeser dari kanan
Setiap versi menunjukkan:
- Version number (v1, v2, ...)
- Trigger badge (Simulasi Jalankan, Duplikasi, Pulihkan)
- Date and time, siapa yang memicunya
- Inline diff yang berubah sejak versi sebelumnya (misalnya 17 perubahan sejak v2) dengan coretan merah dan nilai baru berwarna hijau
- Tombol Add note untuk memberi label versi
- Tombol Restore (di setiap versi kecuali versi saat ini)
- Current tag hijau pada versi terbaru
2. Tambahkan Catatan
Catatan mengubah versi yang dibuat secara otomatis menjadi versi berlabel, yang melindunginya dari pembersihan dan membuatnya dapat ditemukan nanti.
- Klik Add note pada versi apa pun
- Ketik labelnya (misalnya, "Catatan Versi 3" atau "Sebelum desain ulang batang")
- Klik tanda centang hijau untuk menyimpan
Untuk mengubah label di lain waktu, arahkan kursor ke versinya dan klik Edit note.
Tambahkan catatan ke versi apa pun yang ingin Anda simpan. Pembersihan tidak pernah menyentuh versi berlabel.
3. Bandingkan Versi
Dua aliran.
3.1 Membandingkan Versi dengan Versi Saat Ini
Alur default ketika Anda memilih satu versi (atau nol, dalam hal ini versi yang dipilih adalah yang terbaru).
- Buka lembar riwayat
- Klik Compare with current di bagian bawah
Tampilan Bandingkan memperlihatkan dua kolom berdampingan. Strip tab di grup teratas berubah berdasarkan bagian dengan jumlah:
| Tab | Pertunjukan |
|---|---|
| All | Setiap bidang yang diubah sepanjang simulasi |
| Simulation Preferences | Target, redaman, panjang langkah |
| Well Data | Sifat fluida, spesifikasi pompa, unit pompa |
| Tubing Data | Kedalaman PSN, jangkar, tali pipa |
| Rod Data | Tali Lancip Batang |
| IPR Data | Data uji reservoir |
Tombol di kanan atas (Changes only) menyembunyikan bidang yang sama sehingga Anda hanya melihat perbedaannya.
3.2 Membandingkan Dua Versi
- Di lembar riwayat, centang kotak pada dua versi
- Klik Compare with current (label tombol bergeser untuk membandingkan keduanya)
Tata letak perbedaannya sama. Gunakan panah chevron di kanan atas tampilan Bandingkan untuk menelusuri versi tanpa meninggalkan halaman.
4. Pulihkan Versi
Dari tampilan Bandingkan, klik tombol Pulihkan ke v[N] di kanan bawah. Dari daftar riwayat, klik Restore pada versi apa pun.
Dialog tersebut menegaskan:
Pulihkan ke v2? Ini akan mengembalikan simulasi ke versi yang dipilih. Cadangan status saat ini akan disimpan secara otomatis sebelum dipulihkan.
Klik Restore. PetroBench:
- Menyimpan status saat ini sebagai versi baru (sehingga rollback itu sendiri dapat dibalik)
- Mengganti input simulasi dengan snapshot
- Menambahkan versi baru dengan pemicu Restore dan label "Dipulihkan dari v[N]"
Anda tidak dapat memulihkan saat simulasi dinamis sedang berjalan. Tunggu sampai selesai.
Jika pemulihan diblokir, lembar menunjukkan "Versi ini tidak dapat dipulihkan" beserta alasannya.
5. Bersihkan Versi Lama
Pembersihan dibatasi pada peran aplikasi Admin. Insinyur dapat membuat dan memulihkan versi tetapi tidak dapat menghapusnya.
Versi Jalankan Otomatis dapat menumpuk dengan cepat. Gunakan Pembersihan untuk menipiskannya tanpa kehilangan yang Anda sayangi.
- Di lembar riwayat, klik Cleanup
- Pilih cakupan:
| Pilihan | Apa yang dihapus |
|---|---|
| Delete all old versions | Setiap versi otomatis tidak berlabel kecuali |
| Older than 7 days | Versi otomatis lebih lama dari 7 hari |
| Older than 30 days | Versi otomatis lebih lama dari 30 hari |
| Older than 90 days | Versi otomatis lebih lama dari 90 hari |
Munculan memberi tahu Anda berapa banyak versi yang akan dihapus: "2 versi yang tidak berlabel memenuhi syarat untuk pembersihan. Versi berlabel dan versi terbaru selalu dipertahankan."
Pemilih Filter by trigger di bagian atas popup yang sama memungkinkan Anda mempersempit cakupan ke jenis pemicu tertentu (hanya Jalankan, hanya Duplikat, dll.) sebelum menjalankan pembersihan.
6. Pintasan Footer
Footer lembar riwayat memiliki beberapa kontrol lagi di samping Cleanup:
- Save version - mengambil snapshot status saat ini secara manual. Muncul bila Anda memiliki perubahan yang belum terekam dalam suatu versi.
- Reset - dropdown (ditampilkan setelah versi Base Case ada) dengan dua pemulihan sekali klik:
- Reset ke Base Case (v[N]) - kembali ke keadaan awal simulasi
- Pulihkan Sebelumnya (v[N]) - kembali ke versi sebelum versi saat ini
Keduanya mengikuti alur pencadangan-lalu-penggantian yang sama seperti Pemulihan normal.
Hitungan X of Y versions berada di sebelah kiri. Jika lebih banyak versi daripada yang dimuat, tombol Load more di bagian bawah daftar akan menampilkan halaman berikutnya.
Izin
Tindakan versi memeriksa izin peran:
| Aksi | Izin yang diperlukan |
|---|---|
| View history | Lihat simulasi |
| Compare | Lihat simulasi |
| Edit note | Sunting simulasi |
| Restore | Sunting simulasi |
| Delete / Cleanup | Hanya peran admin |
Jika Anda tidak memiliki izin untuk suatu tindakan, tombol tetap terlihat tetapi dinonaktifkan dengan keterangan alat yang menjelaskan alasannya.