Определите, совместимы ли макросы VBA

Файл Excel с макросами Visual Basic для приложений (VBA) считается совместимым, если все API, используемые в макросах, имеют прямой эквивалент в Apps Script. Если ваши макросы не полностью совместимы, вы можете применить обходные пути или настроить код, чтобы они работали со скриптом приложений.

Используйте отчет о совместимости Macro Converter, чтобы определить, можете ли вы автоматически конвертировать файлы как есть или вам нужно внести изменения в свой код.

Когда вы создаете отчет о совместимости, к каждому из ваших файлов и API применяется один из следующих статусов:

Статус Определение
Поддерживается точно Эти файлы содержат API, которые имеют прямые эквиваленты в Apps Script.
Поддерживается обходными путями Эти файлы содержат по крайней мере один API, который может поддерживаться обходным путем.
Требуется дополнительное расследование Эти файлы содержат по крайней мере один API, который необходимо просмотреть, чтобы определить, что делать дальше. Например, эквивалентного API может не быть, или конвертер макросов не определил используемый API.

Создать отчет о совместимости

  1. На своем компьютере откройте Google Диск .
  2. На правой боковой панели щелкните надстройку «Конвертер макросов». Значок конвертера макросов . Если вы не видите боковую панель, в правом нижнем углу нажмите «Показать боковую панель .
  3. Нажмите «Добавить файлы и папки» . Конвертер макросов распознает только файлы Excel.
  4. Выберите файлы или папки, которые хотите проанализировать, и нажмите «Выбрать» . Выбирайте менее 2000 файлов одновременно.
  5. Чтобы изменить место сохранения отчета о совместимости, нажмите « папку назначения» и выберите нужную папку. В противном случае он сохраняется в папке MyDrive.
  6. Нажмите Создать отчет .
  7. После завершения анализа нажмите «Просмотреть отчет» .

Просмотрите отчет о совместимости

Используйте информацию в отчете о совместимости, чтобы решить, как продолжить преобразование файла. Ваш отчет включает в себя следующие разделы:

  • Сводка : на этом листе представлен совокупный анализ совместимости всех отправленных файлов и их API.
  • Файлы — совместимость : на этом листе перечислены все файлы, отправленные в Macro Converter, с указанием статуса совместимости и подробной информацией о каждом файле.

  • Файлы — подробный анализ . На этом листе представлена ​​дополнительная информация об API в файле и о том, какие действия можно предпринять для успешного преобразования каждого API. Сначала в верхнем раскрывающемся меню выберите файл. Затем в раскрывающемся меню внизу выберите статус.

Вы также можете просмотреть отчет по каждому API, используя листы под названием «API для исследования» и «API с обходными путями» .

Определите, как действовать

Вот что мы рекомендуем для каждого статуса:

Статус Рекомендация
Поддерживается точно Та же логика из ваших API-интерфейсов VBA будет воспроизведена в Apps Script. Продолжайте преобразование .
Поддерживается обходными путями Вам необходимо написать код, чтобы заменить хотя бы один API VBA эквивалентным API Apps Script. В общем, можно приступать к конвертации.

Вы можете вручную заменить API-интерфейсы VBA, помеченные как «Поддерживаемые», на обходные пути до или после преобразования файла. Мы рекомендуем внести изменения заранее .

Требуется дополнительное расследование По крайней мере один API невозможно преобразовать. В зависимости от важности этого API в вашем коде вы не сможете преобразовать файл. Окончательную оценку должен провести тот, кто понимает исходный код VBA.

Если вы решите преобразовать файл, вам необходимо написать код для замены хотя бы одного API VBA на Apps Script. Вы можете вручную заменить API VBA, помеченные как «Требует исследования» , до или после преобразования файла. Мы рекомендуем внести изменения заранее .

После оценки отчета о совместимости см. раздел Преобразование макросов VBA в скрипт приложений .