本地开发

尽管您可以使用在线 Apps 脚本环境完成所有与连接器有关的任务,但有些任务可能具有重复性且随着时间的推移容易出错。

dscc-gen 是一个专门的工具,旨在处理这些重复性任务,以便您可以专注于解决业务问题,而不是通过自动化可以避免的错误。

要求

使用 dscc-gen

dscc-gen 可用于创建新的社区连接器项目,也可以与现有社区连接器项目配合使用

现有连接器

dscc-gen 也可以与现有项目配合使用。首先,复制您的 scriptId,然后运行以下命令(将 YOUR_SCRIPT_ID 替换为 scriptId):

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

系统会提示您输入连接器的一些详细信息。如果您还没有名为“生产”的部署,系统将为您创建一个。这不会修改您的任何现有代码,但您将有权访问 dscc-gen 的所有功能

新连接器

要使用 dscc-gen 创建新的社区连接器,请运行以下命令:

npx @google/dscc-gen connector

系统会提示您输入新连接器的一些详细信息。初次使用的用户需要对 clasp 进行身份验证。clasp 是一款用于通过命令行创建和修改 Apps 脚本项目的工具。

完成提示的操作后,dscc-gen 会创建一个新的 Apps 脚本项目并输出它的所有功能

dscc-gen 的功能

命令 说明
npm run open 在 Apps 脚本中打开项目。
npm run push 将本地更改推送到 Apps 脚本。
npm run watch 留意本地更改,并将其推送到 Apps 脚本。
npm run prettier 根据社区准则设置代码格式。
npm run try_latest 在以下位置打开包含最新代码的部署: Looker Studio。
npm run try_production 在 Looker 中打开生产部署 Studio。
npm run update_production 更新生产部署以使用最新代码。

使用方法

使用 dscc-gen 的方法通常大致如下所示:

  1. 确定您要添加到连接器的功能。
  2. 运行 npm run watch,以便本地更改可以推送到 Apps 脚本。
  3. 使用您喜欢的 JavaScript 编辑器进行代码更改。
  4. 运行 npm run tryLatest 并检查新功能是否正常工作。
  5. 运行 npm run updateProduction 以更新生产部署,使之具有新功能。
  6. 运行 npm run tryProduction 并仔细检查新功能是否正常工作。

获取脚本 ID

要获取您的 scriptId,请转到现有项目,然后复制在 /d/ 之后但在 /edit 之前的网址部分。以下面这个网址为例:

  • 原始网址:https://script.google.com/a/google.com/d/example-script-id/edit
  • 脚本 Id:example-script-id