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ẽ giúp trực quan hoá, xử lý và giao tiếp 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 của bên thứ ba và tích hợp dữ liệu của bạn trên Trang tính với các ứng dụng khác của Google Workspace (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.

Việc bạn có thể làm

Dưới đây là một vài thao tác mà bạn có thể làm với tiện ích bổ sung giúp mở rộng Google Trang tính:

Tiện ích bổ sung Trang tính được xây dựng 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 để 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 để đại diện cho cơ cấu 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 trên Trang tính.

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

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

Xem nội dung điều kiện kích hoạt tiện ích bổ sung để biết thêm thông tin về những điều kiện 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.

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 ô Google Trang tính. Tiện ích bổ sung trong Trang tính có thể xác định thêm các 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 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. Các định nghĩa hàm tuỳ chỉnh chủ yếu được chia sẻ với những 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 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 ô Trang tính, hãy nhập = theo sau là tên hàm và mọi tham số bắt buộc. Nếu không có lỗi, kết quả mà hàm trả về sẽ được đặt trong ô Trang tính, tràn sang các ô lân cận khi 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 biệt cần cân nhắc:

  • 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 tiện ích bổ sung đó.
  • Tiện ích bổ sung của bạn phải truyền đạt rõ ràng những chức năng tuỳ chỉnh mà tiện ích bổ sung đó cung cấp. Hãy nhớ cung cấp nhận xét JSDoc chính xác cho các hàm tuỳ chỉnh của bạn để Apps Script có thể hiển thị thông tin tự động hoàn tất cho người dùng. Ngoài ra, hãy cân nhắc việ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 hoạt động và gặp lỗi Internal error executing the custom function. Tạo trải nghiệm người dùng tốt bằng cách giới hạn khối lượng xử lý bạn thực hiện trong một hàm tuỳ chỉnh. Tối ưu hoá hàm này khi có thể.
  • Các 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 hoạt động với lỗi You do not have permission to call X service nếu bạn đã cố gắng thực hiện thao tác này. Chỉ sử dụng các dịch vụ được cho phép trong hàm tuỳ chỉnh của bạn.
  • 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 các máy chủ Apps Script. Nếu người dùng cố 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 điều này, hãy đảm bảo hàm tuỳ chỉnh của bạn càng đơn giản càng tốt. Nếu cần hàm thực hiện quá trình xử lý phức tạp hoặc mở rộng, thì bạn không nên sử dụng hàm tuỳ chỉnh. Thay vào đó, hãy cung cấp chức năng đó thông qua một mục trong trình đơn, hộp thoại hoặc hoạt động tương tác với thanh bên.

Macro của Trang tính

Macro cho phép bạn ghi lại các thao tác được thực hiện trong Google Trang tính rồi lặp lại các thao tác đó sau bằng phím tắt. Khi macro được tạo trong một trang tính, macro này sẽ được thêm dưới dạng hàm macro trong dự án Apps Script liên kết với trang tính đó. Để biết thêm thông tin về macro, hãy xem phần macro 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 tiện ích bổ sung. Nếu bạn đưa định nghĩa macro vào tệp kê khai của tiện ích bổ sung, người dùng tiện ích bổ sung đó sẽ không sử dụng được định nghĩa đó.