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

Google Trang tính cung cấp hàng trăm hàm tích hợp sẵn như AVERAGE, SUM và VLOOKUP. Nếu những hàm này không đáp ứng đủ nhu cầu của bạn, bạn có thể dùng Apps Script để viết hàm tuỳ chỉnh, sau đó sử dụng các hàm này trong Trang tính giống như hàm tích hợp sẵn.

Để xem ví dụ về hàm tuỳ chỉnh, hãy tham khảo các hướng dẫn sau:

• Tính giá bán của các mặt hàng được chiết khấu (hướng dẫn nhanh)
• Tính mức chiết khấu theo giá theo bậc
• Tính khoảng cách lái xe và chuyển đổi mét thành dặm
• Tóm tắt dữ liệu từ nhiều trang tính
• Kiểm tra tính xác thực của các câu lệnh bằng tác nhân AI ADK và mô hình Gemini

Bắt đầu

Hàm tuỳ chỉnh được tạo bằng JavaScript tiêu chuẩn. Nếu bạn mới làm quen với JavaScript, Codecademy có một khoá học dành cho người mới bắt đầu. 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.

Sau đây là một hàm tuỳ chỉnh có tên là DOUBLE, hàm này nhân giá trị đầu vào với 2:

/**
 * Multiplies an input value by 2.
 * @param {number} input The number to double.
 * @return The input multiplied by 2.
 * @customfunction
*/
function DOUBLE(input) {
  return input * 2;
}

Nếu bạn không biết cách viết JavaScript và không có thời gian để học, hãy kiểm tra cửa hàng tiện ích bổ sung Google Workspace để xem có người khác đã tạo hàm tuỳ chỉnh bạn cần hay chưa.

Tạo hàm tuỳ chỉnh

Cách viết hàm tuỳ chỉnh:

1. Tạo hoặc mở một bảng tính trong Trang tính.
2. Chọn mục trình đơn Tiện ích mở rộng > Apps Script.
3. Xoá mọi mã trong trình chỉnh sửa tập lệnh. Đối với hàm DOUBLE được minh hoạ trước đó, hãy sao chép và dán mã vào trình chỉnh sửa tập lệnh.
4. Ở trên cùng, hãy nhấp vào biểu tượng Lưu save.

Giờ đây, bạn có thể sử dụng hàm tuỳ chỉnh.

Tải hàm tuỳ chỉnh từ Google Workspace Marketplace

Google Workspace Marketplace cung cấp một số hàm tuỳ chỉnh dưới dạng tiện ích bổ sung Google Workspace cho Trang tính. Cách sử dụng hoặc khám phá các tiện ích bổ sung này:

1. Tạo hoặc mở một bảng tính trong Trang tính.
2. Ở trên cùng, hãy nhấp vào Tiện ích bổ sung > Tải tiện ích bổ sung.
3. Sau khi Google Workspace Marketplace mở ra, hãy nhấp vào hộp tìm kiếm ở góc trên cùng bên phải.
4. Nhập "hàm tuỳ chỉnh" rồi nhấn phím Enter.
5. Nếu bạn tìm thấy một tiện ích bổ sung hàm tuỳ chỉnh mà bạn quan tâm, hãy nhấp vào Cài đặt để cài đặt tiện ích đó.
6. Một hộp thoại có thể cho bạn biết rằng tiện ích bổ sung đó cần được uỷ quyền. Nếu vậy, hãy đọc kỹ thông báo rồi nhấp vào Cho phép.
7. Tiện ích bổ sung sẽ có trong bảng tính. Để sử dụng tiện ích bổ sung này trong một bảng tính khác, hãy mở bảng tính đó rồi ở trên cùng, nhấp vào Tiện ích bổ sung > Quản lý tiện ích bổ sung. Tìm tiện ích bổ sung mà bạn muốn sử dụng rồi nhấp vào Tuỳ chọn more_vert > Sử dụng trong tài liệu này.

Sử dụng hàm tuỳ chỉnh

Sau khi bạn viết hoặc cài đặt một hàm tuỳ chỉnh từ Google Workspace Marketplace, hàm đó sẽ được sử dụng giống như hàm tích hợp sẵn:

1. Nhấp vào ô mà bạn muốn sử dụng hàm.
2. Nhập dấu bằng (=) rồi nhập tên hàm và giá trị đầu vào bất kỳ — ví dụ: =DOUBLE(A1) — sau đó nhấn phím Enter.
3. Ô sẽ hiển thị Loading... trong giây lát, sau đó trả về kết quả.

Nguyên tắc áp dụng hàm tuỳ chỉnh

Trước khi viết hàm tuỳ chỉnh của riêng bạn, bạn cần biết một số nguyên tắc.

Đặt tên hàm

Ngoài các quy ước tiêu chuẩn để đặt tên hàm JavaScript, hãy lưu ý những điều sau:

• Tên của hàm tuỳ chỉnh phải khác với tên của các hàm tích hợp sẵn như SUM().
• Tên của hàm tuỳ chỉnh không được kết thúc bằng dấu gạch dưới (_). Dấu gạch dưới này biểu thị một hàm riêng tư trong Apps Script.
• Tên của hàm tuỳ chỉnh phải được khai báo bằng cú pháp function myFunction(), chứ không phải var myFunction = new Function().
• Việc viết hoa không quan trọng, mặc dù tên của các hàm trong bảng tính thường được viết hoa.

Đối số

Giống như hàm tích hợp sẵn, hàm tuỳ chỉnh có thể nhận đối số làm giá trị đầu vào:

• Nếu bạn gọi hàm bằng cách tham chiếu đến một ô duy nhất làm đối số (như =DOUBLE(A1)), thì đối số đó là giá trị của ô.

• Nếu bạn gọi hàm bằng cách tham chiếu đến một dải ô làm đối số (như =DOUBLE(A1:B10)), thì đối số đó là một mảng hai chiều gồm các giá trị của ô. Ví dụ: trong ảnh chụp màn hình sau, các đối số trong =DOUBLE(A1:B2) được Apps Script diễn giải là double([[1,3],[2,4]]). Xin lưu ý rằng bạn cần sửa đổi mã mẫu cho DOUBLE được mô tả trước đó để chấp nhận một mảng làm dữ liệu đầu vào.

  
  

• Đối số của hàm tuỳ chỉnh phải có tính xác định. Tức là các hàm tích hợp sẵn trong bảng tính trả về kết quả khác nhau mỗi khi tính toán (chẳng hạn như NOW() hoặc RAND()) không được phép làm đối số cho hàm tuỳ chỉnh. Nếu một hàm tuỳ chỉnh cố gắng trả về một giá trị dựa trên một trong những hàm tích hợp sẵn dễ thay đổi này, thì hàm đó sẽ hiển thị Loading... vô thời hạn.

• Để kích hoạt quá trình tính toán lại, bạn phải truyền trực tiếp một ô hoặc dải ô được tham chiếu làm đối số cho hàm tuỳ chỉnh. Nếu không, hàm tuỳ chỉnh sẽ không tính toán lại cho đến khi bạn chỉnh sửa hàm hoặc thay đổi giá trị của một ô được tham chiếu. Nếu bạn sử dụng phương thức getValue trong hàm tuỳ chỉnh, hãy lưu ý rằng dải ô được tham chiếu không được truyền trực tiếp làm đối số cho hàm tuỳ chỉnh.

Giá trị trả về

Mọi hàm tuỳ chỉnh đều phải trả về một giá trị để hiển thị, sao cho:

• Nếu một hàm tuỳ chỉnh trả về một giá trị, thì giá trị đó sẽ hiển thị trong ô mà hàm được gọi.
• Nếu một hàm tuỳ chỉnh trả về một mảng hai chiều gồm các giá trị, thì các giá trị đó sẽ tràn vào các ô liền kề miễn là các ô đó trống. Nếu điều này khiến mảng ghi đè nội dung ô hiện có, thì hàm tuỳ chỉnh sẽ đưa ra lỗi. Để xem ví dụ, hãy tham khảo phần về cách tối ưu hoá hàm tuỳ chỉnh.
• Hàm tuỳ chỉnh không thể ảnh hưởng đến các ô khác ngoài những ô mà hàm đó trả về giá trị. Nói cách khác, hàm tuỳ chỉnh không thể chỉnh sửa các ô tuỳ ý, mà chỉ có thể chỉnh sửa các ô mà hàm đó được gọi và các ô liền kề. Để chỉnh sửa các ô tuỳ ý, hãy sử dụng trình đơn tuỳ chỉnh để chạy một hàm.
• Lệnh gọi hàm tuỳ chỉnh phải trả về trong vòng 30 giây. Nếu không, ô sẽ hiển thị #ERROR! và ghi chú ô là Exceeded maximum execution time (line 0).

Loại dữ liệu

Trang tính lưu trữ dữ liệu ở nhiều định dạng tuỳ thuộc vào bản chất của dữ liệu. Khi các giá trị này được sử dụng trong hàm tuỳ chỉnh, Apps Script sẽ coi các giá trị này là loại dữ liệu thích hợp trong JavaScript. Đây là những trường hợp dễ gây nhầm lẫn nhất:

• Thời gian và ngày trong Trang tính trở thành đối tượng Ngày trong Apps Script. Nếu bảng tính và tập lệnh sử dụng các múi giờ khác nhau (một vấn đề hiếm gặp), thì hàm tuỳ chỉnh cần phải bù đắp.
• Giá trị thời lượng trong Trang tính cũng trở thành đối tượng Date, nhưng việc xử lý các giá trị này có thể phức tạp.
• Giá trị phần trăm trong Trang tính trở thành số thập phân trong Apps Script. Ví dụ: một ô có giá trị 10% sẽ trở thành 0.1 trong Apps Script.

Tự động hoàn thành

Trang tính hỗ trợ tính năng tự động hoàn thành cho hàm tuỳ chỉnh giống như đối với hàm tích hợp sẵn. Khi bạn nhập tên hàm vào một ô, bạn sẽ thấy danh sách các hàm tích hợp sẵn và hàm tuỳ chỉnh khớp với nội dung bạn nhập.

Hàm tuỳ chỉnh xuất hiện trong danh sách này nếu tập lệnh của hàm đó có JSDoc @customfunction, như trong DOUBLE() ví dụ.

/**
 * Multiplies the input value by 2.
 *
 * @param {number} input The value to multiply.
 * @return {number} The input multiplied by 2.
 * @customfunction
 */
function DOUBLE(input) {
  return input * 2;
}

/**
 * Multiplies the input value by 2.
 *
 * @param {number|Array<Array<number>>} input The value or range of cells
 *     to multiply.
 * @return The input multiplied by 2.
 * @customfunction
 */
function DOUBLE(input) {
  return Array.isArray(input) ?
      input.map(row => row.map(cell => cell * 2)) :
      input * 2;
}

/**
 * Show the title and date for the first page of posts on the
 * Developer blog.
 *
 * @return Two columns of data representing posts on the
 *     Developer blog.
 * @customfunction
 */
function getBlogPosts() {
  var array = [];
  var url = 'https://gsuite-developers.googleblog.com/atom.xml';
  var xml = UrlFetchApp.fetch(url).getContentText();
  var document = XmlService.parse(xml);
  var root = document.getRootElement();
  var atom = XmlService.getNamespace('http://www.w3.org/2005/Atom');
  var entries = document.getRootElement().getChildren('entry', atom);
  for (var i = 0; i < entries.length; i++) {
    var title = entries[i].getChild('title', atom).getText();
    var date = entries[i].getChild('published', atom).getValue();
    array.push([title, date]);
  }
  return array;
}