将 AppSheet 与 Apps 脚本关联

1. 简介

在此 Codelab 中，您将创建一个名为“Hello World”的 Apps 脚本项目，然后添加一个简单的函数 logThis，用于记录传递给它的消息。然后，您需要创建 Appsheet 自动化操作，并让其调用该脚本。调用脚本后，您会返回到 Apps 脚本编辑器并确认脚本的执行情况。

学习内容

  • 如何创建包含简单函数的 Apps 脚本项目。
  • 如何基于现有 Google 表格创建简单的 AppSheet 应用。
  • 如何创建调用脚本函数的 AppSheet Automation。
  • 如何从 AppSheet 中检查脚本是否成功执行。

所需条件

  • 访问 AppSheet 开发环境 (appsheet.com)。
  • 访问 Apps 脚本开发环境 (script.google.com)。

2. 创建 Apps 脚本项目

首先，创建一个名为“Hello World”的 Apps 脚本项目，然后添加一个简单的函数 logThis，用于记录传递给它的消息。

  1. 前往 Apps 脚本首页，然后点击 + 新项目。
  2. 将项目标题更改为 Hello World. “重命名项目”对话框，其中包含新名称。
  3. 按如下方式更新编辑器中的脚本：
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. 点击保存项目。

如需了解详情，请参阅创建和删除项目。

3. 创建 AppSheet 应用

接下来，您将基于复制的示例 Google 表格快速生成新的 AppSheet 应用，然后更新该应用以调用之前创建的 Apps 脚本项目。

  1. 打开衬衫订单示例电子表格，然后点击制作副本，下载并在 Google 表格中打开副本。您可以根据需要选择重命名电子表格（例如“衬衫订单”）。
  2. 登录 AppSheet。
  3. 在“我的应用”页面上，点击 + 制作新应用。系统会显示创建新应用对话框。
  4. 点击从您自己的数据开始。“新建应用”对话框。
  5. （可选）修改应用名称并选择类别。
  6. 点击选择数据。

在新的应用创建对话框中选择“选择数据”。

  1. 点击 google 即可访问您的 Google 云端硬盘。
  2. 找到并选择您之前复制的 Shirt Orders（衬衫订单）电子表格。

AppSheet 会设置您的应用。生成的应用的初始预览窗口。

  1. 点击自定义应用，在 AppSheet 编辑器中打开应用。

4. 创建自动化操作

接下来，您将创建 Appsheet 自动化操作，并让其调用该脚本。

  1. 依次选择自动化 > Bot。
  2. 点击 + 新建聊天机器人。
  3. 选择建议列表中的第一个项目：创建或更新“衬衫订单”记录时，发送通知。

5037cdd726e326e9.png

  1. 点击发送通知步骤即可对其进行修改。
  2. 将名称更改为 Call a script。

用于调用脚本的自动化步骤。

  1. 在设置下，将任务类型更改为调用脚本。

在“自动化”设置中选择“调用脚本”任务类型。

  1. 在 Apps 脚本项目字段中，点击浏览（文件图标）。
  2. 在云端硬盘中找到并选择 Hello World Apps 脚本项目。
  3. 点击选择，如果系统提示您进行授权，请点击授权，然后按照提示操作。

系统会添加 Apps 脚本项目，并使用可用函数的列表填充函数名称字段。

  1. 从函数名称列表中选择 logThis(msg)。在下拉菜单中选择 Apps 脚本函数“logThis()”。

系统会显示函数实参字段。

  1. 对于 msg 实参，请使用表达式助理输入以下表达式：‘Hello from AppSheet’

向 Apps 脚本函数调用添加实参。

  1. 点击保存以保存应用。
  2. 在“预览”面板中，点击移动设备或平板电脑图标以显示应用模拟器。

68471f4646fc8fbe.png

  1. 添加新的衬衫订单，然后点击保存。
  2. 点击同步以同步更改。

点击“预览”面板右上角的同步图标，与数据源同步。

5. 确认 Apps 脚本的执行

调用脚本后，返回 Apps 脚本编辑器并确认脚本已执行。

  1. 返回到 Apps 脚本首页，然后查看 Hello World 项目。
  2. 点击导航栏中的执行，确认 logThis 函数已成功完成。如果日志尚未显示，请点击刷新。

在 Apps 脚本编辑器环境中查看执行日志，以检查从 AppSheet 调用函数的情况。

6. 可选的其他步骤

作为本次工作坊的附加步骤，请查看 Apps 脚本示例项目，并从 AppSheet 运行一些示例。

Apps 脚本示例使用入门

  1. 首先，复制 Apps 脚本示例项目，然后开始使用。
  2. 点击复制图标。
  3. 保存新项目，然后点击运行以授权项目中的应用。

尝试使用多个示例

  • createCalendarEvent() - 创建新的日历活动。
  • createDoc() - 自动创建新文档。
  • createSheet() - 创建新工作表。
  • createSlideDeck() - 使用图片和文字创建新的幻灯片演示。

如需详细了解此重要功能，请参阅从自动化操作中调用 Apps 脚本，其中提供了详细的概览、功能视频、教程以及包含许多 AppSheet-Apps 脚本工作示例的可复制 Apps 脚本项目。