Локальная разработка

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

Инструмент dscc-gen может автоматизировать такие задачи, что позволит избежать ошибок и сэкономит ваше время.

Требования

Использование dscc-gen

dscc-gen можно использовать для создания новых проектов коннекторов с открытым кодом или для работы с существующими.

Существующие коннекторы

dscc-gen также можно использовать для работы существующими проектами. Сначала скопируйте scriptId, затем выполните следующую команду, заменив YOUR_SCRIPT_ID вашим scriptId:

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID
    

Потребуется указать сведения о коннекторе. Если у вас нет развертывания с названием "Рабочая версия", оно будет создано. Существующий код не будет изменен, но вы получите доступ ко всем функциям dscc-gen.

Новые коннекторы

Чтобы создать коннектор с открытым кодом на основе dscc-gen, выполните следующую команду:

npx @google/dscc-gen connector
    

Потребуется указать сведения о новом коннекторе. Новым пользователям предлагается выполнить аутентификацию для clasp. clasp – это инструмент, который позволяет создавать и изменять проекты Apps Script через командную строку.

Как только вы выполните все необходимые действия, dscc-gen создаст проект Apps Script и распечатает список возможностей.

Возможности dscc-gen

Команда Описание
npm run open Открывает проект в Apps Script.
npm run push Переносит локальные изменения в Apps Script.
npm run watch Находит локальные изменения и переносит их в Apps Script.
npm run prettier Форматирует код в соответствии с требованиями для сторонних коннекторов.
npm run try_latest Открывает развертывание с последним кодом в Студии данных.
npm run try_production Открывает рабочее развертывание в Студии данных.
npm run update_production Переносит последний код в рабочее развертывание.

Как работать с инструментом

Типичный пример использования dscc-gen:

  1. Решите, какую функцию нужно добавить в коннектор.
  2. Выполните команду npm run watch, чтобы перенести локальные изменения в Apps Script.
  3. Измените код, используя любой редактор JavaScript.
  4. Выполните команду npm run tryLatest и проверьте, правильно ли работает новая функция.
  5. Выполните команду npm run updateProduction, чтобы добавить в рабочее развертывание новую функцию.
  6. Выполните команду npm run tryProduction и ещё раз проверьте работу новой функции.

Как получить идентификатор скрипта

Чтобы получить scriptId, перейдите в существующий проект и скопируйте фрагмент URL между /d/ и /edit. Пример:

  • Исходный URL: https://script.google.com/a/google.com/d/example-script-id/edit
  • Значение scriptId: example-script-id