Хотя все задачи, связанные с коннекторами, можно выполнить с помощью онлайн-среды 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
Вам будет предложено ввести несколько параметров для вашего коннектора. Если у вас еще нет развертывания с названием "Production", оно будет создано для вас. Ваш существующий код не будет изменен, но вы получите доступ ко всем возможностям 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 | Откройте развертывание с вашим последним кодом в Data Studio. |
npm run try_production | Откройте свою рабочую среду развертывания в Data Studio. |
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-адрес:
- Исходный URL:
https://script.google.com/a/google.com/d/example-script-id/edit - Идентификатор скрипта:
example-script-id