Class DataSourceFormula

DataSourceFormula

Truy cập và sửa đổi các công thức nguồn dữ liệu hiện có. Để tạo công thức nguồn dữ liệu mới, hãy sử dụng Range.setFormula(formula).

Chỉ sử dụng lớp này với dữ liệu được kết nối với cơ sở dữ liệu BigQuery.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
cancelDataRefresh()DataSourceFormulaHuỷ quá trình làm mới dữ liệu được liên kết với đối tượng này nếu quá trình đó đang chạy.
forceRefreshData()DataSourceFormulaLàm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại.
getAnchorCell()RangeTrả về Range biểu thị ô mà công thức nguồn dữ liệu này được neo.
getDataSource()DataSourceLấy nguồn dữ liệu mà đối tượng được liên kết.
getDisplayValue()StringTrả về giá trị hiển thị của công thức nguồn dữ liệu.
getFormula()StringTrả về công thức cho công thức nguồn dữ liệu này.
getStatus()DataExecutionStatusLấy trạng thái thực thi dữ liệu của đối tượng.
refreshData()DataSourceFormulaLàm mới dữ liệu của đối tượng.
setFormula(formula)DataSourceFormulaCập nhật công thức.
waitForCompletion(timeoutInSeconds)DataExecutionStatusChờ cho đến khi quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây được cung cấp.

Tài liệu chi tiết

cancelDataRefresh()

Huỷ quá trình làm mới dữ liệu được liên kết với đối tượng này nếu quá trình đó đang chạy.

Ví dụ này cho biết cách huỷ quá trình làm mới công thức. 

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Gây ra một ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution() để bật tính năng thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.

Cầu thủ trả bóng

DataSourceFormula – Đối tượng dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forceRefreshData()

Làm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại. Xem refreshData() để biết thêm thông tin. Nếu bạn muốn huỷ quá trình làm mới đang chạy của đối tượng này, hãy xem cancelDataRefresh().

Gây ra một ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution() để bật tính năng thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.

Cầu thủ trả bóng

DataSourceFormula – Đối tượng dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCell()

Trả về Range biểu thị ô mà công thức nguồn dữ liệu này được neo.

Cầu thủ trả bóng

Range – Ô neo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSource()

Lấy nguồn dữ liệu mà đối tượng được liên kết.

Cầu thủ trả bóng

DataSource – Nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDisplayValue()

Trả về giá trị hiển thị của công thức nguồn dữ liệu.

Cầu thủ trả bóng

String – Giá trị hiển thị.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFormula()

Trả về công thức cho công thức nguồn dữ liệu này.

Cầu thủ trả bóng

String – Công thức.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getStatus()

Lấy trạng thái thực thi dữ liệu của đối tượng.

Cầu thủ trả bóng

DataExecutionStatus – Trạng thái thực thi dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshData()

Làm mới dữ liệu của đối tượng.

Gây ra một ngoại lệ nếu hiện ở trạng thái error. Sử dụng DataSource#updateSpec() để cập nhật thông số kỹ thuật. Bạn nên sử dụng phương thức này thay vì forceRefreshData() để ngăn việc chỉnh sửa không mong muốn trên nguồn dữ liệu.

Gây ra một ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution() để bật tính năng thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.

Cầu thủ trả bóng

DataSourceFormula – Đối tượng dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormula(formula)

Cập nhật công thức.

Tham số

TênLoạiMô tả
formulaStringCông thức mới.

Cầu thủ trả bóng

DataSourceFormula – Công thức nguồn dữ liệu, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

Chờ cho đến khi quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây được cung cấp. Gây ra một ngoại lệ nếu quá trình thực thi không hoàn tất khi hết thời gian chờ, nhưng không huỷ quá trình thực thi dữ liệu.

Tham số

TênLoạiMô tả
timeoutInSecondsIntegerThời gian chờ thực thi dữ liệu, tính bằng giây. Tối đa là 300 giây.

Cầu thủ trả bóng

DataExecutionStatus – Trạng thái thực thi dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets