Przekonwertuj makra VBA na Apps Script

Zanim zaczniesz

Przed przekonwertowaniem plików może być konieczne zaktualizowanie niezgodnych interfejsów API w kodzie VBA. W przypadku plików o stanie Obsługiwane dokładnie możesz przejść do kroku 1. Przekonwertuj pliki.

Zmodyfikuj niezgodne interfejsy API VBA

W przypadku plików ze stanem Obsługiwane z obejściem obejścia lub Wymaga sprawdzenia po konwersji w Apps Script możesz zastosować obejścia i poprawki, ale zalecamy, aby przed konwersją plików zmodyfikować dobrze znany Ci kod VBA.

W przypadku każdego interfejsu API oznaczonego w raporcie zgodności jako Obsługiwany przy użyciu obejścia lub Wymaga dochodzenia zalecamy wykonanie tych czynności:

  • Jeśli funkcja wykonywana przez interfejs API nie jest kluczowa dla prawidłowego działania makra VBA, usuń ją z kodu VBA. Jeśli tak, zmień kod w taki sposób, aby zaimplementować podobne działanie w obsługiwanych interfejsach API VBA.
  • W przypadku interfejsów API o stanie Obsługiwane z obejściem problemu i nie możesz przełączyć się na obsługiwane interfejsy VBA API, nie zmieniaj ich. Po przejściu na Apps Script zalecamy znane obejście tego interfejsu API w komentarzach do przekonwertowanego kodu Apps Script.
  • Jeśli problem jest związany z niezaimplementowanym konstruktem językowym, przeredaguj kod tak, aby uniknąć korzystania z takich konstrukcji.

  • W przypadku interfejsów API ze stanem Wymaga dochodzenia 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 bazą danych i oprogramowaniem do planowania zasobów firmowych.
    • Shell.execute
    • OleObject

    Jeśli tak, zalecamy nie konwertować plików, do których należą te interfejsy API, i sprawdzić inne opcje. Te interfejsy API wykonują zwykle operacje o znaczeniu krytycznym dla makra, takie jak łączenie się z bazą danych lub uzyskiwanie dostępu do lokalnego zasobu. Apps Script zwykle nie jest dobrym rozwiązaniem.

Krok 1. Przekonwertuj pliki

  1. Na komputerze otwórz Dysk Google.
  2. W prawym panelu bocznym 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 programu Excel.
  4. Wybierz pliki lub foldery, które chcesz przekonwertować, i kliknij Wybierz. Wybierz 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

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 programu Excel. Jeśli to możliwe, porównaj dane wyjściowe przekonwertowanych plików Arkuszy z danymi wyjściowymi oryginalnych plików programu Excel.

Testowanie aktywatorów

Jeśli Twoje pliki zawierają aktywatory, takie jak onOpen(), onEdit() lub onClick(), przetestuj też reguły. Niektóre reguły VBA nie są konwertowane automatycznie i trzeba je rozwiązać w Apps Script. Zobacz Rozwiązywanie typowych problemów.

Przejrzyj pliki ReadMe

Jeśli z przekonwertowanym plikiem wygenerowany został plik ReadMe, sprawdź wymienione w nim problemy z konwersją.

  • Jeśli problemy mogą sprawiać problemy w przypadkach, które nie zostały przetestowane, zastosuj do kodu zalecane zmiany.
  • Jeśli po przetestowaniu wszystkich możliwych scenariuszy wszystko działa zgodnie z oczekiwaniami, prawdopodobnie nie musisz wprowadzać zmian.

Krok 3. Napraw błędy

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

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

Po naprawieniu błędów przetestuj plik jeszcze raz, aby mieć pewność, że wszystko działa zgodnie z oczekiwaniami.