連結 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.」「Rename Project」(重新命名專案) 對話方塊，顯示新名稱。
  3. 在編輯器中更新指令碼，如下所示：
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. 按一下「儲存專案」。

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

3. 建立 AppSheet 應用程式

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

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

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

  1. 按一下「google」即可存取 Google 雲端硬碟。
  2. 找出並選取您稍早複製的「Shirt Orders」試算表。

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

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

4. 建立自動化動作

接著，您要建立 AppSheet 自動化動作，並呼叫指令碼。

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

5037cdd726e326e9.png

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

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

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

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

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

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

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

系統會顯示「函式引數」欄位。

  1. 在 msg 引數中，使用運算式助理輸入下列運算式：‘Hello from AppSheet’

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

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

68471f4646fc8fbe.png

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

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

5. 確認執行 Apps Script

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

  1. 返回 Apps Script 首頁，然後查看「Hello World」專案。
  2. 按一下導覽列中的「執行作業」，確認 logThis 函式已順利完成。如果記錄檔未顯示，請按一下「重新整理」。

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

6. 選用額外步驟

在本研討會中，請額外檢閱 Apps Script 範例專案，並從 AppSheet 執行部分範例。

開始使用 Apps Script 範例

  1. 如要開始使用，請先複製 Apps Script 範例專案。
  2. 按一下複製圖示。
  3. 儲存新專案，然後按一下「執行」，授權專案中的應用程式。

嘗試幾個範例

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

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