将 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 Script 项目，然后添加一个简单的函数 logThis，用于记录传递给它的消息。

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

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

3. 创建 AppSheet 应用

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

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

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

  1. 点击 google 即可访问您的 Google 云端硬盘。
  2. 前往您之前复制的 Shirt Orders 电子表格，然后选择该电子表格。

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

在 Apps 脚本编辑器环境中查看执行日志，以检查是否通过 AppSheet 调用执行了函数。

6. 可选的其他步骤

作为本研讨会的额外步骤，请查看 Apps 脚本示例项目，并在 AppSheet 中运行其中的一些示例。

Apps 脚本示例使用入门

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

尝试使用几个示例

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

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