Koneksi Synology Spreadsheet Dengan n8n Menggunakan API

 Pendahuluan

Di era digital saat ini, data adalah salah satu aset terpenting bagi setiap organisasi. Mengelola dan menganalisis data dengan efisien dapat meningkatkan produktivitas dan pengambilan keputusan. Salah satu cara untuk mengelola data adalah dengan menggunakan Spreadsheet, dan dalam artikel ini, kita akan membahas bagaimana cara menghubungkan Synology Spreadsheet dengan n8n menggunakan API Spreadsheet.

n8n adalah alat otomasi alur kerja yang memungkinkan pengguna untuk menghubungkan berbagai aplikasi dan layanan tanpa perlu menulis banyak kode. Dengan n8n, Anda dapat membuat integrasi antara berbagai sistem dan aplikasi dengan lebih mudah. Sebelum kita mulai, pastikan Anda telah menyiapkan Synology Spreadsheet dan memasang n8n di server Anda.

Mengapa Menggunakan n8n?

n8n menawarkan berbagai keuntungan bagi pengguna, antara lain:

• Tanpa Kode: Anda dapat membuat alur kerja dan mengintegrasikan aplikasi dengan antarmuka visual tanpa perlu menguasai bahasa pemrograman.

• Fleksibilitas: n8n mendukung berbagai aplikasi dan layanan, memungkinkan Anda untuk menghubungkan banyak sistem yang berbeda.

• Sumber Daya Terbuka: n8n adalah proyek open-source, sehingga Anda dapat berkontribusi atau memodifikasi sesuai kebutuhan Anda.

Langkah-langkah Koneksi Synology Spreadsheet dengan n8n

Berikut adalah langkah-langkah untuk menghubungkan Synology Spreadsheet dengan n8n:

1. Persiapkan Synology Spreadsheet

• Pastikan Anda memiliki akses ke Synology dan telah membuat Spreadsheet yang diperlukan. Catat URL dan kredensial yang diperlukan untuk mengakses API Spreadsheet.

2. Siapkan n8n

• Instal n8n di server Anda. Anda dapat menggunakan Docker atau mengikuti panduan instalasi di dokumentasi resmi n8n.

• Setelah terinstal, buka antarmuka n8n melalui browser web.

3. Buat Node API di n8n

• Di antarmuka n8n, buat alur kerja baru dan tambahkan node baru dengan memilih HTTP Request sebagai tipe node.

• Atur metode HTTP (GET, POST, PUT, DELETE) sesuai kebutuhan Anda untuk berinteraksi dengan API Spreadsheet Synology.

• Masukkan URL API Spreadsheet Anda dan pastikan untuk menambahkan kredensial jika diperlukan.

4. Konfigurasi Parameter API

• Jika API Anda memerlukan parameter tertentu (seperti ID Spreadsheet atau nama sheet), pastikan untuk menambahkannya di pengaturan node.

• Anda dapat menggunakan fitur n8n untuk menangani data yang diterima atau dikirim melalui API.

5. Tambahkan Node Tambahan

• Bergantung pada tujuan Anda, Anda mungkin perlu menambahkan node tambahan untuk memproses data lebih lanjut. Misalnya, Anda bisa menambahkan node fungsi untuk memanipulasi data sebelum mengirimkannya kembali ke Spreadsheet.

6. Uji Alur Kerja

• Setelah Anda mengatur semua node, lakukan pengujian untuk memastikan koneksi antara Synology Spreadsheet dan n8n berfungsi dengan baik.

• Periksa hasilnya di antarmuka n8n untuk memastikan data yang ditransfer sesuai dengan harapan.

7. Simpan dan Aktifkan Alur Kerja

• Setelah semua pengaturan selesai dan berhasil diuji, simpan alur kerja Anda dan aktifkan agar alur kerja dapat berjalan otomatis sesuai jadwal yang diinginkan.

8. Contoh

• Di sini kami menggunakan spreadsheet-api v3.4.1.

• Kunjungi server API anda untuk memperoleh token.

• Di contoh ini kita hanya akan memasukkan data baru ke sebuah spreadsheet.

Isikan: Token, Id spreadsheet yang digunakan. dan data yang akan dimasukkan.

Copy kode cURL untuk digunakan di langkah berikutnya.

Anda bisa membuat spreadsheet terlebih dahulu, atau juga bisa menggunakan api Spreadshet > Create. untuk lebih jelasnya lihat di menu sebelah kiri di serrver api.

Jika membuat dahulu di synology drive, Id bisa dilihat di search bar:

Semua langkah di atas bisa digantikan dengan script jika anda sudah paham alur kerjanya.

• Nah sekarang kita coba di n8n, di sini hanya akan menggunakan dua node:

On Form Submission dan HTTP Request

Di On Form Submission hanya berisikan kolom Email dan Tanggal

Dan di HTTP Request Paste kan saja cURL yang kita dapatkan dari server API (Contoh poin ke-3).

Ubah input JSON di bagian body dari 'Fixed' menjadi ‘Expression’ agar kita dapat memasukkan data dari form input dan meneruskannya ke API secara dinamis.

Berikut contoh untuk mendapatkan data dari form yang kita buat di awal. Dari input box Email dan Tanggal, dan di sini ditambah satu data lagi Timestamp untuk mengetahui kapan data dimasukkan.

{ "values": [ [ "{{ $json.email }}", "{{ $json.tanggal }}", "{{ $json.submittedAt.toDateTime().format('yyyy-MM-dd HH:mm')}}" ] ] }

Dan berikut hasilnya:

• Anda bisa mengembangkan contoh basic ini, misal menambahkan penanganan error dan lain-lain.

• Untuk keamanan, token hanya berlaku selama 28 hari, lihat bagian Headers:

Ini adalah token yang kita gunakan, jika anda ingin membuat Credential, gunakan data tersebut, langkahnya seperti berikut:

Di bagian Authentication, buat data autentikasi dengan memilih kredensial generik tipe Header Auth.

Dan isikan data:

Name: Authorization

Value: Bearer TOKEN_ANDA

Hapus Parameter Authorization di bagian Headers yang sudah tidak dipakai.

Jika masa berlaku token habis, tinggal edit Credential tanpa harus mengubah workspace yang sudah jadi, atau gunakan automation.

Kesimpulan

Menghubungkan Synology Spreadsheet dengan n8n menggunakan API Spreadsheet adalah langkah yang cerdas untuk meningkatkan efisiensi pengelolaan data. Dengan mengikuti langkah-langkah di atas, Anda dapat dengan mudah mengatur integrasi antara kedua platform ini dan mulai mengotomatiskan alur kerja Anda. Ingatlah untuk terus memantau dan menyesuaikan alur kerja Anda sesuai dengan kebutuhan yang berubah.

Selamat mencoba! Jika Anda memiliki pertanyaan atau pengalaman terkait integrasi ini, jangan ragu untuk meninggalkan komentar di bawah. Kami senang mendengar dari Anda, Sekian dan semoga bermanfaat.