VBA makrolarını Apps Komut Dosyası'na dönüştürün
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Başlamadan önce
Dosyalarınızı dönüştürmeden önce VBA kodunuzdaki uyumsuz API'leri güncellemek isteyebilirsiniz. Durumu Tam olarak destekleniyor olan dosyalar için 1. adım: Dosyalarınızı dönüştürün bölümüne geçebilirsiniz.
Uyumsuz VBA API'lerini değiştirme
Geçici çözümle destekleniyor veya İncelenmesi gerekiyor durumundaki dosyalar için geçici çözümlerinizi ve düzeltmelerinizi Apps Komut Dosyası'nda dönüştürme işleminden sonra uygulayabilirsiniz. Ancak dosyalarınızı dönüştürmeden önce, aşina olduğunuz VBA kodunu değiştirmenizi öneririz.
Uyumluluk raporunda Geçici çözümle desteklenir veya İncelenmesi gerekiyor olarak işaretlenen her API için aşağıdakileri yapmanızı öneririz:
- API'nin gerçekleştirdiği işlev, VBA makronuzun düzgün çalışması için kritik öneme sahip değilse bu işlevi VBA kodunuzdan kaldırın. Bu durumda, kodunuzu desteklenen VBA API'leri ile benzer bir davranış uygulayacak şekilde değiştirin.
- Geçici çözümle desteklenir durumundaki API'ler için desteklenen VBA API'lerine geçemiyorsanız VBA API'lerinizi olduğu gibi bırakın. Apps Script'e dönüştürdükten sonra, dönüştürülen Apps Script kodunun yorumlarında bu API için bilinen bir geçici çözüm önerilir.
- Sorun uygulanmamış bir dil yapısından kaynaklanıyorsa bu yapıları kullanmamak için kodunuzu yeniden yazın.
Durumu İncelenmesi gerekiyor olan API'ler için kodunuzda aşağıdaki API'lerden herhangi birinin bulunup bulunmadığını kontrol edin:
Adodb.connectionCreateObject: Bu API genellikle veri tabanına ve kurumsal kaynak planlama yazılımına bağlanmak için kullanılır.Shell.executeOleObject
Evetse bu API'lerin ait olduğu dosyaları dönüştürmemenizi ve diğer seçenekleri incelemenizi öneririz. Bu API'ler genellikle bir makro için kritik işlemler (ör. veritabanına bağlanma veya yerel bir kaynağa erişme) gerçekleştirir ve Apps Komut Dosyası genellikle iyi bir çözüm değildir.
1. adım: Dosyalarınızı dönüştürün
- Bilgisayarınızda Google Drive'ı açın.
- Sağdaki yan panelde Macro Converter eklentisini
tıklayın. Yan paneli görmüyorsanız sağ altta Yan paneli göster'i chevron_left tıklayın.
- Dosya ve klasör ekle'yi tıklayın. Makro Dönüştürücü yalnızca Excel dosyalarını tanır.
- Dönüştürmek istediğiniz dosyaları veya klasörleri seçip Seç'i tıklayın. Tek seferde 2.000'den az dosya seçin.
- Dönüştürülen dosyalarınızın kaydedildiği yeri değiştirmek için Hedef klasörü değiştir'i edit tıklayın ve istediğiniz klasörü seçin. Aksi takdirde, dosyalar Drive'ım klasörünüze kaydedilir.
- Dönüştür'ü tıklayın.
- Dönüşüm tamamlandığında Sonuçları göster'i tıklayın.
2. adım: Dönüştürülen dosyalarınızı test edin
Apps Komut Dosyası kodunuzu çalıştırma
Dosyalarınızı dönüştürdükten sonra Apps Komut Dosyası işlevlerini test edin. Dönüştürülen dosyaları, normalde Excel dosyalarınızla kullandığınız verilerle test edin. Mümkünse dönüştürülmüş E-Tablolar dosyalarınızın çıkışını orijinal Excel dosyalarınızın çıkışıyla karşılaştırın.
Tetikleyicilerinizi test etme
Dosyalarınızda onOpen(), onEdit() veya onClick() gibi tetikleyiciler varsa tetikleyicilerinizi de test edin. Bazı VBA tetikleyicileri otomatik olarak dönüştürülmez ve Apps Komut Dosyası'nda ele alınması gerekir. Sık karşılaşılan sorunları ele alma başlıklı makaleyi inceleyin.
ReadMe dosyalarını inceleme
Dönüştürülen dosyanızla birlikte bir ReadMe dosyası oluşturulduysa ReadMe dosyasında listelenen dönüştürme sorunlarını inceleyin.
- Sorunlar, test etmediğiniz durumlar için sorun yaratabilir. Bu nedenle, önerilen değişiklikleri kodunuza uygulayın.
- Olası tüm senaryoları test ettiyseniz ve her şey beklendiği gibi çalışıyorsa muhtemelen değişiklik yapmanız gerekmez.
3. adım: Hataları düzeltin
Dosyalarınızı test ederken hatayla karşılaşırsanız Dönüştürülmüş kodunuzdaki hataları düzeltme başlıklı makaleye bakın.
Kod hatasız çalışmasına rağmen sonuç beklediğiniz gibi değilse dosyanın BeniOku dosyasını açın. Soruna neyin neden olduğunu belirlemek için her bölümü inceleyin ve önerilen düzeltmeyi uygulayın.
Hataları düzelttikten sonra, her şeyin beklendiği gibi çalıştığından emin olmak için dosyayı tekrar test edin.
İlgili makaleler
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThe Macro Converter add-on helps you convert your VBA macros to Apps Script, allowing them to run in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eBefore converting, review the compatibility report and modify or remove incompatible VBA APIs for better conversion results.\u003c/p\u003e\n"],["\u003cp\u003eThe conversion process involves adding files to the add-on, initiating the conversion, and then testing the converted Apps Script functions and triggers in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eIf errors occur or the results are unexpected, consult the generated ReadMe files and the troubleshooting documentation to fix issues and ensure proper functionality.\u003c/p\u003e\n"],["\u003cp\u003eAfter successful conversion and testing, your macros will be operational within Google Sheets, leveraging the capabilities of Apps Script.\u003c/p\u003e\n"]]],[],null,["# Convert VBA macros to Apps Script\n\nBefore you begin\n----------------\n\nYou might want to update incompatible APIs in your VBA code before you convert\nyour files. For files that have the status *Supported exactly* , you can proceed\nto [Step 1: Convert your files](/apps-script/guides/macro-converter/convert-files#step_1_convert_your_files).\n\n### Modify incompatible VBA APIs\n\nFor files that have the status *Supported with workaround* or *Needs\ninvestigation*, you can apply your workarounds and fixes after the conversion\nin Apps Script, but we recommend that you modify the VBA code that you're\nfamiliar with first, before you convert your files.\n\nFor each API marked as *Supported with workaround* or *Needs investigation* in\nthe compatibility report, we recommend the following:\n\n- If the function performed by the API isn't critical to your VBA macro working properly, remove it from your VBA code. If it is, change your code to implement a similar behavior with [supported VBA APIs](/apps-script/guides/macro-converter/compatible-vba-apis).\n- For APIs with the status *Supported with workaround*, if you can't switch to supported VBA APIs, leave your VBA APIs as is. After you convert to Apps Script, a known workaround for this API is recommended in the comments of the converted Apps Script code.\n- If the issue is coming from an [unimplemented language construct](/apps-script/guides/macro-converter/fix-conversion-errors#unimplemented_language_constructs), rewrite your code to avoid using those constructs.\n- For APIs with the status *Needs investigation*, check if your code contains\n any of the following APIs:\n\n - `Adodb.connection`\n - `CreateObject`: This API is often used to connect to database and enterprise resource planning software.\n - `Shell.execute`\n - `OleObject`\n\n If yes, we recommend that you don't convert the files these APIs belong to\n and investigate other options. These APIs tend to perform critical operations\n for a macro, like connecting to a database or accessing a local resource, and\n Apps Script is generally not a good solution.\n\nStep 1: Convert your files\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 convert and click **Select**. Select fewer than 2,000 files at a time.\n5. To change where your converted files are saved, click Change destination folder edit, and select the folder you want. Otherwise, the files are saved in your MyDrive folder.\n6. Click **Convert**.\n7. When the conversion completes, click **View results**.\n\nStep 2: Test your converted files\n---------------------------------\n\n### Run your Apps Script code\n\nAfter you convert your files, test the Apps Script functions. Test the converted\nfiles with the data you normally use with your Excel files. If possible, compare\nthe output of your converted Sheets files with the output of your original Excel\nfiles.\n\n### Test your triggers\n\nIf your files contain triggers like `onOpen()`, `onEdit()`, or `onClick()`, test\nyour triggers, too. Some VBA triggers won't convert automatically and need to be\naddressed in Apps Script. See [Address common issues](/apps-script/guides/macro-converter/address-conversion-issues).\n\n### Review ReadMe files\n\nIf a ReadMe file was generated with your converted file, review the conversion\nissues listed within the ReadMe file.\n\n- If the issues might be problematic for cases you haven't tested, apply the recommended changes to your code.\n- If you've tested all possible scenarios and everything works as intended, you probably don't need to make changes.\n\nStep 3: Fix errors\n------------------\n\nIf you run into errors while testing your files, see [Fix errors in your\nconverted code](/apps-script/guides/macro-converter/fix-conversion-errors).\n\nIf the code runs without errors, but the result isn't what you expected, open\nthe file's ReadMe file. Review each section to help determine what's causing the\nissue and apply the recommended fix.\n\nAfter you fix errors, test the file again to make sure everything works as\nintended.\n\nRelated articles\n----------------\n\n- [Macro Converter add-on overview](/apps-script/guides/macro-converter/overview)\n- [Determine if VBA macros are compatible](/apps-script/guides/macro-converter/compatibility-report)\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)"]]
