Desarrollo local

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

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:

  1. Identifique una función que le gustaría agregar a su conector.
  2. Ejecuta npm run watch para que los cambios locales se envíen a Apps Script.
  3. Realiza los cambios de código mediante tu favorito JavaScript editor.
  4. Ejecuta npm run tryLatest y comprueba que tu función nueva funcione según lo esperado.
  5. Ejecuta npm run updateProduction para actualizar la implementación de producción a fin de que tenga la función nueva.
  6. 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