Mapping Form
Mapping dari Field Form ke Camunda
Halaman ini mendokumentasikan pemetaan (mapping) antara komponen Form di Alurkerja On Premise dengan process variable di Camunda. Dokumentasi ini bertujuan untuk membantu pengguna, analis, dan developer memahami bagaimana setiap input pada form akan disimpan, diproses, dan digunakan dalam alur BPMN, termasuk tipe variale dan format value yang dikirim ke Camunda.
Dengan memahami mapping ini, pengguna dapat:
- Merancang form secara konsisten
- Menghindari kesalahan tipe data
- Memastikan bahwa process variable dapat digunakan dengan benar pada gateway, task maupun integrasi lanjutan.
Dokumentasi ini berlaku untuk penggunaan form pada Start Event maupun User Task.
1. Form Builder
Daftar komponen input yang tersedia pada Form Builder AlurKerja dan digunakan untuk membangun form pada Start Event maupun User Task.
2. Tabel Mapping Form ke Camunda dan Rekomendasi Penggunaannya
Setiap komponen input di atas memiliki cara pemetaan tersendiri ke process variable di Camunda, baik dari sisi tipe data maupun format nilai yang dikirim.
Pemetaan tersebut didokumentasikan pada tabel berikut.
| Jenis Input | Tipe Variable di Camunda | Format Value saat dikirim | Rekomendasi Penggunaan |
|---|---|---|---|
| Input | String | "Safitri" | Digunakan untuk menginputkan data teks seperti nama, pekerjaan, alamat, atau informasi lain berbentuk teks. |
| Number | Long | "+6281234567899" | Digunakan untuk menginputkan nomor telepon, jumlah, harga, atau informasi berbentuk angka lainnya. |
| String | "user@example.com" | Digunakan untuk menginputkan alamat email. | |
| Password | String | "qwerty1234*#" | Digunakan untuk menginputkan kata sandi atau password. |
| Date | String | "10-02-2026" | Digunakan untuk menginputkan tanggal (hari, bulan, tahun), seperti tanggal lahir, tanggal pengajuan, dan lainnya. |
| Time | String | "13:00" | Digunakan untuk menginputkan waktu (jam dan menit) seperti jam kerja, jam kegiatan, mencatat waktu dan lainnya. |
| Date Time | String | "10-02-2026 13:00" | Digunakan untuk menginputkan tanggal dan waktu sekaligus, seperti waktu pertemuan, janji, atau pengajuan yang spesifik. |
| Text Area | String | "Sukoharjo Indah J100 RT/11/RW 16, Ngaglik, Sleman" | Digunakan untuk menginputkan teks panjang, seperti deskripsi, catatan, komentar, alamat, atau informasi lainnya. |
| Switch | String | "Ya/Tidak" | Digunakan untuk menentukan keputusan dengan dua pilihan sederhana, misalnya Ya atau Tidak. |
| Toggle | Integer | "0/1" | Digunakan untuk pengaturan biner atau penentuan status (misalnya: aktif/tidak aktif, true/false), seperti menyalakan atau mematikan fitur tertentu, atau mengubah status secara langsung. |
| Dropdown | String | "Pengajuan Fasilitas Kantor" | Digunakan untuk memilih satu opsi dari daftar yang sudah disediakan, seperti memilih kategori produk atau status pengajuan. |
| Multiple Select | String | "[“1”,”2”,“3”,“4”]" | Digunakan untuk memilih beberapa opsi dari daftar yang sudah disediakan, seperti memilih lebih dari satu kategori, status, atau fitur yang dapat dipilih secara bersamaan. |
| Radio Button | String | "training_skill" | Digunakan untuk memilih satu opsi dari beberapa pilihan yang disediakan, seperti menentukan kriteria tertentu, contohnya: kategori pelatihan atau jenis pengajuan yang hanya dapat dipilih satu. |
| Checkbox | String | "["pelatihan_manajemen_proyek","pelatihan_kepemimpinan"]" | Digunakan untuk memilih beberapa opsi secara independen, seperti memilih jenis pelatihan, pengajuan faslitas tambahan, atau fitur yang diinginkan. |
| Expression Input | sesuai dengan komponen input yang digunakan | sesuai dengan komponen input yang digunakan | Digunakan untuk untuk memasukkan ekspresi atau rumus dinamis yang dihitung otomatis berdasarkan data lain yang ada di form, seperti menghitung total biaya, durasi dan lain-lain |
| Rich Text | String | "<p>Formulir ini digunakan...<strong>nama proyek</strong>,terkait proyek yang diajukan. </p>" | Digunakan untuk untuk menyusun konten yang panjang atau informasi yang membutuhkan penekanan khusus, seperti teks tebal untuk penekanan, teks miring untuk istilah, dan list untuk daftar poin. |
| File Upload | File | "multipart/form-data" | Digunakan untuk melampirkan dokumen seperti jpg, png, pdf, docx, xlsx. File dikirim sebagai binary (bukan string) dan disimpan sebagai File/ByteArray. |
| Remote Select | String | "user@example.com" | Digunakan untuk untuk memilih satu item dari daftar eksternal yang diambil secara dinamis dari API atau database, seperti memilih nama tim. |
| Remote Multiple Select | String | "[“user@example.com”,”user@example.com”]" | Digunakan untuk untuk memilih beberapa item dari daftar eksternal yang diambil dari API atau database. seperti memilih beberapa nama tim. |
| Master Data Select | sesuai dengan komponen input yang digunakan | sesuai dengan komponen input yang digunakan | Digunakan untuk memilih opsi yang ada di sistem atau database perusahaan, seperti jenis produk, kategori, atau lokasi. |