Si bien puedes realizar todas las tareas relacionadas con el conector mediante el entorno en línea de Apps Script, algunas de ellas pueden volverse repetitivas y propensas a errores con el tiempo.
dscc-gen
es una herramienta bien diseñada que está diseñada para abordar estas tareas repetitivas a fin de que puedas enfocarte en resolver el problema de tu empresa en lugar de errores que se pueden evitar mediante la automatización.
Requisitos
- npm 5.2.0 o una versión posterior
- Estar familiarizado con la línea de comandos
Usa dscc-gen
dscc-gen
puede crear proyectos de conector de la comunidad nuevos o usarse con los existentes.
Conectores existentes
dscc-gen
también se puede usar con proyectos existentes. Primero, copia tu scriptId
y, luego, ejecuta el siguiente comando (reemplaza YOUR_SCRIPT_ID
por tu scriptId
):
npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID
Se le solicitarán algunos detalles para el conector. Si aún no tienes una implementación llamada “Producción”, se creará una para ti. No se modificará nada de tu código existente, pero tendrás acceso a todo lo que puede hacer dscc-gen
.
Nuevos conectores
Para crear un nuevo conector de la comunidad con dscc-gen
, ejecuta el siguiente comando:
npx @google/dscc-gen connector
Se le solicitarán algunos detalles para el nuevo conector. Se les pedirá a los usuarios nuevos que autentiquen clasp
. clasp
es una herramienta para crear y modificar proyectos de Apps Script desde la línea de comandos.
Después de completar los mensajes, dscc-gen
creará un nuevo proyecto de Apps Script y mostrará todo lo que puede hacer.
¿Qué puede hacer dscc-gen
?
Comando | Descripción |
---|---|
npm run open |
Abre tu proyecto en Apps Script. |
npm run push |
Envíe los cambios locales a Apps Script. |
npm run watch
|
Busca cambios locales y envíalos a Apps Script. |
npm run prettier |
Dale formato a tu código con los estándares de la comunidad. |
npm run try_latest
|
Abre la implementación con el código más reciente en Looker Studio. |
npm run try_production
|
Abre la implementación de producción en Looker Studio. |
npm run update_production
|
Actualiza la implementación de producción para que use tu código más reciente. |
¿Cómo debería usarla?
El uso de dscc-gen
suele ser similar al siguiente:
- Identifique una función que le gustaría agregar a su conector.
- Ejecuta
npm run watch
para que los cambios locales se envíen a Apps Script. - Realiza los cambios de código mediante tu favorito JavaScript editor.
- Ejecuta
npm run tryLatest
y comprueba que tu función nueva funcione según lo esperado. - Ejecuta
npm run updateProduction
para actualizar la implementación de producción a fin de que tenga la función nueva. - Ejecuta
npm run tryProduction
y vuelve a verificar que funcione la función nueva.
Obtén tu ID de secuencia de comandos
Para obtener tu scriptId
, navega a tu proyecto existente y, luego, copia la sección de la URL después de /d/
y antes de /edit
. Por ejemplo, la siguiente URL:
- URL original:
https://script.google.com/a/google.com/d/example-script-id/edit
- ID de la secuencia de comandos:
example-script-id