Przekonwertuj makra VBA na Apps Script

Użyj dodatku Macro Converter, aby automatycznie przekonwertować pliki Excela z kodem Visual Basic for Applications (VBA) na Arkusze i Apps Script.

Zanim zaczniesz

Przed przekonwertowaniem plików warto zaktualizować w kodzie VBA niezgodne interfejsy API. W przypadku plików o stanie Dokładnie obsługiwany możesz przejść do kroku 1: konwertowanie plików.

Modyfikowanie niezgodnych interfejsów API VBA

W przypadku plików o stanie Obsługiwane z obejściem lub Wymaga analizy zagrożeń możesz zastosować obejścia i poprawki po konwersji w Apps Script, ale zalecamy, aby przed konwersją plików najpierw zmodyfikować kod VBA, który znasz.

W przypadku każdego interfejsu API oznaczonego w raporcie zgodności jako Obsługiwany z obejściem lub Wymaga sprawdzenia zalecamy wykonanie tych czynności:

  • Jeśli funkcja wykonywana przez interfejs API nie jest kluczowa dla makra VBA, usuń ją z kodu VBA. Jeśli funkcja jest kluczowa, zmień kod, aby zaimplementować podobne działanie za pomocą obsługiwanych interfejsów API VBA.

  • W przypadku interfejsów API obsługiwanych z obejściem, jeśli nie możesz znaleźć obsługiwanej alternatywy VBA, pozostaw kod VBA bez zmian. Po konwersji poszukaj zalecanych obejść w komentarzach do kodu Apps Script.

  • Jeśli problem wynika z niezastosowanego konstruktu językowego, zmień kod, aby uniknąć używania tych konstruktów.

  • W przypadku interfejsów API o stanie Wymaga sprawdzenia sprawdź, czy Twój kod zawiera któryś z tych interfejsów API:

    • Adodb.connection
    • CreateObject: ten interfejs API jest często używany do łączenia się z bazami danych i oprogramowaniem do planowania zasobów przedsiębiorstwa.
    • Shell.execute
    • OleObject

    Jeśli Twoje makra korzystają z tych interfejsów API, zastanów się, czy warto konwertować te pliki. Te interfejsy API zwykle zarządzają krytycznymi funkcjami, takimi jak łączność z bazą danych lub dostęp do lokalnego systemu, których Apps Script nie może łatwo replikować.

Krok 1. Przekonwertuj pliki

  1. Na komputerze otwórz Dysk Google.
  2. W panelu bocznym po prawej stronie kliknij dodatek Macro Converter Ikona konwertera makro. Jeśli nie widzisz panelu bocznego, w prawym dolnym rogu kliknij Pokaż panel boczny .
  3. Kliknij Dodaj pliki i foldery. Konwerter makr rozpoznaje tylko pliki Excela.
  4. Wybierz pliki lub foldery, które chcesz przekonwertować, i kliknij Wybierz. Wybieraj mniej niż 2000 plików naraz.
  5. Aby zmienić miejsce zapisywania przekonwertowanych plików, kliknij Zmień folder docelowy  i wybierz odpowiedni folder. W przeciwnym razie pliki zostaną zapisane w folderze Mój dysk.
  6. Kliknij Konwertuj.
  7. Po zakończeniu konwersji kliknij Wyświetl wyniki.

Krok 2. Przetestuj przekonwertowane pliki

Po przekonwertowaniu plików przetestuj je, aby upewnić się, że działają zgodnie z oczekiwaniami.

Uruchamianie kodu Apps Script

Po przekonwertowaniu plików przetestuj funkcje Apps Script. Przetestuj przekonwertowane pliki, używając danych, których zwykle używasz w plikach Excela. W miarę możliwości porównaj dane wyjściowe przekonwertowanych plików Arkuszy Google z danymi wyjściowymi oryginalnych plików Excela.

Testowanie aktywatorów

Jeśli pliki zawierają aktywatory, takie jak onOpen(), onEdit() lub onClick(), przetestuj je. Niektóre wyzwalacze VBA nie zostaną przekonwertowane automatycznie i muszą zostać obsłużone w Google Apps Script. Zobacz Rozwiązywanie typowych problemów.

Sprawdzanie plików ReadMe

Jeśli wraz z przekonwertowanym plikiem wygenerowano plik ReadMe, sprawdź problemy z konwersją wymienione w tym pliku.

  • Jeśli problemy mogą wystąpić w przypadkach, których nie przetestowano, wprowadź zalecane zmiany w kodzie.
  • Jeśli przetestujesz wszystkie możliwe scenariusze i wszystko będzie działać zgodnie z oczekiwaniami, prawdopodobnie nie musisz wprowadzać żadnych zmian.

Krok 3. Napraw błędy

Jeśli podczas testowania plików wystąpią błędy, zapoznaj się z artykułem Rozwiązywanie błędów w przekonwertowanym kodzie.

Jeśli kod działa bez błędów, ale wynik nie jest zgodny z oczekiwaniami, otwórz plik ReadMe. Przejrzyj każdą sekcję, aby określić przyczynę problemu i zastosować zalecane rozwiązanie.

Po naprawieniu błędów ponownie przetestuj plik, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.