تحويل وحدات ماكرو 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: اختبار الملفات المحوَّلة

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

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

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

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

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

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

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

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

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

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

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