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 tuỳ chỉnh, thiết lập khả năng kết nối với các hệ thống bên thứ ba và tích hợp dữ liệu 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 của Trang tính mà người khác đã tạo trên Google Workspace Marketplace.

Giải pháp

Dưới đâ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 của 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 gồm các ô 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ụ bảng 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 hành vi cũng như dữ liệu của Trang tính.

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

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

Hãy xem phần trình kích hoạt của tiện ích 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 quy định 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ừ trong ô Google Trang tính. Tiện ích bổ sung của Trang tính có thể xác định thêm hàm tuỳ chỉnh để bổ sung cho các hàm tích hợp sẵn này. Khi người dùng cài đặt tiện ích bổ sung, mọi hàm tuỳ chỉnh đã xác định đi kèm với 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 phát hành một tiện ích bổ sung chứa các định nghĩa đó.

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

Bạn có thể sử dụng bất kỳ hàm nào được xác định trong dự án tập lệnh 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ư mọi hàm tích hợp sẵn khác trong Trang tính: trong một ô 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 ô 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ần cân nhắc đặc biệt:

  • Khi đặt tên cho hàm, hãy cố gắng tạo một tên duy nhấ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 các hàm đó.
  • 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ể hiển thị thông tin tự động hoàn thành cho người dùng. Ngoài ra, hãy cân nhắc cung cấp tài liệu bổ sung 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ẽ không thành công và báo 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 xử lý trong một hàm tuỳ chỉnh. Tối ưu hoá hàm khi 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ẽ không thành công kèm theo 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 đến máy chủ Apps Script. Nếu người dùng cố gắng sử dụng 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 quá trình xử lý phức tạp hoặc mở rộng, đừng sử dụng hàm tuỳ chỉnh – 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 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 bằng phím tắt. Khi một macro được tạo trong một trang tính, macro đó sẽ được thêm dưới dạng 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 Trang tính bằng tiện ích bổ sung. Nếu bạn đưa định nghĩa macro vào tệp kê khai của một tiện ích bổ sung, thì người dùng tiện ích bổ sung đó sẽ không sử dụng được định nghĩa đó.