Sprawdzanie zgodności makr VBA

Plik Excela z makrami w języku Visual Basic for Applications (VBA) jest uznawany za zgodny, jeśli wszystkie interfejsy API używane w makrach mają bezpośredni odpowiednik w Apps Script. Jeśli makra nie są w pełni kompatybilne, możesz zastosować obejścia lub dostosować kod, aby działały w Apps Script.

Skorzystaj z raportu zgodności Konwertera makr, aby sprawdzić, czy możesz automatycznie przekonwertować pliki w obecnej postaci, czy też musisz wprowadzić zmiany w kodzie.

Gdy wygenerujesz raport zgodności, do każdego pliku i interfejsu API zostanie zastosowany jeden z tych stanów:

Stan Definicja
Dokładnie obsługiwane Pliki te zawierają interfejsy API, które mają bezpośrednie odpowiedniki w Apps Script.
Obsługiwane z obejściami Pliki te zawierają co najmniej 1 interfejs API, który można obsługiwać za pomocą obejścia.
Wymaga dalszej analizy Pliki te zawierają co najmniej 1 interfejs API, który musisz sprawdzić, aby określić, jak postępować dalej. Na przykład może nie być odpowiedniego interfejsu API lub konwerter makr nie mógł określić używanego interfejsu API.

Generowanie raportu zgodności

  1. Na komputerze otwórz Dysk Google.
  2. W panelu bocznym po prawej stronie kliknij dodatek do Google Workspace Macro Converter Ikona przedstawiająca dodatek Macro Converter. 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 przeanalizować, i kliknij Wybierz. Wybieraj mniej niż 2000 plików naraz.
  5. Aby zmienić miejsce zapisywania raportu zgodności, kliknij Zmień folder docelowy i wybierz odpowiedni folder. W innym przypadku zostanie zapisany w folderze Mój dysk.
  6. Kliknij Wygeneruj raport.
  7. Po zakończeniu analizy kliknij Wyświetl raport.

Sprawdź raport zgodności

Szczegóły w raporcie o zgodności pomogą Ci zdecydować, jak przeprowadzić konwersję pliku. Raport zawiera te sekcje:

  • Podsumowanie: ten arkusz zawiera zbiorczą analizę zgodności wszystkich przesłanych plików i ich interfejsów API.
  • Pliki – zgodność: ten arkusz zawiera listę wszystkich plików przesłanych do MacroConverter wraz ze stanem zgodności i szczegółami każdego pliku.
  • Pliki – szczegółowa analiza: ten arkusz zawiera więcej informacji o interfejsach API w pliku i o działaniach, które możesz wykonać, aby przekonwertować każdy interfejs API. Najpierw w menu u góry wybierz plik. Następnie w menu u dołu wybierz stan.

Jeśli kilka plików ma tę samą nazwę, obok nazw plików użyj unikalnych identyfikatorów, aby je odróżnić. Otwórz pliki na Dysku i poszukaj w adresach URL unikalnych identyfikatorów:https://drive.google.com/file/d/<file_identifier>/view

Możesz też sprawdzić raport dla poszczególnych interfejsów API, korzystając z arkuszy o nazwach APIs to investigate (Interfejsy API do zbadania) i APIs with workarounds (Interfejsy API z obejściami).

Zdecyduj, co chcesz zrobić

Oto nasze zalecenia dotyczące poszczególnych stanów:

Stan Rekomendacja
Dokładnie obsługiwane Tę samą logikę z interfejsów VBA API można odtworzyć w Apps Script. Przeprowadź konwersję.
Obsługiwane z obejściami Musisz napisać kod, który zastąpi co najmniej 1 interfejs VBA API odpowiednikiem interfejsu Apps Script API. Zwykle możesz kontynuować konwersję.

Interfejsy VBA API oznaczone jako obsługiwane z obejściami możesz zastąpić ręcznie przed przekonwertowaniem pliku lub po nim. Zalecamy wcześniejsze wprowadzenie zmian.

Wymaga dalszej analizy Nie udało się przekonwertować co najmniej jednego interfejsu API. W zależności od tego, jak ważne jest to API w Twoim kodzie, konwersja pliku może być niemożliwa. Osoba, która rozumie oryginalny kod VBA, powinna przeprowadzić ostateczną ocenę.

Jeśli zdecydujesz się przekonwertować plik, musisz napisać kod, który zastąpi co najmniej 1 interfejs VBA API interfejsem Apps Script. Ręcznie zastąp interfejsy API VBA oznaczone jako Wymaga sprawdzenia przed przekonwertowaniem pliku lub po nim. Zalecamy wcześniejsze wprowadzenie zmian.

Po przeanalizowaniu raportu zgodności zapoznaj się z artykułem Konwertowanie makr VBA na skrypty Apps Script.