Desarrollo local

Si bien puedes realizar todas las tareas relacionadas con el conector con el entorno de Apps Script en línea, algunas de ellas pueden volverse repetitivas y propensas a errores con el tiempo.

dscc-gen es una herramienta con opiniones que está diseñada para abordar estas tareas repetitivas para que puedas enfocarte en resolver tu problema empresarial en lugar de los errores que se pueden evitar a través de la automatización.

Requisitos

Usa dscc-gen

dscc-gen puede crear proyectos nuevos de conectores de la comunidad o usarse con proyectos 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 te solicitarán algunos detalles para tu conector. Si aún no tienes una implementación llamada "Producción", se creará una para ti. No se modificará ninguno de tus códigos existentes, pero tendrás acceso a todo lo que dscc-gen puede hacer.

Conectores nuevos

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

npx @google/dscc-gen connector

Se te solicitarán algunos detalles para tu conector nuevo. A los usuarios nuevos se les pedirá 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 las indicaciones, dscc-gen creará un proyecto nuevo 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ía tus cambios locales a Apps Script.
npm run watch Supervisa los cambios locales y envíalos a Apps Script.
npm run prettier Da formato a tu código con los estándares de la comunidad.
npm run try_latest Abre la implementación con tu código más reciente en Data Studio.
npm run try_production Abre tu implementación de producción en Data Studio.
npm run update_production Actualiza tu implementación de producción para usar tu código más reciente.

¿Cómo debo usarlo?

El uso de dscc-gen suele ser de la siguiente manera:

  1. Identifica una función que deseas agregar a tu conector.
  2. Ejecuta npm run watch para que los cambios locales se envíen a Apps Script.
  3. Realiza los cambios de código con tu editor de JavaScript favorito.
  4. Ejecuta npm run tryLatest y verifica que la función nueva funcione como se espera.
  5. Ejecuta npm run updateProduction para actualizar tu implementación de producción y que tenga la función nueva.
  6. Ejecuta npm run tryProduction y verifica que la función nueva funcione.

Obtén el ID de tu 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