با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Macro Converter افزونه‌ای است که تبدیل فایل‌های اکسل دارای کد ویژوال بیسیک برای برنامه‌ها (VBA) را به فایل‌های Google Sheets و Apps Script آسان‌تر می‌کند. می توانید از افزونه Macro Converter برای تعیین سازگاری فایل های خود و تبدیل خودکار آنها استفاده کنید.
قبل از شروع
برای استفاده از مبدل ماکرو:
شما باید یک حساب Google Workspace Enterprise Plus یا یک حساب Google Workspace for Education Plus داشته باشید.
شما باید تا حدی با Excel یا Google Sheets و زبان های برنامه نویسی (VBA یا Apps Script) مهارت داشته باشید.
شما باید بتوانید اسکریپت های اولیه را بخوانید و درک کنید.
در بالا سمت چپ، روی Install > Continue > Allow کلیک کنید.
نصب ممکن است چند ثانیه طول بکشد. پس از نصب افزونه، روی Done کلیک کنید.
پس از نصب، می‌توانید افزونه Macro Converter را در Google Drive ، در پانل سمت راست پیدا کنید. اگر پانل کناری را نمی‌بینید، در پایین سمت چپ، روی Show side panel chevron_left کلیک کنید.
کد VBA خود را با استفاده از اطلاعات گزارش سازگاری خود به روز کنید .
اگر کد شما کاملاً سازگار است، ممکن است نیازی به ایجاد تغییرات نداشته باشید.
اگر کد VBA شما دارای APIهایی است که به راحتی به کد Apps Script تبدیل نمی شوند، این گزارش راه حل هایی را در Apps Script ارائه می دهد. می‌توانید پس از تبدیل فایل‌های خود، راه‌حل‌های Apps Script را پیاده‌سازی کنید، اما اگر با VBA آشنایی بیشتری دارید، ممکن است بخواهید قبل از تبدیل فایل‌های خود، راه‌حل‌های VBA را ایجاد و پیاده‌سازی کنید.
پس از ایجاد تغییرات در کد VBA، دوباره گزارش سازگاری را اجرا کنید . این مرحله به تأیید افزایش سازگاری فایل‌های شما کمک می‌کند و هر به‌روزرسانی اضافی را که باید انجام شود، علامت‌گذاری می‌کند.
مراحل 2 و 3 را در صورت نیاز تکرار کنید . این مراحل سازگاری فایل‌های شما را به حداکثر می‌رساند تا میزان کار مورد نیاز پس از تبدیل آنها کاهش یابد. اگر قصد دارید پس از تبدیل فایل‌هایتان، راه‌حل‌های خود را به پایان برسانید، می‌توانید به مرحله بعدی بروید.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Macro Converter add-on helps convert Excel files containing VBA code to Google Sheets with Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eIt requires a Google Workspace Enterprise Plus or Education Plus account and basic scripting knowledge.\u003c/p\u003e\n"],["\u003cp\u003eThe conversion process involves generating a compatibility report, updating VBA code based on the report, and then converting the files.\u003c/p\u003e\n"],["\u003cp\u003eUsers may need to address errors and common issues after conversion to ensure functionality in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eDetailed guides and tutorials are available for compatibility checks, conversion steps, error fixing, and addressing common issues.\u003c/p\u003e\n"]]],[],null,["# Macro Converter add-on overview\n\nThe Macro Converter is an add-on that makes it easier to convert Excel files\nthat have Visual Basic for Applications (VBA) code to Google Sheets files and\nApps Script. You can use the Macro Converter add-on to determine the\ncompatibility of your files and automatically convert them.\n| **Note:** You can only use the Macro Converter add-on with Excel files. We support file formats from Excel 97 and above.\n\nBefore you begin\n----------------\n\nTo use the Macro Converter:\n\n- You must have a Google Workspace Enterprise Plus account or a Google Workspace for Education Plus account.\n- You should have some proficiency with Excel or Google Sheets and scripting languages (VBA or Apps Script).\n- You should be able to read and understand basic scripts.\n\nInstall the Macro Converter add-on\n----------------------------------\n\n1. On your computer, go to the [Macro Converter add-on on Google Workspace Marketplace](https://gsuite.google.com/marketplace/app/converter_alpha/383201976440).\n2. At the top right, click **Install** \\\u003e **Continue** \\\u003e **Allow**.\n3. Installation might take several seconds. Once the add-on is installed, click **Done**.\n\n| **Note:** If you're a Google Workspace administrator, you can install the Macro Converter add-on in your organization's domain and choose who can use the app. See [Install Google Workspace Marketplace apps in your domain](https://support.google.com/a/answer/172482).\n\nOnce installed, you can find the Macro Converter add-on in [Google Drive](https://drive.google.com/drive/my-drive), on the right side panel. If you don't see the side panel, at\nthe bottom right, click Show side panel chevron_left.\n\nHow to use the Macro Converter\n------------------------------\n\n1. **Generate a compatibility report for the files you want to convert** . See [Determine if VBA macros are compatible with Apps Script](/apps-script/guides/macro-converter/compatibility-report).\n2. **Update your VBA code using the information from your compatibility report** .\n 1. If your code is fully compatible, you might not need to make changes.\n 2. If your VBA code has APIs that won't easily convert to Apps Script code, the report offers workarounds in Apps Script. You can implement the Apps Script workarounds after you convert your files, but if you're more familiar with VBA you might want to create and implement VBA workarounds before you convert your files.\n3. **After you make changes to your VBA code, run the compatibility report again**. This step helps confirm the increased compatibility of your files and flags any additional updates that should be made.\n4. **Repeat steps 2 and 3 as needed**. These steps maximize the compatibility of your files to reduce the amount of work needed after you convert them. You can proceed to the next step if you plan to finish applying your workarounds after you convert your files.\n5. [**Convert your files**](/apps-script/guides/macro-converter/convert-files).\n6. [**Fix errors**](/apps-script/guides/macro-converter/fix-conversion-errors). You might need to make adjustments to your new Apps Script code to make sure your code works as intended.\n7. [**Address common issues**](/apps-script/guides/macro-converter/address-conversion-issues). You might need to manually create items, like VBA UserForms, in Apps Script.\n\nRelated articles\n----------------\n\n- [Determine if VBA macros are compatible](/apps-script/guides/macro-converter/compatibility-report)\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)"]]
