Все задачи, связанные с коннектором, можно выполнять в онлайн-среде 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
Потребуется указать сведения о новом коннекторе. Новым пользователям предлагается выполнить аутентификацию для 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
:
- Решите, какую функцию нужно добавить в коннектор.
- Выполните команду
npm run watch
, чтобы перенести локальные изменения в Apps Script. - Измените код, используя любой редактор JavaScript.
- Выполните команду
npm run tryLatest
и проверьте, правильно ли работает новая функция. - Выполните команду
npm run updateProduction
, чтобы добавить в рабочее развертывание новую функцию. - Выполните команду
npm run tryProduction
и ещё раз проверьте работу новой функции.
Как получить идентификатор скрипта
Чтобы получить scriptId
, перейдите в существующий проект и скопируйте фрагмент URL между /d/
и /edit
. Пример:
- Исходный URL:
https://script.google.com/a/google.com/d/example-script-id/edit
- Значение scriptId:
example-script-id