Sprawdzanie zgodności makr VBA

Plik Excela z makro w języku Visual Basic for Applications (VBA) jest uważany za zgodny, jeśli wszystkie interfejsy API używane w makro mają bezpośredni odpowiednik w Apps Script. Jeśli makro nie jest w pełni zgodne, możesz zastosować obejście lub dostosować kod, aby działało z Google Apps Script.

Skorzystaj z raportu zgodności Konwertera makr, aby ustalić, czy możesz automatycznie konwertować pliki w postaci niezmienionej, 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 Te pliki zawierają interfejsy API, które mają bezpośrednie odpowiedniki w Apps Script.
Obsługiwane z obejściem Te pliki zawierają co najmniej 1 interfejs API, który może być obsługiwany za pomocą obejścia.
Wymaga dalszej analizy Te pliki zawierają co najmniej 1 interfejs API, który musisz sprawdzić, aby określić, jak kontynuować. Na przykład może nie być dostępnego równoważnego interfejsu API lub Konwerter makr może nie zidentyfikować używanego interfejsu API.

Generowanie raportu o zgodności

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

Sprawdzanie raportu zgodności

Na podstawie informacji w raporcie o zgodności możesz zdecydować, jak kontynuować konwertowanie plików. 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 Konwertera makr 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 oraz o działaniach, które możesz wykonać, aby pomyślnie przekonwertować każdy interfejs API. Najpierw w górnym menu wybierz plik. Następnie w dolnym menu wybierz stan.

Możesz też przeglądać raport dla poszczególnych interfejsów API, korzystając z arkuszy o nazwach Interfejsy API do zbadania i Interfejsy API z obejściem.

Określ, co chcesz zrobić

Oto, co zalecamy w przypadku każdego stanu:

Stan Rekomendacja
Dokładnie obsługiwane W Apps Script można odtworzyć tę samą logikę co w VBA API. Kontynuuj konwersję.
Obsługiwane z obejściem Musisz napisać kod, aby zastąpić co najmniej 1 interfejs VBA odpowiednim interfejsem Apps Script API. Ogólnie możesz kontynuować konwersję.

Przed lub po przekonwertowaniu pliku możesz ręcznie zastąpić interfejsy VBA oznaczone jako Obsługiwane z obejściem. Zalecamy, aby wprowadzić zmiany wcześniej.

Wymaga dalszej analizy Nie udało się przekonwertować co najmniej 1 interfejsu API. W zależności od znaczenia tego interfejsu API w kodzie możesz nie mieć możliwości przekonwertowania pliku. Ostateczną ocenę powinien przeprowadzić ktoś, kto rozumie pierwotny kod VBA.

Jeśli zdecydujesz się przekonwertować plik, musisz napisać kod, aby zastąpić co najmniej 1 interfejs VBA interfejsem Apps Script. Przed lub po przekonwertowaniu pliku możesz ręcznie zastąpić interfejsy VBA oznaczone jako wymagające sprawdzenia. Zalecamy wprowadzenie zmian wcześniej.

Po zapoznaniu się z raportami zgodności przeczytaj artykuł Konwertowanie makr VBA na Apps Script.