連結 AppSheet 與 Apps Script

1. 簡介

在本程式碼研究室中，您將建立名為「Hello World」的 Apps Script 專案，然後新增簡單的 logThis 函式，記錄傳遞給該函式的訊息。接著，您可以建立 Appsheet 自動化動作，並讓該自動化動作呼叫指令碼。呼叫指令碼後，請返回 Apps Script 編輯器，確認指令碼是否已執行。

課程內容

  • 如何建立含有簡單函式的 Apps Script 專案。
  • 如何根據現有的 Google 試算表建立簡易的 AppSheet 應用程式。
  • 如何建立會呼叫指令碼函式的 AppSheet 自動化動作。
  • 如何檢查 AppSheet 是否成功執行指令碼。

軟硬體需求

  • 可存取 AppSheet 開發環境 (appsheet.com)。
  • 可存取 Apps Script 開發環境 (script.google.com)。

2. 建立 Apps Script 專案

首先，請建立名為「Hello World」的 Apps Script 專案，然後新增簡單的函式 logThis，用於記錄傳遞給該函式的訊息。

  1. 前往 Apps Script 首頁，然後按一下「+ 新增專案」。
  2. 將專案名稱變更為 Hello World. 顯示新名稱的「Rename Project」對話方塊。
  3. 請在編輯器中更新指令碼，如下所示：
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. 按一下「儲存專案」。

詳情請參閱「建立及刪除專案」。

3. 建立 AppSheet 應用程式

接下來，您將根據複製的範例 Google 試算表快速產生新的 AppSheet 應用程式，然後更新該應用程式，以呼叫先前建立的 Apps Script 專案。

  1. 開啟「襯衫訂單範例」試算表，然後按一下「建立副本」，即可在 Google 試算表中下載及開啟副本。您可以視需要重新命名試算表 (例如「襯衫訂單」)。
  2. 登入 AppSheet。
  3. 在「我的應用程式」頁面中，按一下「+ 建立新應用程式」。系統隨即會顯示「建立新應用程式」對話方塊。
  4. 按一下「使用自己的資料開始」。新的應用程式建立對話方塊。
  5. 您可以視需要編輯應用程式名稱，並選取類別。
  6. 按一下「選擇資料」。

在新的應用程式建立對話方塊中選取「選擇您的資料」。

  1. 按一下「google」google，存取 Google 雲端硬碟。
  2. 前往先前複製的「Shirt Orders」試算表，然後選取該試算表。

AppSheet 會設定應用程式。所產生應用程式的初始預覽視窗。

  1. 按一下「自訂應用程式」，即可在 AppSheet 編輯器中開啟應用程式。

4. 建立自動化動作

接下來，請建立 Appsheet 自動化動作，並讓該自動化動作呼叫指令碼。

  1. 依序選取「自動化」>「機器人」。
  2. 按一下「+ 新增 Bot」。
  3. 選取建議清單中的第一個項目：「建立或更新上衣訂單記錄時，傳送通知」。

5037cdd726e326e9.png

  1. 按一下「傳送通知」步驟即可編輯。
  2. 將名稱變更為 Call a script。

自動化步驟，用於呼叫指令碼。

  1. 在「設定」下方，將工作類型變更為「呼叫指令碼」。

在「自動化」設定中選取「呼叫指令碼」工作類型。

  1. 在「Apps Script Project」欄位中，按一下「瀏覽」 (檔案圖示)。
  2. 前往雲端硬碟，然後選取 Hello World Apps Script 專案。
  3. 按一下「選取」，如果出現授權提示，請按一下「授權」，然後按照提示操作。

系統會新增 Apps Script 專案，並在「函式名稱」欄位中填入可用函式的清單。

  1. 從「函式名稱」清單中選取「logThis(msg)」。在下拉式選單中選取 Apps Script 函式「logThis()」。

系統會隨即顯示「Function Arguments」欄位。

  1. 針對 msg 引數，請使用 Expression Assistant 輸入以下運算式：「Hello from AppSheet」

在 Apps Script 函式呼叫中加入引數。

  1. 按一下「儲存」即可儲存應用程式。
  2. 在「預覽」面板中，按一下「手機」或「平板電腦」圖示，即可顯示應用程式模擬器。

68471f4646fc8fbe.png

  1. 新增襯衫訂單，然後按一下「儲存」。
  2. 按一下「Sync」即可同步處理變更。

按一下預覽面板右上方的同步圖示，即可與資料來源同步。

5. 確認 Apps Script 的執行作業

呼叫指令碼後，請返回 Apps Script 編輯器，確認指令碼是否已執行。

  1. 返回 Apps Script 首頁，查看「Hello World」專案。
  2. 按一下導覽列中的「執行」，確認 logThis 函式已成功完成。如果記錄檔未顯示，請按一下「Refresh」。

在 Apps Script 編輯器環境中查看執行記錄，確認 AppSheet 呼叫是否執行函式。

6. 其他選用步驟

在本研討會中，您還可以進一步查看 Apps Script 範例專案，並透過 AppSheet 執行一些範例。

開始使用 Apps Script 範例

  1. 首先，請複製 Apps Script 範例專案。
  2. 按一下複製圖示。
  3. 儲存新專案並按一下「Run」，為專案中的應用程式提供授權。

嘗試幾個範例

  • createCalendarEvent() - 建立新的 Google 日曆活動。
  • createDoc() - 自動建立新文件。
  • createSheet() - 建立新工作表。
  • createSlideDeck()：使用圖片和文字建立新的簡報。

如要進一步瞭解這項重要功能，請參閱「從自動化功能呼叫 Apps Script」一文，其中提供詳細的概略說明、功能影片、教學課程，以及可複製的 Apps Script 專案，其中包含許多 AppSheet-Apps Script 工作範例。