Addon Integrasi digunakan untuk menyederhanakan pemanggilan API di AlurKerja. Pengguna tidak perlu mengisi method, URL, atau payload JSON secara manual.

Prasyarat

Sebelum menggunakan Addon, pastikan:

1. Addon sudah terinstall dan aktif di sistem
2. User memiliki akses ke:
   • Menu Integrasi
   • Editor BPMN/AlurKerja

Langkah-langkah Konfigurasi Addon

Buka Menu Mockapi Test Addon

1. Masuk ke Dashboard Integrations
2. Pilih menu Mockapi Test Addon pada panel kiri.
3. Sistem akan menampilkan daftar konfigurasi Addon yang tersedia.
4. Klik Add New Mockapi Test Addon Configuration untuk membuat konfigurasi baru.

Menambahkan Konfigurasi Addon Baru

1. Setelah klik Add New Mockapi Test Addon Configuration pada menu Mockapi Test Addon, sistem akan menampilkan formulir Configuration Details. Pada bagian ini, isi beberapa field berikut:
   • Configuration Name : Isi nama konfigurasi. Nama ini akan tampil di daftar konfigurasi dan dapat dipilih saat digunakan pada BPMN.
   • Description : Isi deskripsi singkat untuk menjelaskan tujuan konfigurasi (opsional).
   • Nama File : Masukkan nama file yang akan digunakan pada konfigurasi (sesuai kebutuhan addon).
   • Variables : Isi pasangan Key dan Value sesuai variable yang dibutuhkan. Jika ingin menambahkan variable lain, Klik Add Variable untuk menambahkan baris variable baru.
2. Klik Test untuk memastikan koneksi valid.
3. Klik Save Configuration untuk menyimpan konfigurasi baru.

Mengubah atau Menghapus Konfigurasi Addon

Mengubah Konfigurasi Addon

1. Pada tabel Addon Configurations, klik ikon pensil pada konfigurasi yang ingin diubah.
2. Sistem akan menampilkan halaman Configuration Details yang berisi nama konfigurasi, deskripsi, nama file, variabel.
3. Lakukan perubahan pada field yang diperlukan.
4. Klik Test untuk memastikan koneksi valid.
5. Klik Update Configuration untuk menyimpan perubahan.

Menghapus Konfigurasi Addon

Terdapat dua cara untuk menghapus konfigurasi:

1. Dari Daftar Konfigurasi

   
   • Pada tabel Addon Configurations, klik ikon tempat sampah pada baris konfigurasi yang ingin dihapus.
   • Konfigurasi penghapusan.

2. Dari Halaman Detail Konfigurasi

   
   • Buka konfigurasi yang ingin dihapus.
   • Klik tombol remove di bagian kanan judul Configuration Details.
   • Konfirmasi penghapusan.

Konfigurasi Addon pada BPMN

Konfigurasi Addon pada BPMN digunakan untuk menghubungkan configuration yang telah dibuat pada menu Integrations ke dalam alur proses BPMN. Dengan konfigurasi ini, sistem dapat menjalankan pemanggilan API secara otomatis melalui Service Task sesuai integration yang dipilih.

1. Buka BPMN Editor pada AlurKerja.
2. Tambahkan elemen Service Task pada diagram proses.
3. Klik Service Task yang akan dikonfigurasi.
4. Klik ikon gear untuk membuka tab Integration pada Properti Panel.
5. Klik Add Integrations.
6. Pilih jenis Integration sesuai dengan kebutuhan.
   • Delete Mock Data: Digunakan untuk menghapus data yang sudah tersimpan di mock API (biasanya untuk reset data sebelum testing ulang).
   • Get Mock Data: Digunakan untuk mengambil/menampilkan data dari Mock API (untuk mengecek apakah data sudah tersimpan atau untuk kebutuhan validasi saat testing).
   • Post Mock Data: Digunakan untuk mengirim/menambahkan data ke Mock API (untuk membuat data dummy yang akan dipakai dalam proses testing).
7. Pilih Mock Configuration yang telah dibuat pada menu Integrations.
8. Aktifkan toggle Save Result untuk menyimpan hasil eksekusi ke data proses.
9. Isi dan sesuaikan parameter integration sesuai kebutuhan, lalu klik Save Integration.
10. Setelah itu klik Save untuk menyimpan perubahan diagram, lalu lakukan Deploy.

Menjalankan BPMN di App AlurKerja

Setelah BPMN berhasil dideploy, proses bisnis dapat dijalankan melalui App AlurKerja untuk memastikan integration berjalan sesuai konfigurasi.

1. Buka App AlurKerja, lalu pilih Proses Bisnis yang sudah dideploy.
2. Klik Start Process pada proses bisnis yang akan tersebut.
3. Buka menu My Request > Active untuk melihat proses yang sedang berjalan dan data API yang dipanggil.