Mở rộng Google Trang tính bằng tiện ích bổ sung

Google Trang tính là một giải pháp bảng tính trên đám mây có tính năng cộng tác theo thời gian thực và các công cụ mạnh mẽ để trực quan hoá, xử lý và truyền đạt dữ liệu.

Bạn có thể mở rộng Trang tính bằng các tiện ích bổ sung giúp cải thiện quy trình làm việc theo cách tuỳ chỉnh, thiết lập khả năng kết nối với các hệ thống của bên thứ ba và tích hợp dữ liệu trong Trang tính với các ứng dụng khác của Google Workspace (chẳng hạn như Google Trang trình bày).

Bạn có thể xem các tiện ích bổ sung cho Trang tính mà người khác đã tạo trên Google Workspace Marketplace.

Giải pháp

Sau đây là một số việc bạn có thể làm với tiện ích bổ sung mở rộng Google Trang tính:

Tiện ích bổ sung cho Trang tính được tạo bằng Apps Script. Để tìm hiểu thêm về cách truy cập và quản lý Google Trang tính bằng Apps Script, hãy xem phần Mở rộng Google Trang tính.

Cấu trúc trang tính

Một bảng tính trên Google Trang tính bao gồm một hoặc nhiều trang tính. Về cơ bản, mỗi trang tính là một lưới ô 2D mà bạn có thể lưu trữ văn bản, số, đường liên kết hoặc các giá trị khác. Một nhóm gồm một hoặc nhiều ô liền kề được gọi là dải ô.

Dịch vụ Trang tính của Apps Script cung cấp một số lớp để biểu thị cấu trúc tổ chức trong Trang tính (chẳng hạn như Sheet và Range). Bạn có thể sử dụng các lớp này để đọc và sửa đổi dữ liệu cũng như hành vi của Trang tính.

Điều kiện kích hoạt

Trình kích hoạt Apps Script cho phép một dự án tập lệnh thực thi một hàm cụ thể khi đáp ứng một số điều kiện nhất định, chẳng hạn như khi một bảng tính được mở hoặc khi một tiện ích bổ sung được cài đặt.

Hãy xem phần trình kích hoạt bổ sung để biết thêm thông tin về những trình kích hoạt có thể dùng với tiện ích bổ sung của Trang tính và những hạn chế áp dụng cho việc sử dụng các trình kích hoạt đó.

Hàm tuỳ chỉnh

Google Trang tính có một số hàm tích hợp sẵn như SUM và AVERAGE có thể được gọi từ bên trong một ô của Google Trang tính. Tiện ích bổ sung cho Trang tính có thể xác định các hàm tuỳ chỉnh bổ sung để bổ sung cho các hàm tích hợp này. Khi người dùng cài đặt tiện ích bổ sung, mọi hàm tuỳ chỉnh được xác định có trong tiện ích bổ sung sẽ có sẵn ngay lập tức. Tiện ích bổ sung có thể chỉ bao gồm các định nghĩa hàm tuỳ chỉnh. Định nghĩa hàm tuỳ chỉnh chủ yếu được chia sẻ với người khác bằng cách xuất bản một tiện ích bổ sung có chứa các định nghĩa đó.

Tạo hàm tuỳ chỉnh cho tiện ích bổ sung

Bạn có thể dùng mọi hàm được xác định trong dự án tập lệnh của tiện ích bổ sung làm hàm tuỳ chỉnh. Sau khi triển khai hàm và cài đặt tiện ích bổ sung, bạn có thể gọi hàm tuỳ chỉnh như bất kỳ hàm tích hợp sẵn nào khác trong Trang tính: trong một ô của Trang tính, hãy nhập =, theo sau là tên của hàm và mọi tham số bắt buộc. Nếu không có lỗi, kết quả do hàm trả về sẽ được đặt trong ô của Trang tính, tràn sang các ô lân cận nếu cần.

Khi tạo hàm tuỳ chỉnh trong một tiện ích bổ sung, bạn nên tuân theo các nguyên tắc chung về hàm tuỳ chỉnh:

Ngoài ra, các hàm tuỳ chỉnh được xác định trong tiện ích bổ sung có một số điểm đặc biệt cần lưu ý:

  • Khi đặt tên cho hàm, hãy cố gắng tạo một tên riêng biệt, có thể liên quan đến tên của tiện ích bổ sung. Nếu hai hoặc nhiều tiện ích bổ sung đã cài đặt xác định các hàm tuỳ chỉnh có cùng tên, thì người dùng chỉ có thể sử dụng một trong số đó.
  • Tiện ích bổ sung của bạn phải truyền đạt rõ ràng những hàm tuỳ chỉnh mà tiện ích đó cung cấp. Hãy nhớ cung cấp chú thích JSDoc chính xác cho các hàm tuỳ chỉnh để Apps Script có thể trình bày thông tin tự động hoàn thành cho người dùng. Ngoài ra, hãy cân nhắc việc cung cấp thêm tài liệu về các hàm tuỳ chỉnh trong chính tiện ích bổ sung hoặc trên trang web hỗ trợ tiện ích bổ sung.
  • Các hàm tuỳ chỉnh không hoàn tất trong vòng 30 giây sẽ gặp lỗi Internal error executing the custom function. Tạo trải nghiệm tốt cho người dùng bằng cách giới hạn lượng dữ liệu bạn xử lý trong một hàm tuỳ chỉnh. Tối ưu hoá hàm ở những nơi bạn có thể.
  • Hàm tuỳ chỉnh không thể sử dụng các dịch vụ Apps Script yêu cầu uỷ quyền và sẽ gặp lỗi You do not have permission to call X service nếu bạn cố gắng thực hiện việc này. Chỉ sử dụng các dịch vụ được phép trong hàm tuỳ chỉnh.
  • Mỗi hàm tuỳ chỉnh trong một trang tính sẽ dẫn đến một lệnh gọi riêng biệt đến các máy chủ Apps Script. Nếu người dùng cố gắng sử dụng các hàm tuỳ chỉnh trong quá nhiều ô, thì các hàm có thể thực thi chậm. Để giảm thiểu vấn đề này, hãy giữ cho các hàm tuỳ chỉnh của bạn đơn giản nhất có thể. Nếu bạn cần hàm thực hiện quy trình xử lý phức tạp hoặc mở rộng, đừng sử dụng hàm tuỳ chỉnh mà hãy cung cấp chức năng đó thông qua một mục trình đơn, hộp thoại hoặc tương tác trên thanh bên.

Macro trong Trang tính

Macro cho phép bạn ghi lại các thao tác đã thực hiện trong Google Trang tính và lặp lại các thao tác đó sau này bằng một phím tắt. Khi bạn tạo một macro trong trang tính, macro đó sẽ được thêm dưới dạng một hàm macro trong một dự án Apps Script được liên kết với trang tính đó. Để biết thêm thông tin về macro, hãy xem bài viết Macro trong Google Trang tính.

Rất tiếc, bạn không thể phân phối macro của Trang tính cùng với các tiện ích bổ sung. Nếu bạn đưa một định nghĩa macro vào tệp kê khai của tiện ích bổ sung, thì người dùng tiện ích bổ sung đó sẽ không thể sử dụng định nghĩa đó.