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), sau đó thêm một hàm đơn giản, logThis, để ghi lại thông báo đã được truyền vào hàm đó. Sau đó, 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. Sau khi tập lệnh được gọi, bạn sẽ quay lại trình soạn thảo 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 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 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 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 dự án Apps Script

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

1. Truy cập vào trang chủ Apps Script, rồi nhấp vào + New Project (Dự án mới).
2. Thay đổi tiêu đề của 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 trang tính Google mẫu đã sao chép, sau đó 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ở một 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 áo").
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.
5. Bạn có thể chỉnh sửa tên ứng dụng và chọn một danh mục (không bắt buộc).
6. Nhấp vào Chọn dữ liệu.

7. Nhấp vào google để truy cập vào Google Drive của bạn.
8. Chuyển đến và chọn bảng tính Shirt Orders (Đơn đặt hàng áo) 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 quy trình tự động hoá

Tiếp theo, bạn sẽ 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 + Trình tạo bot mới.
3. Chọn mục đầu tiên trong danh sách đề xuất: Khi tạo hoặc cập nhật bản ghi Đơn đặt hàng áo, 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. Thay đổ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 (Dự án Apps Script), hãy nhấp vào Browse (Duyệt qua) (biểu tượng Tệp).
8. Chuyển đến và chọn dự án Apps Script Hello World trong Drive.
9. Nhấp vào Chọn và nếu bạn đượ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 được thêm và trường Function Name (Tên hàm) sẽ được điền sẵn danh sách các hàm có sẵn.

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 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á các 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 soạn thảo 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 Lượt thực thi trong thanh điều hướng để xác nhận rằng hàm logThis đã 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.

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