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

选择“选择您的数据”。

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

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

  1. 点击 Customize your app,即可在 AppSheet 编辑器中打开该应用。

4. 创建自动化操作

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

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

5037cdd726e326e9

  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. 点击 Save 以保存应用。
  2. 在预览面板中,点击 mobiletablet 图标以显示应用模拟器。

68471f4646fc8fbe

  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 脚本项目。