El flujo de trabajo típico para ver los cambios en tu visualización comunitaria es subir los archivos a GCS y, luego, actualizar tu informe de Data Studio. Esto funciona, pero significa que puedes pasar mucho tiempo esperando para ver los cambios. dscc-gen permite un flujo de trabajo para ver de inmediato los cambios en el código de visualización, lo que reduce el tiempo necesario para escribir una visualización comunitaria.
Para comenzar, asegúrate de que estén instalados npm 5.2.0 o versiones posteriores y gsutil. Luego, ejecuta lo siguiente:
npx @google/dscc-gen viz
Configuración inicial
dscc-gen incluye un conjunto de datos local predeterminado que probablemente no sea representativo de los datos que deseas visualizar. Para actualizar este conjunto de datos según tus necesidades, haz lo siguiente:
- Actualiza tu configuración en
src/index.json. - Ejecuta
npm run update_message. Esto implementa una visualización en tudevbucket que muestra el mensaje en un formato fácil de copiar. - Crea un informe nuevo y conéctate a un conjunto de datos que sea representativo de los datos que deseas visualizar.
- Agrega una visualización comunitaria con tu bucket
devcomo ID de componente. - Copia el contenido de la visualización en
scripts/data/localData.js. Estos datos se usarán cuando desarrolles de forma local.
Secuencias de comandos
Las siguientes secuencias de comandos están disponibles para los proyectos de visualización creados con dscc-gen.
| Comando | Acción |
|---|---|
npm run start
|
Inicia el servidor local y obtén una vista previa de tu visualización |
npm run update_message |
Actualiza el mensaje con el objectFormat |
npm run build:dev
|
Compila archivos de ./src en ./build con
almacenamiento en caché inhabilitado. |
npm run push:dev |
Copia los archivos de build en tu bucket dev. |
npm run build:prod
|
Compila archivos de ./src en ./build con
almacenamiento en caché habilitado. |
npm run push:prod
|
Copia los archivos de build en tu bucket prod. |
El comando update_message usa objectFormat de forma predeterminada. Para usar el
tableFormat, edita los parámetros en la secuencia de comandos update_message en
package.json de -f object a -f table.
Codelab
Para obtener información sobre cómo usar las herramientas, consulta el codelab de dscc-gen.
