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

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

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

Требования

• Наличие npm версии 5.2.0 или более поздней.
• Умение работать с командной строкой.

Использование 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
    

Примечание. Инструмент npx добавлен в npm 5.2.0. Он запускает одноразовые исполняемые файлы, не изменяя PATH.

Потребуется указать сведения о новом коннекторе. Новым пользователям предлагается выполнить аутентификацию для 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