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 "Hello World" ("Xin chào thế giới") rồi thêm một hàm đơn giản là logThis. Hàm này sẽ ghi lại thông báo đã được truyền vào. Sau đó, bạn tạo một quy trình tự động hoá AppSheet rồi yêu cầu tập lệnh này gọi tập lệnh. Sau khi tập lệnh được gọi, bạn 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 dự án Apps Script bằng một hàm đơn giản.
• Cách tạo ứng dụng AppSheet đơn giản dựa trên một tệp Google Trang tính hiện có.
• Cách tạo một chương trình Tự động hoá của AppSheet để gọi hàm tập lệnh.
• Cách kiểm tra xem tập lệnh trên AppSheet có thực thi thành công tập lệnh 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" ("Xin chào thế giới") rồi thêm một hàm đơn giản là logThis. Hàm này sẽ ghi lại thông báo đã được truyền vào.

1. Truy cập vào trang chủ Apps Script rồi nhấp vào + Dự án mới.
2. Thay đổi tên dự án thành Hello World.
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);
}

4. Nhấp vào Save project (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 sẽ nhanh chóng tạo một ứng dụng AppSheet mới dựa trên một tệp Google Trang tính mẫu đã sao chép, rồi cập nhật ứng dụng này để 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ở một bản sao trong Google Trang tính. Bạn có thể tuỳ ý đổ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 Create a new app (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.
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.

7. Nhấp vào google để truy cập vào Google Drive.
8. Di chuyển đến rồi 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.

9. 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 một 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.

4. Nhấp vào bước Gửi thông báo để chỉnh sửa thông báo.
5. Hãy đổi tên thành Call a script.

6. Trong phần Cài đặt, hãy thay đổi loại tác vụ thành Gọi tập lệnh.

7. Trong trường Apps Script Project, hãy nhấp vào Browse (Biểu tượng tệp) (File).
8. Chuyển đến và chọn dự án Apps Script Hello World trong Drive của bạn.
9. Nhấp vào Chọn và nếu được nhắc cho phép, hãy nhấp vào Uỷ quyền rồi làm theo lời nhắc.

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

10. Chọn logThis(msg) trong danh sách Tên hàm.

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

11. Đố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" (Xin chào từ AppSheet)

12. Nhấp vào Save (Lưu) để lưu ứng dụng.
13. Trong Bảng 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.

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

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

Sau khi tập lệnh được gọi, 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ủ của Apps Script và xem dự án Hello World.
2. Nhấp vào Các lần thực thi trên 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.

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

Ở bước tiếp theo trong hội thảo này, hãy xem lại dự án Ví dụ về Apps Script và chạy một số ví dụ trong AppSheet.

Làm quen với các ví dụ về Apps Script

1. Để bắt đầu, trước tiên, hãy tạo một bản sao của 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 Run (Chạy) để cấp 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 Tài liệu mới.
• createSheet() – Tạo trang tính mới.
• createSlideDeck() – Tạo một 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, vui lòng xem phần Gọi Apps Script từ quy trình tự động hoá, trong đó có thông tin tổng quan chi tiết, video giới thiệu, hướng dẫn và một dự án Apps Script có thể sao chép, trong đó có nhiều ví dụ về cách hoạt động của AppSheet-Apps Script.