Tambahkan Fungsi Tersuai di Helaian Google: 5 Langkah

2024 Pengarang: John Day | [email protected]. Diubah suai terakhir: 2024-01-30 11:07

Saya yakin bahawa pada satu ketika dalam hidup anda, anda harus menggunakan perisian spreadsheet seperti Microsoft Excel atau Google Sheets.

Mereka agak mudah dan lurus ke depan untuk digunakan tetapi juga sangat kuat dan mudah dilanjutkan.

Hari ini, kita akan melihat Helaian Google dan kemampuannya untuk menambahkan kod dan fungsi tersuai sehingga kita dapat memperluasnya.

Langkah 1: Apakah Fungsi?

Fungsi adalah sekeping kod yang memanipulasi data dari spreadsheet untuk mengira nilai baru secara automatik untuk kita. Contoh fungsi yang sangat umum adalah SUM, yang mengira jumlah lajur atau kumpulan sel.

Semua perisian spreadsheet menyokong banyak fungsi seperti yang sudah ada sebelumnya tetapi mereka juga menyokong kemampuan untuk memperluasnya dan menulis sendiri.

Langkah 2: Bagaimana Menulis Fungsi Tersuai?

Untuk menulis fungsi khusus di Google Spreadsheet, kami menggunakan fitur yang disebut Apps Script yang merupakan platform pengembangan aplikasi yang cepat di mana kami dapat menulis kod dalam JavaScript secara langsung di penyemak imbas yang kemudian akan dijalankan di spreadsheet kami.

Untuk mula menulis kita boleh pergi ke Alat> Editor skrip di menu atas dan itu akan memunculkan editor kod dalam talian.

Di dalamnya, setelah dibuka pertama kali, kita akan mempunyai satu fail bernama Code.gs bersama dengan fungsi permulaan kosong, bernama myFunction.

Sebagai contoh permulaan, kita akan menamakan semula fungsi ini menjadi DOUBLE dan menambahkan parameter input dalam deklarasinya. Di dalam badan fungsi, kita perlu mengembalikan nilai dan untuk contoh ini, kita hanya akan mengalikan nilai input dengan 2.

Kita sekarang dapat menyimpan skrip dan jika kita kembali ke spreadsheet dan menambahkan beberapa data padanya, kita sekarang dapat merujuk fungsi ini di sel mana saja dan mengirimkan rujukan sel data sebagai input untuk nilai.

Ketika menjalankan fungsi ini, Google Sheets akan segera menampilkan pesan Loading di sel, tetapi kemudian akan menampilkan nilai yang dikembalikan dari fungsi tersebut.

Langkah 3: Batasan Fungsi dan Autolengkap

Fungsi-fungsi ini dapat melakukan apa sahaja yang kita mahukan tetapi ada beberapa batasan yang perlu kita ikuti seperti:

Nama mesti unik dan berbeza daripada yang digunakan oleh fungsi terbina dalam. Nama tidak boleh diakhiri dengan _, dan nama Fungsi biasanya ditulis dengan huruf besar, walaupun ini tidak diperlukan.

Setiap fungsi dapat mengembalikan satu nilai seperti dalam contoh kita tetapi juga dapat mengembalikan susunan nilai. Susunan ini kemudian akan dikembangkan ke sel yang berdekatan selagi kosong. Sekiranya tidak, kesalahan akan ditunjukkan.

Fungsi yang kami tulis boleh digunakan tetapi bagi orang lain yang mungkin mengedit dokumen itu tidak akan diketahui dan pengguna perlu mengetahui bahawa ia ada untuk menggunakannya. Kita boleh memperbaikinya dengan menambahkan fungsi ke senarai pelengkap automatik, sama seperti semua fungsi bawaan.

Untuk melakukan ini, kita perlu menambahkan tag JsDoc @customfunction di hadapan fungsi sebagai komen di mana dalam komen ini kita dapat menulis penjelasan ringkas mengenai fungsi kita.

Sekarang dengan komentar ditambahkan, ketika kita mulai menulis nama fungsi, fungsi akan ditawarkan oleh pelengkap otomatis, bersama dengan keterangan fungsi.

Langkah 4: Memanggil Perkhidmatan Luar

Kekuatan hebat yang dimiliki fungsi ini, berasal dari kemampuan untuk memanggil dan berinteraksi dengan alat dan perkhidmatan lain dari Google seperti Terjemahan, Peta, menyambung ke pangkalan data luaran, bekerja dengan XML dan lain-lain. Sejauh ini, ciri yang paling kuat bagi saya adalah kemampuan untuk membuat permintaan HTTP luaran ke API atau halaman web mana pun dan mendapatkan data darinya dengan menggunakan perkhidmatan UrlFetch.

Untuk menunjukkan ini, saya akan menempelkan fungsi yang akan menukar dolar AS ke franc Swiss tetapi tidak akan mengambil nilai mata wang tetapi sebaliknya, ia akan mengambilnya dari API luaran.

Fungsi ini juga menggunakan perkhidmatan cache terbina dalam di mana ia tidak akan memanggil API untuk semua pengiraan tetapi akan memanggilnya sekali untuk pengiraan pertama dan kemudian akan menyimpan nilai tersebut dalam cache.

Setiap pengiraan lain kemudian akan dibuat dengan nilai cache sehingga prestasi mereka akan bertambah baik dan kami tidak akan memukul pelayan yang selalunya kerana kadarnya tidak berubah dengan cepat.

Oleh kerana API mengembalikan JSON, setelah kami mendapat respons dari pelayan, kami perlu menguraikan JSON ke dalam objek dan kemudian kami dapat memperoleh laju, kalikan dengan nilai input dan kembalikan nilai baru yang dihitung ke sel.

Langkah 5: Langkah Seterusnya

Sekiranya anda merasakan ini menarik dan anda ingin mengetahui lebih lanjut, saya akan meninggalkan pautan di bawah untuk mendapatkan sumber tambahan.

developers.google.com/apps-script/guides/s…

developers.google.com/apps-script

Sekiranya anda menyukai Instructable, pastikan untuk melanggan saluran YouTube saya jika anda belum melakukannya dan periksa beberapa Instructables saya yang lain.

Sorakan dan terima kasih kerana membaca.