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

אפשר להשתמש בתוסף Macro Converter כדי להמיר באופן אוטומטי קובצי Excel עם קוד Visual Basic for Applications ‏ (VBA) ל-Sheets ול-Apps Script.

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

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

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

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

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

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

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

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

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

    • Adodb.connection
    • CreateObject: משתמשים ב-API הזה לעיתים קרובות כדי להתחבר למסדי נתונים ולתוכנות לתכנון משאבים ארגוניים (ERP).
    • 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. אם אפשר, כדאי להשוות את הפלט של קובצי Google Sheets שהומרו עם הפלט של קובצי Excel המקוריים.

בדיקת הגורמים המפעילים

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

בדיקת קובצי ReadMe

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

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

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

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

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

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