تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
"محوّل الماكرو" هو إضافة تسهّل تحويل ملفات Excel التي تتضمّن رمز Visual Basic for Applications (VBA) إلى ملفات "جداول بيانات Google" و"برمجة تطبيقات Google". يمكنك استخدام إضافة "مُحوّل الماكرو" لتحديد مدى توافق ملفاتك وتحويلها تلقائيًا.
قبل البدء
لاستخدام Macro Converter، اتّبِع الخطوات التالية:
يجب أن يكون لديك حساب على Google Workspace Enterprise Plus أو Google Workspace for Education Plus.
يجب أن تكون لديك بعض الخبرة في استخدام Excel أو "جداول بيانات Google" ولغات البرمجة النصية (VBA أو Apps Script).
يجب أن تكون قادرًا على قراءة النصوص البرمجية الأساسية وفهمها.
في أعلى يسار الصفحة، انقر على تثبيت > متابعة > السماح.
قد تستغرق عملية التثبيت عدة ثوانٍ. بعد تثبيت الإضافة، انقر على
تم.
بعد تثبيت الإضافة، يمكنك العثور عليها في Google Drive، في اللوحة الجانبية اليمنى. إذا لم تظهر اللوحة الجانبية، انقر على رمز "إظهار اللوحة الجانبية" chevron_left في أسفل يسار الصفحة.
تعديل رمز VBA باستخدام المعلومات الواردة في تقرير التوافق
إذا كان الرمز متوافقًا تمامًا، قد لا تحتاج إلى إجراء تغييرات.
إذا كان رمز VBA يتضمّن واجهات برمجة تطبيقات لا يمكن تحويلها بسهولة إلى رمز برمجة تطبيقات Google، يقدّم التقرير حلولاً بديلة في "برمجة تطبيقات Google". يمكنك تنفيذ الحلول البديلة في Apps Script بعد تحويل ملفاتك، ولكن إذا كنت معتادًا على استخدام VBA، قد يكون من الأفضل إنشاء حلول بديلة في VBA وتنفيذها قبل تحويل ملفاتك.
بعد إجراء تغييرات على رمز VBA، شغِّل تقرير التوافق مرة أخرى.
تساعد هذه الخطوة في تأكيد التوافق المتزايد لملفاتك وعلاماتك، كما تحدّد أي تحديثات إضافية يجب إجراؤها.
كرِّر الخطوتين 2 و3 حسب الحاجة. تساعد هذه الخطوات في زيادة توافق ملفاتك إلى أقصى حد لتقليل العمل المطلوب بعد تحويلها. يمكنك الانتقال إلى الخطوة التالية إذا كنت تخطّط لإنهاء تطبيق الحلول البديلة بعد تحويل ملفاتك.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
