Местное развитие

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

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 Внесите локальные изменения в скрипт приложений.
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 часто выглядит примерно так:

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

Получите идентификатор вашего сценария

Чтобы получить свой scriptId , перейдите к существующему проекту, затем скопируйте раздел URL-адреса после /d/ и перед /edit . Например: следующий URL:

  • Исходный URL-адрес: https://script.google.com/a/google.com/d/example-script-id/edit .
  • Идентификатор сценария: example-script-id