連結 AppSheet 與 Apps Script

1. 簡介

在本程式碼研究室中，您會建立名為「Hello World」的 Apps Script 專案然後新增一個簡易函式 logThis，這個函式會記錄傳遞的訊息。然後建立 AppSheet 自動化動作，並用指令碼呼叫指令碼。呼叫指令碼後，請返回 Apps Script 編輯器並確認執行。

課程內容

  • 如何以簡易功能建立 Apps Script 專案。
  • 如何根據現有的 Google 試算表建構簡單的 AppSheet 應用程式。
  • 如何建立會呼叫指令碼函式的 AppSheet Automation。
  • 如何透過 AppSheet 檢查指令碼是否成功執行。

軟硬體需求

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

2. 建立 Apps Script 專案

首先，請建立名為「Hello World」的 Apps Script 專案然後新增一個簡易函式 logThis，這個函式會記錄傳遞的訊息。

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

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

3. 建立 AppSheet 應用程式

接下來，您需要使用複製的 Google 試算表範例快速產生新的 AppSheet 應用程式，然後再更新應用程式，以便呼叫您之前建立的 Apps Script 專案。

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

選取「選擇資料」。

  1. 按一下「google」，存取 Google 雲端硬碟。
  2. 前往並選取先前複製的「襯衫訂單」試算表。

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

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

4. 建立自動化作業

接著，建立 AppSheet 自動化作業，並使用指令碼呼叫指令碼。

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

5037cdd726e326e9.png

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

呼叫指令碼的自動化步驟。

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

選取「致電指令碼」工作類型，

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

系統隨即會新增 Apps Script 專案，並在 [函式名稱] 欄位填入可用函式清單。

  1. 從「Function Name」logThis(msg)清單中選取「logThis(msg)」logThis(msg)。選取 Apps Script 函式「logThis()」。

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

  1. 針對 msg 引數，請使用運算式助理輸入下列運算式：‘Hello from AppSheet'

將引數新增至 Apps Script 函式呼叫。

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

68471f4646fc8fbe.png

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

按一下「預覽面板」右上方的同步處理圖示，以便與資料來源進行同步處理。

5. 確認執行 Apps Script

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

  1. 返回 Apps Script 首頁並檢視 Hello World 專案。
  2. 按一下導覽列中的「Executions」，確認 logThis 函式已成功完成。若未顯示記錄，請按一下「Refresh」(重新整理)。

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

6. 其他選擇性步驟

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

開始使用 Apps Script 範例

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

使用數個範例進行實驗

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

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