Desarrollo local

Si bien puedes hacer todas las tareas relacionadas con el conector en el entorno online de Apps Script, con el tiempo, algunas pueden acabar siendo repetitivas e inducir a error.

dscc-gen es una herramienta fiable que permite hacer esas tareas repetitivas, para que puedas dedicar tu tiempo a resolver los problemas de tu empresa en lugar de corregir errores que pueden evitarse con la automatización de tareas.

Requisitos

Usar dscc-gen

dscc-gen permite crear proyectos de conectores comunitarios o usar otros que ya tengas.

Conectores que ya tengas

dscc-gen también se puede usar con proyectos que ya tengas. Primero, copia tu scriptId y, a continuación, ejecuta el siguiente comando (sustituye YOUR_SCRIPT_ID por tu scriptId):

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

Se te solicitará alguna información del conector. Si aún no tienes una implementación denominada "Production" (Producción), se creará una. Tu código no se modificará, pero tendrás acceso a todo lo que dscc-gen puede hacer.

Conectores nuevos

Para crear un conector comunitario con dscc-gen, ejecuta el siguiente comando:

npx @google/dscc-gen connector
    

Se te solicitará alguna información del nuevo conector. A los usuarios nuevos se les pedirá que autentiquen clasp. clasp es una herramienta diseñada para crear y modificar proyectos de Apps Script desde la línea de comandos.

Después de completar las solicitudes, dscc-gen creará un proyecto de Apps Script y enumerará todo lo que puede hacer.

¿Qué puede hacer dscc-gen?

Comando Descripción
npm run open Abre el proyecto en Apps Script.
npm run push Envía los cambios locales a Apps Script.
npm run watch Detecta los cambios locales y los envía a Apps Script.
npm run prettier Aplica formato al código a partir de las Normas de la Comunidad.
npm run try_latest Abre la implementación con el último código que has creado en Data Studio.
npm run try_production Abre la implementación de producción en Data Studio.
npm run update_production Cambia tu implementación de producción para poder usar el último código que has creado.

¿Cómo se debe usar?

La herramienta dscc-gen se suele usar de la siguiente manera:

  1. Busca la función que quieres añadir al conector.
  2. Ejecuta npm run watch para que los cambios locales se envíen a Apps Script.
  3. Cambia el código con el editor de JavaScript que quieras.
  4. Ejecuta npm run tryLatest y comprueba que la nueva función actúe según lo esperado.
  5. Ejecuta npm run updateProduction para actualizar la implementación de producción y disponer de la nueva función.
  6. Ejecuta npm run tryProduction y comprueba que la función vaya bien.

Obtener el ID de la secuencia de comandos

Para obtener el ID de la secuencia de comandos (scriptId), ve al proyecto y, a continuación, copia la sección de la URL entre /d/ y /edit del siguiente modo:

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