将 AppSheet 与 Apps 脚本连接

1. 简介

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

学习内容

  • 如何创建具有简单函数的 Apps 脚本项目。
  • 如何基于现有 Google 表格创建简单的 AppSheet 应用。
  • 如何创建调用脚本函数的 AppSheet 自动化。
  • 如何从 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. 转到并选择您之前复制的衬衫订单电子表格。

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

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

4.创建自动化

接下来，您将创建 Appsheet 自动化并让它调用脚本。

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

5037cdd726e326e9.png

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

调用脚本的自动化步骤。

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

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

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

已添加 Apps 脚本项目，并使用可用函数列表填充 Function Name（函数名称）字段。

  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. 点击导航栏中的 Executions，以确认 logThis 函数已成功完成。如果日志未显示，请点击 Refresh。

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

6.其他可选步骤

在本研讨会的最后一步中，请查看 Apps 脚本示例项目并运行 AppSheet 中的一些示例。

Apps 脚本示例使用入门

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

尝试几个示例

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

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