Versi Addon per Workspace

Mempublikasikan versi baru addon, membaca laporan selisih, mengaktifkan versi lama (rollback), dan batas retensi 5 versi.

Addon yang Anda terbitkan dari workspace punya riwayat versi. Setiap kali Anda mempublikasikan paket dengan nomor versi baru, versi itu disimpan di samping versi sebelumnya, sehingga Anda bisa kembali ke versi lama bila versi baru bermasalah.

Versi bersifat per workspace: mempublikasikan versi baru di workspace A tidak mengubah versi yang dipakai workspace B, dan tidak mereset status aktif/nonaktif addon di workspace A.

Anda membutuhkan role Owner atau Admin SOP pada workspace untuk mempublikasikan atau mengaktifkan versi. Member biasa ditolak 403.

Mempublikasikan Versi Baru

Buka menu Addons (grup ADMINISTRATION), lalu klik Publish addon.
Pilih paket addon (.zip) yang index.json-nya memuat nomor versi baru.
Klik Publish addon pada dialog.

Hasilnya:

Situasi	Hasil
Nomor versi baru	Versi tersimpan dan menjadi versi aktif. Laporan selisih ditampilkan.
Nomor versi sama, isi paket sama persis	Diterima (200), tidak ada versi baru.
Nomor versi sama, isi paket berbeda	Ditolak 409 `version_exists`. Naikkan nomor versi di `index.json`, lalu publish ulang.

Eksekusi addon berikutnya memakai berkas dan action dari versi aktif. Riwayat eksekusi mencatat versi yang dipakai (plugin_version), sehingga Anda bisa melihat dari versi mana sebuah eksekusi berasal.

Laporan Selisih

Setiap publish dan aktivasi menampilkan Laporan selisih: vA → vB yang membandingkan versi sebelumnya dengan yang baru. Laporan ini hanya peringatan — tidak pernah memblokir tindakannya. Bagian yang bisa muncul:

Bagian	Artinya bagi Anda
Config wajib baru (perlu diisi di Integrasi)	Versi baru menuntut field konfigurasi yang belum ada. Isi field tersebut di menu Integration sebelum addon dipanggil, bila tidak pemanggilan bisa gagal. Bagian ini ditonjolkan karena paling sering terlewat.
Action yang hilang	Action yang ada di versi lama tidak ada lagi. Proses BPMN yang memanggilnya akan gagal.
API yang hilang	Endpoint API addon yang dihapus.
Config wajib yang dihapus	Field konfigurasi wajib yang sudah tidak diperlukan.

Bila tidak ada perubahan berisiko, dialog menampilkan Tidak ada perubahan yang berpotensi merusak integrasi.

Melihat Versi dan Rollback

Di kartu addon pada menu Addons, klik Versi.
Tabel menampilkan Versi, Sumber (Manual atau Store), Pengunggah, Tanggal, dan badge Aktif pada versi yang sedang dipakai.
Untuk kembali ke versi lama, klik Aktifkan pada baris versi tersebut, lalu konfirmasi Aktifkan versi X?.

Mengaktifkan versi lain memindahkan folder dan manifest sekaligus: berkas dan action versi lama kembali dipakai, dan laporan selisih ditampilkan sehingga Anda tahu apa yang berubah. Tombol Aktifkan hanya tampil bagi Owner/Admin SOP.

Retensi 5 Versi

Workspace menyimpan paling banyak 5 versi per addon. Saat versi baru melampaui batas, versi paling lama dibuang — kecuali versi yang sedang aktif, yang tidak pernah terhapus meski sudah lama. Bila Anda perlu menjaga versi tertentu untuk rollback, aktifkan atau publish ulang sebelum melampaui batas.

Addon Platform Tidak Terpengaruh

Addon yang dipasang admin instance (badge Platform addon, mis. mockapi) memakai jalur sendiri. Upload paket platform yang rusak tidak mengubah addon platform yang sedang berjalan, dan addon platform tetap bisa dipakai workspace mana pun yang sudah menyalakannya.