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

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

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

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

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

Сгенерировать отчет о совместимости

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

Ознакомьтесь с отчетом о совместимости.

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

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

Если несколько файлов имеют одинаковое имя, используйте уникальные идентификаторы рядом с именами файлов, чтобы различать их. Откройте файлы в Google Диске и найдите уникальные идентификаторы в URL-адресах: https://drive.google.com/file/d/<file_identifier>/view .

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

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

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

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

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

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

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

После оценки отчета о совместимости перейдите к разделу «Преобразование макросов VBA в Apps Script» .