查看社区可视化图表中的更改的典型工作流程是: 将您的文件上传到 GCS,然后刷新 Looker Studio 报告。这是可行的,但意味着您可能需要等待很长时间才能看到更改。dscc-gen 支持一种工作流程,可让您立即查看可视化图表代码更改,从而减少编写社区可视化图表所需的时间。
要开始使用,请确保您已安装 npm 5.2.0 或更高版本和 gsutil。然后运行以下命令:
npx @google/dscc-gen viz
首次配置
dscc-gen 随附默认本地数据集,该数据集可能并不能代表您要直观显示的数据。要更新此数据集以满足您的需求,请执行以下操作:
- 在 src/index.json中更新配置。
- 运行 npm run update_message。这会将一个可视化图表部署到您的dev存储分区,该可视化图表会以易于复制的格式显示消息。
- 创建新报告并将其连接到可代表您要直观显示的数据的数据集。
- 添加一个社区可视化图表(使用 dev存储分区作为组件 ID)。
- 将该可视化图表的内容复制到 scripts/data/localData.js。您进行本地开发时会用到此数据。
脚本
以下脚本可用于使用 dscc-gen 创建的可视化图表项目。
| 命令 | 操作 | 
|---|---|
| npm run start | 启动本地服务器并预览可视化图表 | 
| npm run update_message | 使用 objectFormat 更新消息 | 
| npm run build:dev | 在停用缓存的情况下,将文件从 ./src构建到./build。 | 
| npm run push:dev | 将文件从 build复制到dev存储分区。 | 
| npm run build:prod | 在启用缓存的情况下,将文件从 ./src构建到./build。 | 
| npm run push:prod | 将文件从 build复制到prod存储分区。 | 
update_message 命令默认为 objectFormat。要使用 tableFormat,请在 package.json 中将 update_message 脚本中的参数从 -f object 修改为 -f table。
Codelab
要了解如何使用 Codelab 工具,请访问 dscc-gen codelab。
