Mở rộng Google Trang tính

Sử dụng Google Apps Script để mở rộng Trang tính. Thêm trình đơn tuỳ chỉnh, hộp thoại và thanh bên vào Trang tính. Viết hàm tuỳ chỉnh cho Trang tính và tích hợp hàm đó với các dịch vụ khác của Google như Lịch Google, Google Drive và Gmail.

Hầu hết các tập lệnh được thiết kế cho Trang tính đều thao tác với các mảng để tương tác với các ô, hàng và cột trong bảng tính. Nếu bạn chưa quen với mảng trong JavaScript, Codecademy có một mô-đun đào tạo tuyệt vời về mảng. Khoá học này không phải do Google phát triển và không liên kết với Google.

Để xem phần giới thiệu nhanh về cách sử dụng Apps Script với Trang tính, hãy xem hướng dẫn bắt đầu nhanh trong 5 phút về Macro, trình đơn và hàm tuỳ chỉnh.

Bắt đầu

Apps Script có các API đặc biệt để tạo, đọc và chỉnh sửa Trang tính theo phương thức lập trình. Apps Script tương tác với Trang tính theo hai cách: mọi tập lệnh đều có thể tạo hoặc sửa đổi một bảng tính nếu người dùng của tập lệnh có các quyền thích hợp cho bảng tính đó, đồng thời một tập lệnh cũng có thể được liên kết với một bảng tính. Tập lệnh liên kết có khả năng đặc biệt là thay đổi giao diện người dùng hoặc phản hồi khi bảng tính được mở. Để tạo một tập lệnh liên kết, hãy chọn Tiện ích > Apps Script trong Trang tính.

Dịch vụ Bảng tính coi Trang tính là một lưới, hoạt động với mảng hai chiều. Để truy xuất dữ liệu từ bảng tính, hãy truy cập vào bảng tính nơi dữ liệu được lưu trữ, lấy dải ô chứa dữ liệu, rồi lấy giá trị của các ô. Apps Script hỗ trợ việc truy cập dữ liệu bằng cách đọc dữ liệu có cấu trúc trong bảng tính và tạo các đối tượng JavaScript cho dữ liệu đó.

Đọc dữ liệu

Giả sử bạn có một danh sách tên sản phẩm và số sản phẩm mà bạn lưu trữ trong một bảng tính, như minh hoạ trong hình ảnh sau.

Ví dụ sau đây cho thấy cách truy xuất và ghi nhật ký tên sản phẩm và số sản phẩm.

function logProductInfo() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const data = sheet.getDataRange().getValues();
  for (let i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

Xem nhật ký

Để xem dữ liệu đã được ghi lại, ở đầu trình chỉnh sửa tập lệnh, hãy nhấp vào Nhật ký thực thi.

Ghi dữ liệu

Để lưu trữ dữ liệu, chẳng hạn như tên và số sản phẩm mới vào bảng tính, hãy thêm mã sau vào cuối tập lệnh.

function addProduct() {
  const sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

Đoạn mã trước đó sẽ thêm một hàng mới vào cuối bảng tính, với các giá trị được chỉ định. Nếu bạn chạy hàm này, một hàng mới sẽ được thêm vào bảng tính.

Trình đơn và giao diện người dùng tuỳ chỉnh

Tuỳ chỉnh Trang tính bằng cách thêm trình đơn, hộp thoại và thanh bên tuỳ chỉnh. Để tìm hiểu kiến thức cơ bản về cách tạo trình đơn, hãy xem hướng dẫn về trình đơn. Để tìm hiểu về cách tuỳ chỉnh nội dung của hộp thoại, hãy xem hướng dẫn về dịch vụ HTML.

Đính kèm một hàm tập lệnh vào hình ảnh hoặc bản vẽ trong bảng tính; hàm này sẽ thực thi khi người dùng nhấp vào hình ảnh hoặc bản vẽ đó. Để tìm hiểu thêm, hãy xem phần Hình ảnh và bản vẽ trong Trang tính.

Nếu bạn dự định xuất bản giao diện tuỳ chỉnh của mình trong một tiện ích bổ sung, hãy làm theo hướng dẫn về kiểu để đảm bảo tính nhất quán với kiểu và bố cục của trình chỉnh sửa Trang tính.

Kết nối với Google Biểu mẫu

Kết nối Google Biểu mẫu với Trang tính thông qua các dịch vụ Biểu mẫu và Trang tính. Tính năng này tự động tạo một biểu mẫu trên Google Biểu mẫu dựa trên dữ liệu trong bảng tính. Apps Script cũng cho phép bạn sử dụng trình kích hoạt, chẳng hạn như onFormSubmit để thực hiện một hành động cụ thể sau khi người dùng phản hồi biểu mẫu. Để tìm hiểu thêm về cách kết nối Trang tính với Biểu mẫu, hãy thử hướng dẫn nhanh 5 phút về Quản lý câu trả lời cho Biểu mẫu.

Định dạng dữ liệu

Lớp Range có các phương thức như setBackground để truy cập và sửa đổi định dạng của một ô hoặc dải ô. Ví dụ sau đây đặt kiểu phông chữ cho một dải ô:

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheets()[0];
  const cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

Xác thực dữ liệu

Truy cập vào các quy tắc xác thực dữ liệu hiện có trong Trang tính hoặc tạo quy tắc mới. Ví dụ: mẫu sau đây cho thấy cách thiết lập một quy tắc xác thực dữ liệu chỉ cho phép các số từ 1 đến 100 trên một ô.

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  const cell = SpreadsheetApp.getActive().getRange('B4');
  const rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

Để biết thêm thông tin về cách sử dụng quy tắc xác thực dữ liệu, hãy xem SpreadsheetApp.newDataValidation, DataValidationBuilder và Range.setDataValidation

Biểu đồ

Nhúng biểu đồ vào bảng tính để biểu thị dữ liệu trong một dải ô cụ thể. Ví dụ sau đây tạo một biểu đồ thanh được nhúng, giả sử bạn có dữ liệu có thể lập biểu đồ trong các ô A1:B15:

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheets()[0];

  const chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

Để tìm hiểu thêm về cách nhúng biểu đồ vào bảng tính, hãy xem EmbeddedChart và các trình tạo biểu đồ cụ thể, chẳng hạn như EmbeddedPieChartBuilder.

Hàm tuỳ chỉnh trong Google Trang tính

Hàm tuỳ chỉnh tương tự như một hàm tích hợp trong bảng tính, chẳng hạn như =SUM(A1:A5), ngoại trừ việc bạn xác định hành vi của hàm bằng Apps Script. Ví dụ: bạn có thể tạo một hàm tuỳ chỉnh, in2mm(), để chuyển đổi một giá trị từ inch sang milimet, sau đó sử dụng công thức trong bảng tính bằng cách nhập =in2mm(A1) hoặc =in2mm(10) vào một ô.

Để tìm hiểu thêm về hàm tuỳ chỉnh, hãy thử Trình đơn và hàm tuỳ chỉnh trong hướng dẫn bắt đầu nhanh dài 5 phút hoặc xem hướng dẫn chi tiết hơn về hàm tuỳ chỉnh.

Macro

Macro là một cách khác để thực thi mã Apps Script từ giao diện người dùng của Trang tính. Không giống như hàm tuỳ chỉnh, bạn kích hoạt các hàm được đặt tên bằng phím tắt hoặc thông qua trình đơn Trang tính. Để biết thêm thông tin, hãy xem bài viết Macro trong Trang tính.

Tiện ích bổ sung cho Google Trang tính

Tiện ích bổ sung là các dự án Apps Script được đóng gói đặc biệt, chạy trong Trang tính và có thể được cài đặt từ cửa hàng tiện ích bổ sung của Trang tính. Nếu đã phát triển một tập lệnh cho Trang tính và muốn chia sẻ tập lệnh đó, thì Apps Script cho phép bạn xuất bản tập lệnh dưới dạng một tiện ích bổ sung để người dùng khác có thể cài đặt.

Hiệu suất và khả năng mở rộng

Khi tập dữ liệu của bạn tăng lên, bạn có thể gặp phải các vấn đề về hiệu suất. Cách tối ưu hoá bảng tính và tập lệnh:

Làm theo các phương pháp hay nhất: Đọc Hướng dẫn về các phương pháp hay nhất để biết các mẹo giúp giảm thiểu lệnh gọi dịch vụ và sử dụng các thao tác hàng loạt.
Tối ưu hoá công thức: Nếu bảng tính của bạn bị chậm do công thức phức tạp (chẳng hạn như VLOOKUP, ARRAYFORMULA hoặc IMPORTRANGE), hãy cân nhắc sử dụng Apps Script để thực hiện các phép tính này trong bộ nhớ và ghi kết quả trở lại theo lô.
Cân nhắc các lựa chọn thay thế cho cơ sở dữ liệu: Đối với các tập dữ liệu rất lớn (gần 10 triệu ô) hoặc mục nhập dữ liệu có tần suất cao (ví dụ: nhiều biểu mẫu được kết nối), hãy cân nhắc sử dụng Google Cloud SQL bằng JDBC hoặc BigQuery.

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

Các tập lệnh được liên kết với một tệp Trang tính có thể sử dụng trình kích hoạt đơn giản như các hàm onOpen() và onEdit() để tự động phản hồi khi người dùng có quyền chỉnh sửa đối với bảng tính mở hoặc chỉnh sửa bảng tính. Giống như trình kích hoạt đơn giản, trình kích hoạt có thể cài đặt cho phép Trang tính tự động chạy một hàm khi một sự kiện nhất định xảy ra. Tuy nhiên, trình kích hoạt có thể cài đặt linh hoạt hơn trình kích hoạt đơn giản và hỗ trợ các sự kiện sau: mở, chỉnh sửa, thay đổi, gửi biểu mẫu và theo thời gian (đồng hồ).

Mở rộng Google Trang tính Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.