تحديد ما إذا كانت وحدات ماكرو VBA متوافقة

يُعتبر ملف Excel الذي يتضمّن وحدات ماكرو Visual Basic for Applications (VBA) متوافقًا إذا كانت جميع واجهات برمجة التطبيقات المستخدَمة في وحدات الماكرو لها مكافئ مباشر في Apps Script. إذا لم تكن وحدات الماكرو متوافقة بالكامل، قد تتمكّن من تطبيق حلول بديلة أو تعديل الرمز البرمجي لكي تعمل مع Apps Script.

استخدِم تقرير التوافق في "محوِّل وحدات الماكرو" لتحديد ما إذا كان بإمكانك تحويل ملفاتك تلقائيًا كما هي أو إذا كنت بحاجة إلى إجراء تعديلات على الرمز البرمجي.

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

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

إنشاء تقرير توافق

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

مراجعة تقرير التوافق

استخدِم التفاصيل الواردة في تقرير التوافق لمساعدتك في تحديد كيفية المتابعة في عملية تحويل الملفات. يتضمّن تقريرك الأقسام التالية:

  • الملخّص: تقدّم هذه الورقة تحليلاً مجمّعًا للتوافق بين جميع الملفات المرسَلة وواجهات برمجة التطبيقات الخاصة بها.
  • الملفات - التوافق: تعرض هذه الورقة كل ملف تم إرساله إلى "محوِّل الماكرو" مع حالة التوافق وتفاصيل كل ملف.

  • الملفات - التحليل التفصيلي: تقدّم هذه الورقة المزيد من المعلومات عن واجهة برمجة التطبيقات ضمن ملف والإجراءات التي يمكنك اتّخاذها لتحويل كل واجهة برمجة تطبيقات بنجاح. أولاً، اختَر ملفًا من القائمة المنسدلة في أعلى الصفحة. بعد ذلك، اختَر حالة من القائمة المنسدلة في أسفل الصفحة.

يمكنك أيضًا مراجعة التقرير حسب واجهة برمجة تطبيقات باستخدام جدولَي البيانات المُسمّيتَين واجهات برمجة التطبيقات التي يجب التحقيق فيها وواجهات برمجة التطبيقات التي تتضمّن حلولاً بديلة.

تحديد كيفية المتابعة

في ما يلي الإجراءات التي ننصح بها لكل حالة:

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

يمكنك استبدال واجهات برمجة تطبيقات VBA التي تم وضع علامة عليها بأنّها متوافقة مع الحلول البديلة يدويًا قبل تحويل الملف أو بعده. ننصحك بأن تُجري التغييرات مسبقًا.

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

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

بعد تقييم تقرير التوافق، اطّلِع على مقالة تحويل وحدات ماكرو Visual Basic for Applications إلى Apps Script.