یک فایل اکسل با ماکروهای ویژوال بیسیک برای برنامهها (VBA) در صورتی سازگار در نظر گرفته میشود که تمام APIهای استفاده شده در ماکروها معادل مستقیمی در Apps Script داشته باشند. اگر ماکروهای شما کاملاً سازگار نیستند، ممکن است بتوانید راهحلهایی را اعمال کنید یا کد را طوری تنظیم کنید که با Apps Script کار کنند.
از گزارش سازگاری مبدل ماکرو استفاده کنید تا مشخص شود که آیا میتوانید فایلهای خود را به صورت خودکار به همان صورت تبدیل کنید یا نیاز به ایجاد تنظیماتی در کد خود دارید.
وقتی گزارش سازگاری ایجاد میکنید، یکی از وضعیتهای زیر برای هر یک از فایلها و APIهای شما اعمال میشود:
| وضعیت | تعریف |
|---|---|
| دقیقاً پشتیبانی میشود | این فایلها حاوی APIهایی هستند که همگی معادلهای مستقیمی در Apps Script دارند. |
| با راهحلهای جایگزین پشتیبانی میشود | این فایلها حداقل شامل یک API هستند که میتوان با یک راهحل موقت از آن پشتیبانی کرد. |
| نیاز به بررسی بیشتر دارد | این فایلها حداقل حاوی یک API هستند که برای تعیین نحوهی ادامهی کار باید آن را بررسی کنید. برای مثال، ممکن است API معادلی وجود نداشته باشد، یا ممکن است مبدل ماکرو، API مورد استفاده را تشخیص نداده باشد. |
ایجاد گزارش سازگاری
- در رایانهتان، گوگل درایو را باز کنید.
- در پنل سمت راست، روی افزونهی Macro Converter کلیک کنید.
اگر پنل کناری را نمیبینید، در پایین سمت راست، روی نمایش پنل کناری کلیک کنید. - روی «افزودن فایلها و پوشهها» کلیک کنید. مبدل ماکرو فقط فایلهای اکسل را تشخیص میدهد.
- فایلها یا پوشههایی را که میخواهید تجزیه و تحلیل کنید انتخاب کنید و روی «انتخاب» کلیک کنید. کمتر از ۲۰۰۰ فایل را همزمان انتخاب کنید.
- برای تغییر محل ذخیره گزارش سازگاری خود، روی پوشه مقصد کلیک کنید و پوشه مورد نظر خود را انتخاب کنید. در غیر این صورت، در پوشه MyDrive شما ذخیره میشود.
- روی ایجاد گزارش کلیک کنید.
- وقتی تحلیل تمام شد، روی «مشاهده گزارش» کلیک کنید.
گزارش سازگاری را بررسی کنید
از جزئیات موجود در گزارش سازگاری برای تصمیمگیری در مورد نحوه تبدیل فایل خود استفاده کنید. گزارش شما شامل بخشهای زیر است:
- خلاصه : این برگه، تجزیه و تحلیل کلی از سازگاری تمام فایلهای ارسالی و APIهای آنها را ارائه میدهد.
- فایلها - سازگاری : این برگه، فهرستی از تمام فایلهای ارسالی به مبدل ماکرو را به همراه وضعیت سازگاری و جزئیات هر فایل ارائه میدهد.
فایلها - تحلیل دقیق : این برگه اطلاعات بیشتری در مورد APIهای درون یک فایل و اقداماتی که میتوانید برای تبدیل موفقیتآمیز هر API انجام دهید، ارائه میدهد. ابتدا، از منوی کشویی بالا، یک فایل را انتخاب کنید. سپس، از منوی کشویی پایین، یک وضعیت را انتخاب کنید.
همچنین میتوانید گزارش را به صورت API به API با استفاده از برگههایی به نام API برای بررسی و APIهایی با راهحلهای جایگزین بررسی کنید.
نحوه ادامه کار را مشخص کنید
در اینجا چیزی است که ما برای هر وضعیت توصیه میکنیم:
| وضعیت | توصیه |
|---|---|
| دقیقاً پشتیبانی میشود | همان منطق APIهای VBA شما در Apps Script قابل تکرار خواهد بود. تبدیل را ادامه دهید . |
| با راهحلهای جایگزین پشتیبانی میشود | شما باید کدی بنویسید که حداقل یک VBA API را با معادل Apps Script API جایگزین کند. به طور کلی، میتوانید تبدیل را ادامه دهید. شما میتوانید APIهای VBA که با عنوان Supported مشخص شدهاند را قبل یا بعد از تبدیل فایل، به صورت دستی با راهحلهای جایگزین جایگزین کنید. توصیه میکنیم تغییرات خود را از قبل انجام دهید . |
| نیاز به بررسی بیشتر دارد | حداقل یک API قابل تبدیل نیست. بسته به اهمیت آن API در کد شما، ممکن است نتوانید فایل را تبدیل کنید. کسی که کد VBA اصلی را میفهمد باید ارزیابی نهایی را انجام دهد. اگر تصمیم به تبدیل فایل خود دارید، باید کدی بنویسید که حداقل یک VBA API را با Apps Script جایگزین کند. میتوانید VBA APIهایی که با عنوان Needs Investigation علامتگذاری شدهاند را قبل یا بعد از تبدیل فایل، به صورت دستی جایگزین کنید. توصیه میکنیم تغییرات خود را از قبل انجام دهید . |
پس از ارزیابی گزارش سازگاری خود، به بخش تبدیل ماکروهای VBA به اسکریپت برنامهها مراجعه کنید.
مقالات مرتبط
- مرور کلی افزونهی مبدل ماکرو
- تبدیل ماکروهای VBA به اسکریپت برنامهها
- خطاهای موجود در کد تبدیل شده خود را برطرف کنید
- به مسائل رایج بپردازید
- آموزشهای تبدیل ماکرو را تماشا کنید
- فهرست APIهای VBA سازگار