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

قبل البدء

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

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

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

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

  • إذا لم تكن الوظيفة التي تؤديها واجهة برمجة التطبيقات ضرورية لعمل ماكرو VBA بشكل صحيح، أزِلها من رمز VBA. إذا كان الأمر كذلك، عليك تغيير الرمز لتطبيق سلوك مشابه باستخدام واجهات برمجة التطبيقات المتوافقة مع VBA.
  • بالنسبة إلى واجهات برمجة التطبيقات التي تحمل الحالة متوافقة مع حل بديل، إذا لم تتمكّن من التبديل إلى واجهات برمجة التطبيقات المتوافقة مع Visual Basic for Applications، اترك واجهات برمجة التطبيقات هذه كما هي. وبعد التحويل إلى Apps Script، يُنصح باستخدام حل بديل معروف لواجهة برمجة التطبيقات هذه في تعليقات رمز Apps Script الذي تم تحويله.
  • إذا كانت المشكلة ناتجة عن بنية لغوية غير مفعَّلة، عليك إعادة كتابة الرمز البرمجي لتجنُّب استخدام هذه البنى.

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

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

    إذا كان الأمر كذلك، ننصحك بعدم تحويل الملفات التي تنتمي إليها واجهات برمجة التطبيقات هذه ودراسة خيارات أخرى. تميل واجهات برمجة التطبيقات هذه إلى تنفيذ عمليات مهمة للمخطّط البرمجي الكبير، مثل الربط بقاعدة بيانات أو الوصول إلى مورد محلي، و لا يشكّل Apps Script حلًا جيدًا بشكل عام.

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

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

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

تشغيل رمز Apps Script

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

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

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

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

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

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

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

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

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

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