Хотя вы можете выполнить все задачи, связанные с соединителем, с помощью онлайн-среды сценариев приложений, некоторые из них со временем могут стать повторяющимися и подверженными ошибкам.
dscc-gen — это продуманный инструмент, предназначенный для решения этих повторяющихся задач, чтобы вы могли сосредоточиться на решении бизнес-задачи, а не на ошибках, которых можно избежать с помощью автоматизации.
Требования
- НПМ 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 | Внесите локальные изменения в скрипт приложений. |
npm run watch | Следите за локальными изменениями и переносите их в Apps Script. |
npm run prettier | Отформатируйте свой код в соответствии со стандартами сообщества. |
npm run try_latest | Откройте развертывание с последним кодом в Looker Studio. |
npm run try_production | Откройте производственное развертывание в Looker Studio. |
npm run update_production | Обновите производственное развертывание, чтобы использовать последнюю версию кода. |
Как мне его использовать?
Использование dscc-gen часто выглядит примерно так:
- Определите функцию, которую вы хотите добавить в свой соединитель.
- Запустите
npm run watch, чтобы локальные изменения были перенесены в скрипт приложений. - Вносите изменения в код, используя ваш любимый редактор 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