Makro Google Spreadsheet

Google Sheets memungkinkan Anda merekam makro yang menduplikasi serangkaian interaksi UI tertentu yang Anda tentukan. Setelah Anda merekam Anda dapat menautkannya ke pintasan keyboard dalam formulir Ctrl+Alt+Shift+Number. Anda dapat menggunakan pintasan tersebut untuk menjalankan langkah makro yang tepat lagi, biasanya di tempat yang berbeda atau pada data yang berbeda. Anda juga dapat mengaktifkan makro dari Ekstensi Google Spreadsheet Menu > Makro.

Saat Anda merekam makro, Google Spreadsheet akan otomatis membuat Apps Script (fungsi makro) yang mereplikasi langkah makro. Makro ditambahkan ke project Apps Script bound ke sheet, dalam file berjudul macros.gs. Jika tidak ada sudah ada sebuah file proyek yang terikat ke {i>sheet<i} dengan nama itu, fungsi makro ditambahkan ke dalamnya. Google Spreadsheet juga otomatis memperbarui skrip manifes project, yang mencatat nama dan pintasan keyboard yang ditetapkan ke makro.

Karena setiap makro yang direkam ditentukan seluruhnya dalam Apps Script, Anda dapat edit langsung di editor Apps Script. Anda bahkan dapat menulis makro dari awal di Apps Script, atau menggunakan fungsi yang telah Anda tulis dan mengubahnya menjadi makro.

Membuat makro di Apps Script

Anda dapat menggunakan fungsi yang ditulis dalam Apps Script dan menggunakannya sebagai fungsi makro. Cara termudah untuk melakukannya adalah dengan mengimpor fungsi yang ada dari Editor Google Spreadsheet.

Atau, Anda dapat membuat makro di dalam editor Apps Script dengan mengikuti langkah-langkah berikut:

  1. Di UI Google Spreadsheet, pilih Ekstensi &gt; Apps Script untuk membuka skrip yang terikat ke sheet di editor Apps Script.
  2. Tulis fungsi makro. Fungsi makro tidak boleh mengambil argumen dan ditampilkan tanpa nilai.
  3. Mengedit manifes skrip untuk membuat makro dan menautkannya ke fungsi makro. Tetapkan atribut pintasan dan nama {i>keyboard<i}.
  4. Simpan project skrip. Makro tersebut kemudian akan tersedia untuk digunakan di sheet.
  5. Uji fungsi makro di sheet untuk memverifikasi bahwa berfungsi sebagaimana mestinya.

Mengedit makro

Anda dapat mengedit makro yang dilampirkan ke sheet dengan melakukan hal berikut:

  1. Di UI Google Spreadsheet, pilih Ekstensi &gt; Makro &gt; Kelola makro.
  2. Cari makro yang ingin Anda edit, lalu pilih > Edit makro. Tindakan ini akan membuka editor Apps Script ke file project yang berisi fungsi makro.
  3. Edit fungsi makro untuk mengubah perilaku makro.
  4. Simpan project skrip. Makro tersebut kemudian akan tersedia untuk digunakan di sheet.
  5. Uji fungsi makro di sheet untuk memverifikasi bahwa berfungsi sebagaimana mestinya.

Mengimpor fungsi sebagai makro

Jika sudah ada skrip yang terikat ke sheet, Anda dapat mengimpor fungsi dalam skrip sebagai makro baru, lalu menetapkannya pintasan {i>keyboard<i}. Anda dapat melakukannya dengan mengedit manifes dan menambahkan elemen lain ke Properti sheets.macros[].

Atau, ikuti langkah-langkah ini untuk mengimpor fungsi sebagai makro dari UI Spreadsheet:

  1. Di UI Google Spreadsheet, pilih Ekstensi &gt; Makro &gt; Impor.
  2. Pilih fungsi dari daftar yang ditampilkan, lalu klik Tambahkan fungsi.
  3. Pilih untuk menutup dialog.
  4. Pilih Ekstensi &gt; Makro &gt; Kelola makro.
  5. Temukan fungsi yang baru saja Anda impor dalam daftar. Tetapkan keyboard unik ke makro. Anda juga dapat mengubah nama makro di sini; nama secara {i>default<i} adalah nama fungsi.
  6. Klik Perbarui untuk menyimpan konfigurasi makro.

Struktur manifes untuk makro

Cuplikan contoh file manifes berikut menunjukkan bagian dari manifes yang menentukan makro Google Spreadsheet. Bagian sheets dari manifes menentukan nama dan pintasan keyboard ditetapkan ke makro dan nama fungsi makro.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

Lihat Resource manifes makro Spreadsheet untuk mengetahui detail selengkapnya tentang cara pembuatan manifes makro Spreadsheet.

Praktik terbaik

Saat membuat atau mengelola makro di Apps Script, sebaiknya Anda mematuhi pedoman berikut.

  1. Makro berperforma lebih baik jika ringan. Jika memungkinkan, batasi jumlah tindakan yang dilakukan makro.
  2. Makro paling cocok untuk operasi hafalan yang perlu diulang sering kali dengan sedikit atau tanpa konfigurasi. Untuk operasi lainnya, pertimbangkan menggunakan item menu kustom sebagai gantinya.
  3. Selalu ingat bahwa pintasan keyboard makro harus unik, dan hanya dapat memiliki sepuluh makro dengan pintasan pada satu waktu. Tambahan apa pun makro hanya dapat dijalankan dari elemen Ekstensi &gt; Menu Makro.
  4. Makro yang membuat perubahan pada satu sel dapat diterapkan ke berbagai sel dengan memilih rentang penuh terlebih dahulu, lalu mengaktifkan makro. Ini berarti sering kali tidak perlu membuat makro yang menduplikasi operasi yang sama di seluruh rentang sel yang telah ditentukan.

Hal-hal yang tidak boleh dilakukan

Ada beberapa batasan pada apa yang dapat Anda lakukan dengan makro:

Menggunakan makro di luar skrip terikat

Makro ditentukan dalam skrip yang terikat dengan Google Spreadsheet tertentu. Makro definisi akan diabaikan jika didefinisikan dalam skrip mandiri atau aplikasi web.

Menentukan makro di add-on Spreadsheet

Anda tidak dapat mendistribusikan definisi makro menggunakan Add-on Spreadsheet. Semua definisi makro di Spreadsheet project add-on akan diabaikan oleh pengguna add-on tersebut.

Mendistribusikan makro di library skrip

Anda tidak dapat mendistribusikan definisi makro menggunakan Apps Script library.

Menggunakan makro di luar Google Spreadsheet

Makro hanya fitur di Google Spreadsheet, dan tidak ada di Google Dokumen, Formulir, atau Slide.