API Data Table

API Data Table digunakan untuk menampilkan data dari sistem lain sebagai tabel baca-saja di dalam form, misalnya daftar key result tim. Data diambil setiap form dibuka. Pengguna hanya melihat, tidak mengisi. Komponen ini ada di grup Data pada palette.

Mapping ke Engine

Komponen ini tidak menyimpan process variable. Isi tabel tidak ikut dikirim saat Complete Task.

Properties

• Name: Judul tabel dalam dua bahasa (EN & ID), tampil di atas tabel.
• Key: Identitas node di dalam form. Tidak ada nilai yang disimpan dengan key ini.
• Get rows from: Sumber data, Connection atau URL.
• Connection: Connector yang dipakai, dipilih dari daftar connector di menu Integration, Connectors. Selama belum dipilih, kolom bertuliskan "Select a connector".
  • Bila workspace belum punya connector, tampil "No connectors yet. Add one under Integration, Connectors."
  • Bila daftar connector gagal dimuat, tampil "Couldn't load connectors".
  • Endpoint: Endpoint GET milik connector itu. Bila connector tidak punya daftar endpoint, isian berubah menjadi Path yang diketik, misalnya /v1/items. Endpoint terpilih tampil sebagai petunjuk, misalnya GET okr-api/v1/key-results.
  • Test call: Memanggil endpoint sekali untuk memuat contoh respons. Hasilnya dipakai untuk mengecek Root path dan memilih field kolom. Izin akses (proxy grant) yang didapat dari panggilan ini ikut disimpan di spec. Rahasia koneksi tidak disimpan.
• Endpoint URL: Alamat API saat Get rows from = URL, dengan tombol Test URL. Alamat wajib https://. Alamat http:// ditolak dengan pesan "Endpoint URL must use https:// (insecure http:// is rejected)." dan Save Changes nonaktif. Sumber URL dipanggil tanpa token pengguna, jadi hanya API publik yang mengizinkan akses dari browser yang bisa dipakai.
• Root path: Letak daftar baris di dalam respons, misalnya data.items. Setelah Test call, path dicek langsung. Bila benar tampil "14 rows found at data.items" beserta daftar field. Bila salah tampil "No list at data.list" dan tombol untuk memakai path yang ditemukan.
• Columns: Daftar kolom tabel. Kolom ditambah lewat Add column, bisa diurutkan, atau diisi otomatis lewat Fill from response. Tiap kolom punya judul EN & ID, field dari respons (misalnya owner.name), dan format:
  • Text
  • Progress bar (%)
  • Status pill
  • Date
  • Number
• Rows per page: Jumlah baris per halaman, 5, 10, atau 20.
• Empty-state text: Teks dalam EN & ID yang tampil bila tidak ada baris.
• Filter by process variable (tab Logic): Bila aktif, tabel hanya menampilkan baris yang cocok dengan nilai sebuah process variable di task ini.
  • Process variable: Variabel yang nilainya dipakai sebagai pembanding.
  • Matches field: Field di respons yang dibandingkan dengan variabel itu. Bila field tidak ada di respons uji, tampil "Field "team.code" not found in test response".
• Validation: Tidak ada aturan validasi. Tabel baca-saja tidak punya Required, dan kegagalan memuat data tidak pernah menahan Submit.

Perilaku saat diisi

• Selama data dimuat, hanya tabel yang menampilkan skeleton. Field lain tetap bisa diisi.
• Tabel dibagi per halaman sesuai Rows per page, dengan teks seperti "Showing 6–8 of 8".
• Klik judul kolom untuk mengurutkan naik, klik lagi untuk mengurutkan turun.
• Bila tidak ada baris, tampil "Nothing to show" dan Empty-state text.
• Bila data gagal dimuat, tampil "Couldn't load …" dan tombol Retry. Complete Task tetap bisa dilakukan.
• Bila filter aktif, di atas tabel tampil keterangan filter dan nilainya, misalnya "Filtered by department · product".
• Di layar di bawah 640 px, setiap baris tampil sebagai kartu dengan pilihan "Sort by".