view_quilt Orchestrator — Panduan Penggunaan
Orchestrator digunakan untuk menata bentuk dan perilaku layar pada package yang sama dengan yang Anda pilih di Repository: form, wizard, jendela modal, tabel data, serta pengaturan khusus untuk jenis field seperti pilihan (select), pencarian, persetujuan, unggah file, dan lainnya.
Sebelum Membuka Orchestrator
Di Repository, klik salah satu item di bawah nama package yang ingin Anda kerjakan. Tanpa itu, banyak layar Orchestrator menampilkan pesan bahwa data package belum siap.
Urutan Kerja yang Disarankan
- Pastikan struktur package dan daftar view/form di lingkungan Anda sudah siap.
- Buka Composer untuk merapikan field yang dipakai versus field cadangan di konteks form.
- Buka Schemas — sesuaikan Forms, Wizard, Modal, atau Datatables dengan jenis layar yang Anda kirim ke pengguna.
- Sesuaikan tiap jenis field (Select, Search, Approval, dan seterusnya) sesuai kebutuhan.
Daftar Menu dan Fungsinya
Composer
Layar dua kolom lebar: Field Dipilih dan Field Tersedia. Di sinilah Anda menyelaraskan daftar field untuk keperluan orkestrasi form.
Schemas
| Menu | Fungsi singkat |
|---|---|
| Forms | Menampilkan pratinjau form dan panel pengaturan di samping. Perlu adanya daftar view yang sudah terdaftar di sistem. |
| Wizard | Mengatur alur wizard berganda-langkah dan pengaturan terkait. |
| Modal | Mengatur isi dan perilaku jendela modal (tombol kirim, reset, dan dokumentasi pemakaian). |
| Datatables → Setting | Pengaturan untuk tampilan tabel data. |
| Datatables → View | Menampilkan pratinjau tabel sesuai pengaturan yang ada. |
Field dan Perilaku Lanjutan
| Menu | Fungsi singkat |
|---|---|
| Select | Mengatur opsi dropdown: input manual (native) atau ambil dari database (tabel, kolom teks/nilai). |
| Search | Mengatur field pencarian: sumber data, pemetaan kolom, filter tambahan, dan penyimpanan opsi. |
| Flag | Mengatur wilayah (provinsi atau kabupaten/kota) untuk field flag. |
| Approval | Mengatur alur persetujuan (terima/tolak/modal penolakan) per field yang relevan. |
| Populate | Mengisi atau memperbaiki populate otomatis untuk field yang memerlukan setup. |
| Upload | Mengatur unggah file (ukuran, mode impor, dll.). Membutuhkan daftar view yang sama seperti Forms. |
| Avatar | Pengaturan field foto profil / avatar. |
| Tags | Pengaturan tag pada field yang mendukung. |
| Instansi | Pengaturan field instansi sesuai formulir dan panduan di layar. |
| Maps | Ditujukan untuk pengaturan peta; gunakan setelah fitur di aplikasi Anda lengkap. |
Composer dan Penundaan Tampilan
Layar Composer kadang muncul sedikit tertunda setelah Anda mengklik menu. Jika Anda langsung berpindah ke menu lain, tampilan bisa tidak selesai dimuat — tunggu sejenak atau buka Composer lagi.
Jika Ada Masalah
| Gejala | Yang bisa Anda coba |
|---|---|
| Pesan kunci atau package belum diset | Pilih ulang package di Repository dengan mengklik item di bawah namanya. |
| "Belum ada view." | Daftar view/form untuk lingkungan Anda belum ada — siapkan terlebih dahulu di alur kerja yang biasa Anda pakai. |
| Populate tidak menampilkan pekerjaan | Mungkin tidak ada field populate yang memerlukan perbaikan — ini bisa normal. |
| Wizard tidak membuka | Pastikan package sudah dipilih; ulangi dari Repository. |
Hubungan dengan Canonical
Canonical mengatur definisi data dan query untuk membaca atau menulis lewat jalur standar. Orchestrator mengatur bagaimana form dan komponen UI berperilaku untuk package yang sama. Keduanya mengikuti package yang Anda pilih di Repository.