המרת פקודות מאקרו VBA ל-Apps Script

לפני שמתחילים

מומלץ לעדכן ממשקי API לא תואמים בקוד VBA לפני שממירים את הקבצים. לקבצים שהסטטוס שלהם הוא נתמך בדיוק, אפשר להמשיך לשלב 1: המרת הקבצים.

שינוי ממשקי API של VBA שאינם תואמים

בקבצים עם הסטטוס התמיכה זמינה עם פתרון עקיף או נדרשת בדיקה, אפשר להחיל את הפתרונות והתיקונים אחרי ההמרה ב-Apps Script, אבל מומלץ לשנות קודם את קוד ה-VBA שאתם מכירים לפני שממירים את הקבצים.

לכל ממשק API שמסומן בדוח התאימות בתור נתמך עם פתרון עקיף או נדרשת בדיקה, מומלץ לבצע את הפעולות הבאות:

  • אם הפונקציה שמתבצעת על ידי ה-API לא קריטית לפעילות תקינה של המאקרו ב-VBA, אפשר להסיר אותה מקוד ה-VBA. אם כן, צריך לשנות את הקוד כך שיטמיע התנהגות דומה באמצעות ממשקי API נתמכים של VBA.
  • לממשקי API בסטטוס Supported with workaround, אם אין לכם אפשרות לעבור לממשקי API נתמכים של VBA, עליכם להשאיר את ממשקי ה-VBA כפי שהם. אחרי ההמרה ל-Apps Script, מומלץ להוסיף הערות לקוד המומר של Apps Script עם פתרון ידוע לבעיה ב-API הזה.
  • אם הבעיה נובעת ממבנה שפה שלא יושם, צריך לכתוב מחדש את הקוד כדי להימנע משימוש במבנים האלה.

  • בממשקי API עם הסטטוס נדרשת בדיקה, צריך לבדוק אם הקוד מכיל את אחד מממשקי ה-API הבאים:

    • Adodb.connection
    • CreateObject: ה-API הזה משמש לעתים קרובות לחיבור למסדי נתונים ולתוכנות לתכנון משאבים ארגוניים.
    • Shell.execute
    • OleObject

    אם כן, מומלץ לא להמיר את הקבצים של ממשקי ה-API האלה ולבדוק אפשרויות אחרות. ממשקי ה-API האלה נוטים לבצע פעולות קריטיות בפקודת מאקרו, כמו התחברות למסד נתונים או גישה למשאב מקומי, ו-Apps Script הוא בדרך כלל לא פתרון טוב.

שלב 1: ממירים את הקבצים

  1. במחשב, פותחים את Google Drive.
  2. בחלונית הצדדית השמאלית, לוחצים על התוסף Macro Converter הסמל של ממיר המאקרו. אם החלונית הצדדית לא מוצגת, לוחצים על סמל הצגת החלונית הצדדית בפינה השמאלית התחתונה.
  3. לוחצים על הוספת קבצים ותיקיות. התוסף Macro Converter מזהה רק קובצי Excel.
  4. בוחרים את הקבצים או התיקיות שרוצים להמיר ולוחצים על בחירה. בוחרים פחות מ-2,000 קבצים בכל פעם.
  5. כדי לשנות את המיקום שבו יישמרו הקבצים המומרים, לוחצים על 'שינוי תיקיית היעד' ובוחרים את התיקייה הרצויה. אחרת, הקבצים יישמרו בתיקייה 'האחסון שלי'.
  6. לוחצים על המרה.
  7. בסיום ההמרה, לוחצים על הצגת תוצאות.

שלב 2: בודקים את הקבצים המומרים

הרצת הקוד של Apps Script

אחרי שממירים את הקבצים, בודקים את הפונקציות של Apps Script. בודקים את הקבצים המומרים באמצעות הנתונים שבהם אתם משתמשים בדרך כלל בקובצי Excel. אם אפשר, כדאי להשוות את הפלט של קובצי Sheets שהומרו לפלט של קובצי Excel המקוריים.

בדיקת הטריגרים

אם הקבצים מכילים טריגרים כמו onOpen(),‏ onEdit() או onClick(), צריך לבדוק גם את הטריגרים. חלק מהטריגרים של VBA לא יומרו באופן אוטומטי, וצריך לטפל בהם ב-Apps Script. כדאי לעיין בקטע פתרון בעיות נפוצות.

בדיקת קובצי ReadMe

אם נוצר קובץ ReadMe עם הקובץ המומר, כדאי לבדוק את בעיות ההמרה שמפורטות בקובץ ReadMe.

  • אם הבעיות עלולות לגרום לבעיות בתרחישים שלא בדקתם, כדאי להחיל את השינויים המומלצים בקוד.
  • אם בדקתם את כל התרחישים האפשריים והכול פועל כמצופה, סביר להניח שאין צורך לבצע שינויים.

שלב 3: תיקון שגיאות

אם נתקלתם בשגיאות בזמן בדיקת הקבצים, תוכלו לעיין במאמר תיקון שגיאות בקוד המומר.

אם הקוד פועל ללא שגיאות אבל התוצאה לא כצפוי, פותחים את קובץ ה-ReadMe של הקובץ. כדאי לקרוא את כל הקטעים כדי לזהות את הגורם לבעיה ולהחיל את התיקון המומלץ.

אחרי שתתקנו את השגיאות, כדאי לבדוק שוב את הקובץ כדי לוודא שכל מה שרציתם לעשות מתבצע.