Mengonversi makro VBA ke Apps Script

Sebelum memulai

Sebaiknya perbarui API yang tidak kompatibel dalam kode VBA sebelum mengonversi file. Untuk file yang memiliki status Didukung persis, Anda dapat melanjutkan ke Langkah 1: Konversi file Anda.

Mengubah API VBA yang tidak kompatibel

Untuk file yang memiliki status Didukung dengan solusi sementara atau Perlu penyelidikan, Anda dapat menerapkan solusi sementara dan perbaikan setelah konversi di Apps Script, tetapi sebaiknya Anda mengubah kode VBA yang sudah Anda kuasai terlebih dahulu, sebelum mengonversi file.

Untuk setiap API yang ditandai sebagai Didukung dengan solusi sementara atau Perlu penyelidikan dalam laporan kompatibilitas, sebaiknya lakukan hal berikut:

  • Jika fungsi yang dilakukan oleh API tidak penting agar makro VBA Anda berfungsi dengan benar, hapus fungsi tersebut dari kode VBA Anda. Jika ya, ubah kode Anda untuk menerapkan perilaku serupa dengan API VBA yang didukung.
  • Untuk API dengan status Didukung dengan solusi, jika Anda tidak dapat beralih ke API VBA yang didukung, biarkan API VBA Anda seperti apa adanya. Setelah Anda mengonversi ke Apps Script, solusi yang diketahui untuk API ini direkomendasikan dalam komentar kode Apps Script yang dikonversi.
  • Jika masalah berasal dari konstruk bahasa yang tidak diterapkan, tulis ulang kode Anda untuk menghindari penggunaan konstruk tersebut.

  • Untuk API dengan status Perlu diselidiki, periksa apakah kode Anda berisi salah satu API berikut:

    • Adodb.connection
    • CreateObject: API ini sering digunakan untuk terhubung ke database dan software perencanaan resource perusahaan.
    • Shell.execute
    • OleObject

    Jika ya, sebaiknya Anda tidak mengonversi file yang termasuk dalam API ini dan mempelajari opsi lain. API ini cenderung melakukan operasi penting untuk makro, seperti terhubung ke database atau mengakses resource lokal, dan Apps Script umumnya bukan solusi yang baik.

Langkah 1: Konversi file Anda

  1. Di komputer Anda, buka Google Drive.
  2. Di panel samping kanan, klik add-on Macro Converter Ikon Pengonversi Makro. Jika Anda tidak melihat panel samping, di kanan bawah, klik Tampilkan panel samping .
  3. Klik Tambahkan file dan folder. Pengonversi Makro hanya mengenali file Excel.
  4. Pilih file atau folder yang ingin Anda konversi, lalu klik Pilih. Pilih kurang dari 2.000 file sekaligus.
  5. Untuk mengubah tempat file yang dikonversi disimpan, klik Ubah folder tujuan , lalu pilih folder yang Anda inginkan. Jika tidak, file akan disimpan di folder MyDrive Anda.
  6. Klik Konversikan.
  7. Setelah konversi selesai, klik Lihat hasil.

Langkah 2: Uji file yang dikonversi

Menjalankan kode Apps Script

Setelah mengonversi file, uji fungsi Apps Script. Uji file yang dikonversi dengan data yang biasanya Anda gunakan dengan file Excel Anda. Jika memungkinkan, bandingkan output file Spreadsheet yang dikonversi dengan output file Excel asli Anda.

Menguji pemicu

Jika file Anda berisi pemicu seperti onOpen(), onEdit(), atau onClick(), uji pemicu Anda juga. Beberapa pemicu VBA tidak akan dikonversi secara otomatis dan perlu ditangani di Apps Script. Lihat Mengatasi masalah umum.

Meninjau file ReadMe

Jika file ReadMe dibuat dengan file yang dikonversi, tinjau masalah konversi yang tercantum dalam file ReadMe.

  • Jika masalah tersebut mungkin menimbulkan masalah untuk kasus yang belum Anda uji, terapkan perubahan yang direkomendasikan pada kode Anda.
  • Jika Anda telah menguji semua kemungkinan skenario dan semuanya berfungsi sebagaimana mestinya, Anda mungkin tidak perlu melakukan perubahan.

Langkah 3: Perbaiki error

Jika Anda mengalami error saat menguji file, lihat Memperbaiki error dalam kode yang dikonversi.

Jika kode berjalan tanpa error, tetapi hasilnya tidak sesuai dengan yang Anda harapkan, buka file ReadMe file. Tinjau setiap bagian untuk membantu menentukan penyebab masalah dan terapkan perbaikan yang direkomendasikan.

Setelah Anda memperbaiki error, uji file lagi untuk memastikan semuanya berfungsi seperti yang diharapkan.