Kết nối AppSheet với Apps Script

1. Giới thiệu

Trong lớp học lập trình này, bạn sẽ tạo một dự án Apps Script có tên là "Hello World" (Xin chào thế giới), sau đó thêm một hàm đơn giản, logThis, để ghi lại một thông báo đã được truyền đến hàm đó. Sau đó, bạn tạo một quy trình tự động hoá AppSheet và yêu cầu quy trình đó gọi tập lệnh. Sau khi gọi tập lệnh, bạn sẽ quay lại trình chỉnh sửa Apps Script và xác nhận việc thực thi tập lệnh đó.

Kiến thức bạn sẽ học được

  • Cách tạo một dự án Apps Script bằng một hàm đơn giản.
  • Cách tạo một ứng dụng AppSheet đơn giản dựa trên một Google Trang tính hiện có.
  • Cách tạo AppSheet Automation gọi hàm tập lệnh.
  • Cách kiểm tra xem tập lệnh có được thực thi thành công từ AppSheet hay không.

Bạn cần có

  • Quyền truy cập vào môi trường phát triển AppSheet (appsheet.com).
  • Quyền truy cập vào môi trường phát triển Apps Script (script.google.com).

2. Tạo một dự án Apps Script

Trước tiên, hãy tạo một dự án Apps Script có tên là "Hello World" rồi thêm một hàm đơn giản, logThis, để ghi lại một thông báo đã được truyền đến hàm đó.

  1. Truy cập vào trang chủ Apps Script, sau đó nhấp vào + Dự án mới.
  2. Thay đổi tiêu đề của dự án thành Hello World. Hộp thoại Đổi tên dự án có tên mới.
  3. Cập nhật tập lệnh trong trình chỉnh sửa như sau:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Nhấp vào Lưu dự án.

Để biết thêm thông tin, hãy xem bài viết Tạo và xoá dự án.

3. Tạo ứng dụng AppSheet

Tiếp theo, bạn nhanh chóng tạo một ứng dụng AppSheet mới dựa trên một Trang tính sao chép mẫu trên Google, rồi cập nhật ứng dụng đó để gọi dự án Apps Script mà bạn đã tạo trước đó.

  1. Mở bảng tính Ví dụ về đơn đặt hàng áo sơ mi, sau đó nhấp vào Tạo bản sao để tải xuống và mở bản sao trong Google Trang tính. Bạn có thể đổi tên bảng tính (nếu muốn) (ví dụ: "Đơn đặt hàng áo sơ mi").
  2. Đăng nhập vào AppSheet.
  3. Trên trang Ứng dụng của tôi, hãy nhấp vào + Tạo ứng dụng mới. Hộp thoại Tạo ứng dụng mới sẽ xuất hiện.
  4. Nhấp vào Bắt đầu bằng dữ liệu của riêng bạn. Hộp thoại Tạo ứng dụng mới.
  5. Nếu muốn, hãy chỉnh sửa tên ứng dụng và chọn một danh mục.
  6. Nhấp vào Chọn dữ liệu của bạn.

Chọn "Chọn dữ liệu của bạn" trong hộp thoại tạo ứng dụng mới.

  1. Nhấp vào google để truy cập Google Drive.
  2. Chuyển đến và chọn bảng tính Đơn đặt hàng áo sơ mi mà bạn đã sao chép trước đó.

AppSheet thiết lập ứng dụng của bạn. Cửa sổ xem trước ban đầu cho ứng dụng được tạo.

  1. Nhấp vào Tuỳ chỉnh ứng dụng để mở ứng dụng trong trình chỉnh sửa AppSheet.

4. Tạo một quy trình tự động hoá

Tiếp theo, bạn tạo một quy trình tự động hoá AppSheet và yêu cầu quy trình này gọi tập lệnh.

  1. Chọn Tự động hoá > Bot.
  2. Nhấp vào + Bot mới.
  3. Chọn mục đầu tiên trong danh sách đề xuất: Khi bản ghi Đơn đặt hàng áo sơ mi được tạo hoặc cập nhật, hãy gửi thông báo.

5037cdd726e326e9.png

  1. Nhấp vào bước Gửi thông báo để chỉnh sửa.
  2. Đổi tên thành Call a script.

Các bước tự động hoá để gọi một Tập lệnh.

  1. Trong phần Settings (Cài đặt), hãy thay đổi loại tác vụ thành Call a script (Gọi tập lệnh).

Chọn loại tác vụ "Gọi tập lệnh" trong phần Cài đặt quy trình tự động hoá.

  1. Trong trường Dự án Apps Script, hãy nhấp vào Duyệt qua (Biểu tượng tệp).
  2. Di chuyển đến và chọn dự án Hello World Apps Script trong Drive.
  3. Nhấp vào Chọn và nếu được nhắc uỷ quyền, hãy nhấp vào Uỷ quyền rồi làm theo lời nhắc.

Dự án Apps Script sẽ được thêm và trường Tên hàm sẽ được điền sẵn danh sách các hàm có sẵn.

  1. Chọn logThis(msg) trong danh sách Tên hàm. Chọn hàm Apps Script "logThis()" trong trình đơn thả xuống.

Trường Đối số hàm sẽ xuất hiện.

  1. Đối với đối số msg, hãy nhập biểu thức sau bằng Trợ lý biểu thức: "Hello from AppSheet"

Thêm đối số vào lệnh gọi hàm Apps Script.

  1. Nhấp vào Lưu để lưu ứng dụng.
  2. Trong Bảng điều khiển xem trước, hãy nhấp vào biểu tượng thiết bị di động hoặc máy tính bảng để hiển thị trình mô phỏng ứng dụng.

68471f4646fc8fbe.png

  1. Thêm đơn đặt hàng áo mới rồi nhấp vào Lưu.
  2. Nhấp vào Đồng bộ hoá để đồng bộ hoá các thay đổi.

Nhấp vào biểu tượng đồng bộ hoá ở trên cùng bên phải của Bảng điều khiển xem trước để đồng bộ hoá với nguồn dữ liệu.

5. Xác nhận việc thực thi Apps Script

Sau khi gọi tập lệnh, hãy quay lại trình chỉnh sửa Apps Script và xác nhận việc thực thi tập lệnh đó.

  1. Quay lại trang chủ Apps Script và xem dự án Hello World.
  2. Nhấp vào Executions (Thực thi) trong thanh điều hướng để xác nhận rằng hàm logThis đã được hoàn tất thành công. Nhấp vào Làm mới nếu nhật ký chưa xuất hiện.

Xem nhật ký thực thi trong môi trường trình chỉnh sửa tập lệnh Apps Script để kiểm tra việc thực thi hàm từ lệnh gọi AppSheet.

6. Các bước bổ sung không bắt buộc

Trong bước bổ sung của hội thảo này, hãy xem xét dự án Ví dụ về Apps Script và chạy một số ví dụ từ AppSheet.

Bắt đầu với Các ví dụ về Apps Script

  1. Để bắt đầu, trước tiên hãy sao chép Dự án ví dụ về Apps Script.
  2. Nhấp vào biểu tượng sao chép.
  3. Lưu dự án mới rồi nhấp vào Chạy để uỷ quyền cho các ứng dụng trong dự án.

Thử nghiệm với một số ví dụ

  • createCalendarEvent() – Tạo sự kiện mới trên Lịch.
  • createDoc() – Tự động tạo một Tài liệu mới.
  • createSheet() – Tạo một trang tính mới.
  • createSlideDeck() – Tạo bản trình bày mới bằng hình ảnh và văn bản.

Để biết thêm thông tin về tính năng quan trọng này, hãy xem bài viết Gọi Apps Script từ một quy trình tự động hoá. Bài viết này cung cấp thông tin tổng quan chi tiết, video về tính năng, hướng dẫn và một dự án Apps Script có thể sao chép chứa nhiều ví dụ minh hoạ cách hoạt động của AppSheet-Apps Script.