#NocoBase Eksternal

#Pendahuluan

Sumber data NocoBase eksternal dapat menghubungkan aplikasi NocoBase lain ke aplikasi saat ini, sekaligus mempertahankan metadata yang telah dikonfigurasi di aplikasi jarak jauh, seperti tabel data, antarmuka field, judul, dan field relasi.

Dibandingkan dengan sumber data database eksternal, setelah menghubungkan NocoBase eksternal biasanya tidak perlu mengonfigurasi ulang antarmuka field atau membuat field relasi secara manual. Selain melihat, menambah, mengedit, dan menghapus record, sumber data ini juga mendukung pengunggahan dan pratinjau file, impor dan ekspor, kueri grafik, serta beberapa skenario alur kerja.

#Menambahkan sumber data

Setelah mengaktifkan plugin, tambahkan sumber data NocoBase eksternal di 「Manajemen sumber data」, lalu isi informasi akses aplikasi jarak jauh.

Setelah sumber data diaktifkan, sistem akan memuat tabel data dari aplikasi jarak jauh.

#Penjelasan izin

Sumber data NocoBase eksternal dipengaruhi oleh izin aplikasi saat ini dan aplikasi jarak jauh.

• Aplikasi saat ini dapat mengonfigurasi izin akses untuk tabel dan field yang berbeda seperti sumber data eksternal lainnya;
• Sementara itu, aplikasi jarak jauh membaca dan mengoperasikan data terkait berdasarkan izin API key yang dikonfigurasi.

Sumber data NocoBase eksternal tidak mengembalikan metadata izin yang digunakan untuk mengontrol status tampilan tombol secara terperinci di sisi frontend. Oleh karena itu, beberapa tombol mungkin tidak otomatis disembunyikan berdasarkan izin seperti pada sumber data utama. Terlepas dari apakah tombol ditampilkan atau tidak, saat operasi dikirimkan, pemeriksaan izin tetap dilakukan oleh server aplikasi saat ini, dan operasi yang tidak diizinkan akan ditolak.

#Menggunakan tabel data

Setelah tabel data berhasil dimuat, pilih sumber data ini di konfigurasi halaman, konfigurasi blok, grafik, atau alur kerja untuk menggunakan tabel data dari aplikasi jarak jauh.

Setelah struktur tabel data di aplikasi jarak jauh berubah, tabel data harus dimuat ulang di aplikasi saat ini.

#Penjelasan fitur

Sumber data NocoBase eksternal terutama digunakan untuk menggunakan tabel data dan data dari aplikasi jarak jauh di aplikasi saat ini. Struktur tabel data, konfigurasi field, dan data aktual tetap dikelola oleh aplikasi jarak jauh.

#Tabel data dan field

Aplikasi saat ini akan memuat metadata seperti tabel data, antarmuka field, judul, dan field relasi dari aplikasi jarak jauh. Dibandingkan dengan sumber data database eksternal, biasanya tidak perlu mengonfigurasi ulang antarmuka field atau membuat field relasi secara manual di aplikasi saat ini.

Aplikasi saat ini tidak mendukung konfigurasi langsung field pada sumber data NocoBase eksternal. Jika perlu menambahkan field, menyesuaikan tipe field, atau mengubah field relasi, lakukan di aplikasi jarak jauh, lalu kembali ke aplikasi saat ini untuk memuat ulang tabel data.

#Record dan data relasi

Sumber data NocoBase eksternal mendukung penayangan, penambahan, pengeditan, dan penghapusan record di blok halaman, serta penayangan dan pemeliharaan data relasi. Operasi akan dimulai oleh aplikasi saat ini dan meminta aplikasi jarak jauh melalui API key yang dikonfigurasi.

#File dan lampiran

File akan diunggah ke penyimpanan yang digunakan aplikasi jarak jauh. Aplikasi saat ini bertanggung jawab mengirimkan permintaan unggah, pratinjau, dan unduh; file itu sendiri tidak disimpan di aplikasi saat ini.

Origin terutama digunakan untuk menangani alamat pratinjau file penyimpanan lokal aplikasi jarak jauh. Jika respons jarak jauh berupa jalur relatif, aplikasi saat ini akan menggunakan Origin untuk melengkapi alamat akses file. Origin harus diisi dengan alamat akses publik aplikasi NocoBase jarak jauh, misalnya:

https://example.com

Jangan isi alamat API sebagai Origin.

#Impor dan ekspor

Impor dan ekspor merupakan operasi sumber data melalui pembacaan dan penulisan file eksternal, dan semuanya akan diteruskan untuk dijalankan oleh aplikasi jarak jauh. Aplikasi saat ini bertanggung jawab menerima operasi pengguna, meneruskan permintaan, dan mengembalikan hasil unduhan; pembacaan dan penulisan data aktual dilakukan oleh aplikasi jarak jauh.

• Impor record: aplikasi saat ini menerima file impor yang diunggah dan meneruskannya ke aplikasi jarak jauh untuk menjalankan impor;
• E ekspor record: aplikasi saat ini meneruskan permintaan ke aplikasi jarak jauh untuk mengekspor record. Dalam mode sinkron, aliran file record yang dikembalikan oleh aplikasi jarak jauh akan diteruskan ke browser untuk diunduh; dalam mode asinkron, tugas asinkron lokal akan dibuat, ekspor record dimulai di aplikasi jarak jauh dan progresnya disinkronkan, lalu saat hasil diunduh, aliran file record diperoleh dari aplikasi jarak jauh.
• E ekspor lampiran: aplikasi saat ini meneruskan permintaan ke aplikasi jarak jauh untuk mengekspor lampiran. Dalam mode sinkron, paket lampiran yang dikembalikan oleh aplikasi jarak jauh akan diteruskan ke browser untuk diunduh; dalam mode asinkron, tugas asinkron lokal akan dibuat, ekspor lampiran dimulai di aplikasi jarak jauh dan progresnya disinkronkan, lalu saat hasil diunduh, aliran paket lampiran diperoleh dari aplikasi jarak jauh.

#Pencetakan template

Pencetakan template dapat menggunakan record dari sumber data NocoBase eksternal. Template dan konfigurasi tindakan pencetakan disimpan di aplikasi saat ini. Saat mencetak, aplikasi saat ini akan membaca record dan data relasi dari jarak jauh, lalu membuat file cetak di aplikasi saat ini.

#Grafik

#Papan kueri

Sumber data NocoBase eksternal dapat digunakan untuk papan kueri grafik. Aplikasi saat ini akan memproses parameter kueri berdasarkan grafik, sumber data, tabel data, dan izin field yang dikonfigurasi secara lokal, lalu meminta hasil dari aplikasi jarak jauh.

API key jarak jauh juga harus memiliki izin akses ke data terkait, jika tidak, kueri akan gagal.

#Papan SQL

Papan SQL merupakan mode kueri SQL pada grafik dan hanya digunakan untuk kueri. Aplikasi saat ini bertanggung jawab menyimpan konfigurasi SQL dan memulai pemanggilan, sedangkan SQL diteruskan ke aplikasi jarak jauh untuk dijalankan.

Saat menggunakan papan SQL, pengguna lokal harus memiliki izin konfigurasi UI di aplikasi saat ini, dan API key jarak jauh juga harus memiliki izin konfigurasi UI di aplikasi jarak jauh. SQL tidak akan menguraikan parameter kueri berdasarkan izin tabel data dan field seperti pada papan kueri. Berikan izin konfigurasi UI kepada pengguna lokal dan API key terkait dengan hati-hati.

#Alur kerja

Sumber data NocoBase eksternal dapat melibatkan dua rangkaian alur kerja, yaitu pada aplikasi saat ini dan aplikasi jarak jauh. Aplikasi saat ini merespons peristiwa dalam rangkaian permintaan halaman, tombol, dan API lokal; setelah aplikasi jarak jauh menerima permintaan yang diteruskan, aplikasi tersebut memprosesnya berdasarkan konfigurasi alur kerjanya sendiri.

Perlu diperhatikan bahwa aplikasi saat ini tidak memantau peristiwa penambahan, pembaruan, atau penghapusan yang terjadi di dalam tabel data jarak jauh. Peristiwa tabel data jarak jauh hanya akan dipicu di aplikasi jarak jauh.

#Pemicu

Tabel berikut menjelaskan pemicu yang dipengaruhi oleh sumber data NocoBase eksternal serta kondisi pemicunya di aplikasi saat ini dan aplikasi jarak jauh ketika alur kerja terkait diaktifkan.

Pemicu yang tidak bergantung pada sumber data akan dipicu di aplikasi saat ini dan aplikasi jarak jauh berdasarkan konfigurasi masing-masing.

Jika perlu menyusun alur untuk mengoperasikan data NocoBase eksternal di aplikasi saat ini, sebaiknya gunakan peristiwa sebelum permintaan, peristiwa setelah permintaan, atau peristiwa operasi khusus. Alur kerja yang sudah ada di aplikasi jarak jauh dijalankan secara independen oleh aplikasi jarak jauh.

#Node

Tabel berikut hanya mencantumkan node yang terkait dengan sumber data. Node umum seperti kondisi, perhitungan, perulangan, dan pemrosesan JSON tidak bergantung pada tipe sumber data dan dapat digunakan seperti biasa dalam alur kerja.

#Pertanyaan umum

#Tabel data tidak muncul

Periksa apakah sumber data telah diaktifkan serta apakah alamat API dan API key sudah benar. Aplikasi jarak jauh juga harus mengizinkan API key tersebut mengakses tabel data terkait.

#File berhasil diunggah tetapi tidak dapat dipratinjau

Jika aplikasi saat ini atau aplikasi jarak jauh menggunakan penyimpanan file lokal, periksa apakah Origin telah diisi dengan alamat akses publik aplikasi terkait. Origin tidak boleh diisi dengan alamat API.

#Aplikasi saat ini memiliki izin, tetapi operasi gagal

Periksa izin API key aplikasi jarak jauh. Sumber data NocoBase eksternal dipengaruhi oleh izin aplikasi saat ini dan izin aplikasi jarak jauh secara bersamaan.

#Tabel data tidak dapat digunakan setelah layanan jarak jauh mengalami gangguan

Jika aplikasi jarak jauh mengalami 502, mulai ulang, atau tidak tersedia sementara, aplikasi saat ini mungkin tidak dapat membaca metadata tabel data jarak jauh untuk sementara. Setelah layanan jarak jauh pulih, aplikasi saat ini akan memuat ulang metadata secara otomatis saat tabel data sumber tersebut diakses kembali.

#Mengapa field tidak dapat dikonfigurasi di aplikasi saat ini

Sumber data NocoBase eksternal menggunakan struktur tabel data dan konfigurasi field dari aplikasi jarak jauh. Sesuaikan field di aplikasi jarak jauh, lalu kembali ke aplikasi saat ini untuk memuat ulang tabel data.