تحويل وحدات ماكرو VBA إلى "برمجة تطبيقات Google"

استخدِم إضافة "محوّل الماكرو" لتحويل ملفات Excel التي تتضمّن رمز Visual Basic for Applications (VBA)‎ تلقائيًا إلى "جداول بيانات Google" و"برمجة تطبيقات Google".

قبل البدء

ننصحك بتعديل واجهات برمجة التطبيقات غير المتوافقة في رمز VBA قبل تحويل ملفاتك. بالنسبة إلى الملفات التي تحمل الحالة متوافق تمامًا، يمكنك الانتقال إلى الخطوة 1: تحويل ملفاتك.

تعديل واجهات برمجة تطبيقات VBA غير المتوافقة

بالنسبة إلى الملفات التي تحمل الحالة متوافق مع حل بديل أو يجب التحقيق فيها، يمكنك تطبيق الحلول البديلة والإصلاحات بعد التحويل في برمجة تطبيقات، ولكن ننصحك بتعديل رمز VBA الذي تعرفه أولاً قبل تحويل ملفاتك.

بالنسبة إلى كل واجهة برمجة تطبيقات تم تصنيفها على أنّها متوافقة مع حل بديل أو تحتاج إلى تحقيق في تقرير التوافق، ننصح بما يلي:

  • إذا لم تكن الوظيفة التي تنفّذها واجهة برمجة التطبيقات ضرورية لوحدة ماكرو VBA، أزِلها من رمز VBA. إذا كانت الدالة مهمة، غيِّر الرمز البرمجي لتنفيذ سلوك مشابه باستخدام واجهات برمجة تطبيقات VBA المتوافقة.

  • بالنسبة إلى واجهات برمجة التطبيقات المتاحة مع حلول بديلة، إذا لم تتمكّن من العثور على بديل متوافق مع VBA، اترك رمز VBA كما هو. بعد التحويل، ابحث عن الحلول البديلة المقترَحة في تعليقات رمز Apps Script.

  • إذا كانت المشكلة ناتجة عن بنية لغوية غير متوافقة، أعِد كتابة الرمز البرمجي لتجنُّب استخدام هذه البِنى.

  • بالنسبة إلى واجهات برمجة التطبيقات التي تحمل الحالة يجب التحقيق فيها، تحقَّق مما إذا كان الرمز يتضمّن أيًا من واجهات برمجة التطبيقات التالية:

    • Adodb.connection
    • ‫CreateObject: تُستخدَم واجهة برمجة التطبيقات هذه غالبًا للربط بقاعدة بيانات وبرامج تخطيط موارد المؤسسة.
    • Shell.execute
    • OleObject

    إذا كانت وحدات الماكرو تستخدم واجهات برمجة التطبيقات هذه، عليك إعادة النظر في تحويل هذه الملفات. تتولّى واجهات برمجة التطبيقات هذه عادةً إدارة وظائف مهمة، مثل الاتصال بقاعدة البيانات أو الوصول إلى النظام المحلي، وهي وظائف لا يمكن لـ "برمجة تطبيقات Google" تكرارها بسهولة.

الخطوة 1: تحويل ملفاتك

  1. على الكمبيوتر، افتح Google Drive.
  2. في اللوحة الجانبية على يسار الصفحة، انقر على إضافة "محوّل وحدات الماكرو" رمز "محوّل الماكرو". إذا لم تظهر اللوحة الجانبية، انقر على رمز إظهار اللوحة الجانبية في أسفل يسار الصفحة.
  3. انقر على إضافة ملفات ومجلدات. لا يتعرّف "محوّل الماكرو" إلا على ملفات Excel.
  4. اختَر الملفات أو المجلدات التي تريد تحويلها وانقر على اختيار. اختَر أقل من 2,000 ملف في المرة الواحدة.
  5. لتغيير مكان حفظ الملفات المحوّلة، انقر على "تغيير مجلد الوجهة" ، واختَر المجلد الذي تريده. وفي ما عدا ذلك، يتم حفظ الملفات في مجلد "ملفاتي".
  6. انقر على تحويل.
  7. عند اكتمال عملية التحويل، انقر على عرض النتائج.

الخطوة 2: اختبار الملفات المحوَّلة

بعد تحويل ملفاتك، اختبِرها للتأكّد من أنّها تعمل على النحو المتوقّع.

تشغيل الرمز البرمجي في "برمجة تطبيقات Google"

بعد تحويل ملفاتك، اختبِر دوال برمجة تطبيقات. اختبِر الملفات المحوَّلة باستخدام البيانات التي تستخدمها عادةً مع ملفات Excel. إذا أمكن، قارِن ناتج ملفات "جداول بيانات Google" المحوَّلة بناتج ملفات Excel الأصلية.

اختبار المشغِّلات

إذا كانت ملفاتك تحتوي على مشغّلات مثل onOpen() أو onEdit() أو onClick()، اختبِر المشغّلات أيضًا. لن يتم تحويل بعض مشغّلات VBA تلقائيًا، ويجب معالجتها في برمجة تطبيقات. التعرّف على المشاكل الشائعة

مراجعة ملفات ReadMe

إذا تم إنشاء ملف ReadMe مع الملف المحوَّل، راجِع مشاكل التحويل المدرَجة في ملف ReadMe.

  • إذا كانت المشاكل قد تؤدي إلى حدوث أخطاء في الحالات التي لم تختبرها، طبِّق التغييرات المقترَحة على الرمز البرمجي.
  • إذا اختبرت جميع السيناريوهات المحتملة وكان كل شيء يعمل على النحو المطلوب، من المحتمل ألا تحتاج إلى إجراء تغييرات.

الخطوة 3: إصلاح الأخطاء

إذا واجهت أخطاء أثناء اختبار ملفاتك، يمكنك الاطّلاع على إصلاح الأخطاء في الرمز المحوّل.

إذا تم تشغيل الرمز بدون أخطاء، ولكن النتيجة لم تكن كما توقعت، افتح ملف ReadMe الخاص بالملف. راجِع كل قسم للمساعدة في تحديد سبب المشكلة وتطبيق الحلّ المقترَح.

بعد إصلاح الأخطاء، اختبِر الملف مرة أخرى للتأكّد من أنّه يعمل كما هو مطلوب.