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

Используйте надстройку Macro Converter для автоматического преобразования файлов Excel с кодом Visual Basic for Applications (VBA) в файлы Sheets и Apps Script.

Прежде чем начать

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

Изменить несовместимые API VBA

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

Для каждого API, отмеченного в отчете о совместимости как «Поддерживается с обходным решением» или «Требует проверки» , мы рекомендуем следующее:

  • Если функция, выполняемая API, не является критической для вашего макроса VBA, удалите её из кода VBA. Если же функция критическая, измените код, чтобы реализовать аналогичное поведение с использованием поддерживаемых API VBA .

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

  • Если проблема связана с нереализованной языковой конструкцией , перепишите свой код, чтобы избежать использования таких конструкций.

  • Для API со статусом «Требует проверки» проверьте, содержит ли ваш код какие-либо из следующих API:

    • Adodb.connection
    • CreateObject : Этот API часто используется для подключения к базам данных и программному обеспечению для планирования ресурсов предприятия.
    • Shell.execute
    • OleObject

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

Шаг 1: Преобразуйте ваши файлы.

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

Шаг 2: Проверьте преобразованные файлы.

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

Запустите код Apps Script.

После преобразования файлов протестируйте функции Apps Script. Проверьте преобразованные файлы, используя данные, которые вы обычно используете в файлах Excel. По возможности сравните результат преобразования файлов Google Sheets с результатом исходных файлов Excel.

Проверьте свои триггеры

Если ваши файлы содержат триггеры, такие как onOpen() , onEdit() или onClick() , протестируйте и их. Некоторые триггеры VBA не преобразуются автоматически и требуют обработки в Apps Script. См. раздел «Устранение распространенных проблем» .

Просмотрите файлы ReadMe.

Если при конвертации вашего файла был создан файл ReadMe, ознакомьтесь с проблемами конвертации, перечисленными в этом файле.

  • Если эти проблемы могут возникнуть в случаях, которые вы не тестировали, внесите рекомендуемые изменения в свой код.
  • Если вы протестировали все возможные сценарии и всё работает как положено, то, вероятно, вам не нужно вносить изменения.

Шаг 3: Исправление ошибок

Если при тестировании файлов вы столкнетесь с ошибками, см. раздел «Исправление ошибок в преобразованном коде» .

Если код выполняется без ошибок, но результат не соответствует вашим ожиданиям, откройте файл ReadMe. Просмотрите каждый раздел, чтобы определить причину проблемы, и примените рекомендуемое исправление.

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