Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
File Excel dengan makro Visual Basic for Applications (VBA) dianggap
kompatibel jika semua API yang digunakan dalam makro memiliki padanan langsung di Apps
Script. Jika makro Anda tidak sepenuhnya kompatibel, Anda mungkin dapat menerapkan solusi atau menyesuaikan kode agar berfungsi dengan Apps Script.
Gunakan laporan kompatibilitas Pengonversi Makro untuk menentukan apakah Anda dapat mengonversi file secara otomatis apa adanya atau apakah Anda perlu melakukan penyesuaian pada kode Anda.
Saat Anda membuat laporan kompatibilitas, salah satu status berikut diterapkan ke setiap file dan API Anda:
Status
Definisi
Didukung persis
File ini berisi API yang semuanya memiliki padanan langsung di Apps
Script.
Didukung dengan solusi
File ini berisi setidaknya satu API yang dapat didukung dengan solusi sementara.
Perlu penyelidikan lebih lanjut
File ini berisi setidaknya satu API yang perlu Anda tinjau untuk
menentukan cara melanjutkannya. Misalnya, mungkin tidak ada API yang setara, atau Pengonversi Makro mungkin belum menentukan API yang digunakan.
Di panel samping sebelah kanan, klik add-on Macro Converter .
Jika Anda tidak melihat panel samping, klik Tampilkan panel samping chevron_left di kanan bawah.
Klik Tambahkan file dan folder. Pengonversi Makro hanya mengenali file Excel.
Pilih file atau folder yang ingin Anda analisis, lalu klik Pilih. Pilih
kurang dari 2.000 file sekaligus.
Untuk mengubah tempat laporan kompatibilitas Anda disimpan, klik Ubah folder tujuan edit, lalu pilih folder yang Anda inginkan. Jika tidak, file akan disimpan di folder MyDrive Anda.
Klik Hasilkan laporan.
Setelah analisis selesai, klik Lihat laporan.
Meninjau laporan kompatibilitas
Gunakan detail dalam laporan kompatibilitas untuk membantu Anda memutuskan cara melanjutkan konversi file. Laporan Anda mencakup bagian berikut:
Ringkasan: Lembar ini memberikan analisis gabungan tentang kompatibilitas semua file yang dikirimkan dan API-nya.
File - kompatibilitas: Lembar ini mencantumkan setiap file yang dikirimkan ke Macro Converter dengan status kompatibilitas dan detail setiap file.
File - analisis mendetail: Lembar ini memberikan informasi selengkapnya tentang
API dalam file dan tindakan yang dapat Anda lakukan untuk berhasil mengonversi setiap
API. Pertama, dari menu dropdown atas, pilih file. Kemudian, dari menu dropdown di bagian bawah, pilih status.
Anda juga dapat meninjau laporan berdasarkan API menggunakan sheet yang disebut APIs to investigate dan APIs with workarounds.
Tentukan cara melanjutkan
Berikut rekomendasi kami untuk setiap status:
Status
Rekomendasi
Didukung persis
Logika yang sama dari API VBA Anda akan dapat direplikasi di Apps Script.
Lanjutkan konversi.
Didukung dengan solusi
Anda perlu menulis kode untuk mengganti setidaknya satu VBA API dengan
Apps Script API yang setara. Secara umum, Anda dapat melanjutkan konversi.
Anda dapat mengganti API VBA yang ditandai sebagai Didukung dengan
solusi secara manual sebelum atau setelah Anda mengonversi file. Sebaiknya Anda melakukan
perubahan terlebih dahulu.
Perlu penyelidikan lebih lanjut
Setidaknya satu API tidak dapat dikonversi. Bergantung pada pentingnya
API tersebut dalam kode Anda, Anda mungkin tidak dapat mengonversi file.
Seseorang yang memahami kode VBA asli harus melakukan evaluasi
akhir.
Jika memutuskan untuk mengonversi file, Anda perlu menulis kode untuk mengganti
setidaknya satu VBA API dengan Apps Script. Anda dapat mengganti secara manual
API VBA yang ditandai sebagai Perlu diselidiki baik sebelum atau setelah Anda
mengonversi file. Sebaiknya lakukan
perubahan Anda sebelumnya.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eVBA macros with direct Apps Script equivalents are considered compatible and can be automatically converted using the Macro Converter add-on.\u003c/p\u003e\n"],["\u003cp\u003eThe Macro Converter's compatibility report identifies files as "Supported exactly", "Supported with workarounds", or "Needs more investigation", guiding your conversion strategy.\u003c/p\u003e\n"],["\u003cp\u003eFor files needing workarounds or further investigation, manual code adjustments may be necessary before or after conversion using equivalent Apps Script APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe compatibility report provides detailed analysis at the file and API level to help assess conversion feasibility and required actions.\u003c/p\u003e\n"],["\u003cp\u003eAfter reviewing the report, proceed with file conversion, addressing potential issues as outlined in the documentation.\u003c/p\u003e\n"]]],[],null,["# Determine if VBA macros are compatible\n\nAn Excel file with Visual Basic for Applications (VBA) macros is considered\ncompatible if all APIs used in the macros have a direct equivalent in Apps\nScript. If your macros aren't fully compatible, you might be able to apply\nworkarounds or adjust the code to make them work with Apps Script.\n\nUse the Macro Converter's compatibility report to determine if you can\nautomatically convert your files as-is or if you need to make adjustments to\nyour code.\n\nWhen you generate a compatibility report, one of the following statuses is\napplied to each of your files and APIs:\n\n| Status | Definition |\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | These files contain APIs that all have direct equivalents in Apps Script. |\n| **Supported with workarounds** | These files contain at least one API that can be supported with a workaround. |\n| **Needs more investigation** | These files contain at least one API that you need to review to determine how to proceed. For instance, there might not be an equivalent API, or the Macro Converter might not have determined the API in use. |\n\nGenerate a compatibility report\n-------------------------------\n\n1. On your computer, open [Google Drive](https://drive.google.com/drive/my-drive).\n2. On the right side panel, click the Macro Converter add-on . If you don't see the side panel, at the bottom right, click Show side panel chevron_left.\n3. Click **Add files and folders**. The Macro Converter only recognizes Excel files.\n4. Choose the files or folders you want to analyze and click **Select**. Select fewer than 2,000 files at a time.\n5. To change where your compatibility report is saved, click Change destination folder edit, and select the folder you want. Otherwise, it's saved in your MyDrive folder.\n6. Click **Generate report**.\n7. When the analysis completes, click **View report**.\n\nReview the compatibility report\n-------------------------------\n\nUse the details in the compatibility report to help you decide how to proceed\nwith your file conversion. Your report includes the following sections:\n\n- **Summary**: This sheet gives an aggregated analysis of the compatibility of all submitted files and their APIs.\n- **Files - compatibility**: This sheet lists every file submitted to the Macro Converter with the compatibility status and details of each file.\n- **Files - detailed analysis**: This sheet gives more information about the\n APIs within a file and what actions you can take to successfully convert each\n API. First, from the top dropdown menu, select a file. Then, from the bottom\n dropdown menu, select a status.\n\n | **Note:** If multiple files have the same name, next to the file names, use the unique identifiers to tell the difference between them. You can open the files in Drive and look for the unique identifiers in the URLs: `https://drive.google.com/file/d/\u003cfile_identifier\u003e/view`.\n\nYou can also review the report on an API-by-API basis using the sheets called\n**APIs to investigate** and **APIs with workarounds**.\n\nDetermine how to proceed\n------------------------\n\nHere's what we recommend for each status:\n\n| Status | Recommendation |\n|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | The same logic from your VBA APIs will be replicable in Apps Script. [Proceed with the conversion](/apps-script/guides/macro-converter/convert-files). |\n| **Supported with workarounds** | You need to write code to replace at least one VBA API with the equivalent Apps Script API. In general, you can proceed with the conversion. You can manually replace the VBA APIs marked as *Supported with workarounds* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n| **Needs more investigation** | At least one API can't be converted. Depending on the importance of that API in your code, you might not be able to convert the file. Someone who understands the original VBA code should do the final evaluation. \u003cbr /\u003e If you decide to convert your file, you need to write code to replace at least one VBA API with Apps Script. You can manually replace the VBA APIs marked as *Needs investigation* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n\nAfter you assess your compatibility report, see [Convert VBA macros to Apps\nScript](/apps-script/guides/macro-converter/convert-files).\n\nRelated articles\n----------------\n\n- [Macro Converter add-on overview](/apps-script/guides/macro-converter/overview)\n- [Convert VBA macros to Apps Script](/apps-script/guides/macro-converter/convert-files)\n- [Fix errors in your converted code](/apps-script/guides/macro-converter/fix-conversion-errors)\n- [Address common issues](/apps-script/guides/macro-converter/address-conversion-issues)\n- [Watch Macro Converter tutorials](/apps-script/guides/macro-converter/tutorials)\n- [List of compatible VBA APIs](/apps-script/guides/macro-converter/compatible-vba-apis)"]]
.
Jika Anda tidak melihat panel samping, klik Tampilkan panel samping di kanan bawah.