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

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

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

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

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