ماکروهای VBA را به Apps Script تبدیل کنید

قبل از اینکه شروع کنی

ممکن است بخواهید APIهای ناسازگار را در کد VBA خود قبل از تبدیل فایل‌هایتان به‌روزرسانی کنید. برای فایل‌هایی که وضعیت «دقیقاً پشتیبانی‌شده » دارند، می‌توانید به مرحله ۱: تبدیل فایل‌هایتان بروید.

APIهای VBA ناسازگار را اصلاح کنید

برای فایل‌هایی که وضعیت «پشتیبانی‌شده با راه‌حل» یا «نیازمند بررسی» دارند، می‌توانید راه‌حل‌ها و اصلاحات خود را پس از تبدیل در Apps Script اعمال کنید، اما توصیه می‌کنیم قبل از تبدیل فایل‌های خود، ابتدا کد VBA که با آن آشنا هستید را اصلاح کنید.

برای هر API که در گزارش سازگاری با عنوان «پشتیبانی‌شده با راه‌حل جایگزین» یا «نیازمند بررسی» علامت‌گذاری شده است، موارد زیر را توصیه می‌کنیم:

  • اگر تابعی که توسط API انجام می‌شود برای عملکرد صحیح ماکروی VBA شما حیاتی نیست، آن را از کد VBA خود حذف کنید. اگر چنین است، کد خود را تغییر دهید تا رفتار مشابهی را با APIهای VBA پشتیبانی‌شده پیاده‌سازی کند.
  • برای APIهایی که وضعیتشان با « پشتیبانی با راه‌حل» مشخص شده است ، اگر نمی‌توانید به APIهای VBA پشتیبانی‌شده تغییر دهید، APIهای VBA خود را به همان شکل باقی بگذارید. پس از تبدیل به Apps Script، یک راه‌حل شناخته‌شده برای این API در نظرات کد Apps Script تبدیل‌شده توصیه می‌شود.
  • اگر مشکل از یک ساختار زبانی پیاده‌سازی نشده ناشی می‌شود، کد خود را بازنویسی کنید تا از استفاده از آن ساختارها خودداری کنید.

  • برای APIهایی با وضعیت « نیاز به بررسی» ، بررسی کنید که آیا کد شما شامل هر یک از APIهای زیر است یا خیر:

    • Adodb.connection
    • CreateObject : این API اغلب برای اتصال به پایگاه داده و نرم‌افزار برنامه‌ریزی منابع سازمانی استفاده می‌شود.
    • Shell.execute
    • OleObject

    اگر بله، توصیه می‌کنیم فایل‌هایی را که این APIها به آنها تعلق دارند تبدیل نکنید و گزینه‌های دیگر را بررسی کنید. این APIها معمولاً عملیات حیاتی برای یک ماکرو، مانند اتصال به پایگاه داده یا دسترسی به یک منبع محلی، انجام می‌دهند و Apps Script معمولاً راه حل خوبی نیست.

مرحله ۱: تبدیل فایل‌ها

  1. در رایانه‌تان، گوگل درایو را باز کنید.
  2. در پنل سمت راست، روی افزونه‌ی Macro Converter کلیک کنید. نماد تبدیل ماکرو اگر پنل کناری را نمی‌بینید، در پایین سمت راست، روی نمایش پنل کناری کلیک کنید.
  3. روی «افزودن فایل‌ها و پوشه‌ها» کلیک کنید. مبدل ماکرو فقط فایل‌های اکسل را تشخیص می‌دهد.
  4. فایل‌ها یا پوشه‌هایی را که می‌خواهید تبدیل کنید انتخاب کنید و روی «انتخاب» کلیک کنید. کمتر از ۲۰۰۰ فایل را همزمان انتخاب کنید.
  5. برای تغییر محل ذخیره فایل‌های تبدیل‌شده، روی پوشه مقصد (Change destination folder edit) کلیک کنید و پوشه مورد نظر خود را انتخاب کنید. در غیر این صورت، فایل‌ها در پوشه MyDrive شما ذخیره می‌شوند.
  6. روی تبدیل کلیک کنید.
  7. وقتی تبدیل کامل شد، روی «مشاهده نتایج» کلیک کنید.

مرحله ۲: فایل‌های تبدیل‌شده خود را آزمایش کنید

کد اسکریپت برنامه‌ها را اجرا کنید

پس از تبدیل فایل‌هایتان، توابع Apps Script را آزمایش کنید. فایل‌های تبدیل‌شده را با داده‌هایی که معمولاً با فایل‌های اکسل خود استفاده می‌کنید، آزمایش کنید. در صورت امکان، خروجی فایل‌های Sheets تبدیل‌شده خود را با خروجی فایل‌های اکسل اصلی خود مقایسه کنید.

محرک‌های خود را آزمایش کنید

اگر فایل‌های شما حاوی triggerهایی مانند onOpen() ، onEdit() یا onClick() هستند، triggerهای خود را نیز آزمایش کنید. برخی از triggerهای VBA به طور خودکار تبدیل نمی‌شوند و باید در Apps Script به آنها رسیدگی شود. به بخش «رفع مشکلات رایج» مراجعه کنید.

بررسی فایل‌های ReadMe

اگر یک فایل ReadMe همراه با فایل تبدیل‌شده‌ی شما ایجاد شده است، مشکلات تبدیل ذکر شده در فایل ReadMe را بررسی کنید.

  • اگر مشکلات ممکن است برای مواردی که آزمایش نکرده‌اید مشکل‌ساز باشند، تغییرات توصیه‌شده را در کد خود اعمال کنید.
  • اگر همه سناریوهای ممکن را آزمایش کرده‌اید و همه چیز طبق برنامه پیش می‌رود، احتمالاً نیازی به ایجاد تغییرات ندارید.

مرحله ۳: رفع خطاها

اگر هنگام آزمایش فایل‌های خود با خطا مواجه شدید، به بخش رفع خطاها در کد تبدیل‌شده مراجعه کنید.

اگر کد بدون خطا اجرا شد، اما نتیجه آن چیزی نبود که انتظار داشتید، فایل ReadMe مربوط به فایل را باز کنید. هر بخش را مرور کنید تا مشخص شود چه چیزی باعث ایجاد مشکل شده و راه‌حل پیشنهادی را اعمال کنید.

پس از رفع خطاها، دوباره فایل را آزمایش کنید تا مطمئن شوید همه چیز طبق برنامه پیش می‌رود.