Desarrollo local

Si bien puedes realizar todas las tareas relacionadas con los conectores mediante la aplicación en línea de secuencia de comandos, algunas de ellas pueden volverse repetitivas y propensas a errores tiempo.

dscc-gen es una herramienta bien definida y diseñada para abordar estas situaciones para que puedas enfocarte en resolver tu problema empresarial en lugar de errores que pueden evitarse a través de la automatización.

Requisitos

Usa dscc-gen

dscc-gen puede crear nuevos proyectos de conector de comunidad o ser se usan 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 (reemplazando YOUR_SCRIPT_ID con tu scriptId):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Se te solicitarán algunos detalles para el conector. Si aún no tendrás una implementación llamada “Producción”, se creará una para ti. Ninguno de tus el código existente se modificará, pero tendrás acceso a todo lo que dscc-gen puede hacer.

Nuevos conectores

Para crear un nuevo conector de comunidad con dscc-gen, ejecuta el siguiente comando:

npx @google/dscc-gen connector

Se te solicitarán algunos detalles del conector nuevo. Usuarios nuevos se le pedirá que autentique clasp. clasp es una herramienta para crear y modificar proyectos de Apps Script desde la línea de comandos.

Después de completar las indicaciones, dscc-gen creará un nuevo proyecto de Apps Script y, luego, imprimir 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ía los cambios locales a Apps Script.
npm run watch Vigilar los cambios locales y enviarlos a Apps Secuencia de comandos
npm run prettier Da formato a tu código según los estándares de la comunidad.
npm run try_latest Abre la implementación con el código más reciente en en Looker Studio.
npm run try_production Abre tu implementación de producción en Looker a Looker Studio.
npm run update_production Actualiza tu implementación de producción para usar el código más reciente.

¿Cómo debo utilizarlo?

El uso de dscc-gen suele ser un poco similar al siguiente:

  1. Identifica una función que te gustaría agregar al conector.
  2. Ejecuta npm run watch para que los cambios locales se envíen a Apps Script.
  3. Realiza los cambios en el código con tu favorito JavaScript JavaScript.
  4. Ejecuta npm run tryLatest y verifica que la función nueva se ejecute correctamente lo esperado.
  5. Ejecuta npm run updateProduction para actualizar tu implementación de producción de modo que tenga sobre la nueva función.
  6. Ejecuta npm run tryProduction y vuelve a verificar que la función nueva se ejecute correctamente.

Obtén el ID de la secuencia de comandos

Para obtener tu scriptId, navega a tu proyecto existente y, luego, copia la sección de la URL después del /d/ y antes del /edit. Por ejemplo, la siguiente URL:

  • URL original: https://script.google.com/a/google.com/d/example-script-id/edit
  • ID de secuencia de comandos: example-script-id