Truy cập và sửa đổi 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.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
cancelDataRefresh() | DataSourceFormula | 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 đối tượng hiện đang chạy. |
forceRefreshData() | DataSourceFormula | 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. |
getAnchorCell() | Range | Trả về Range biểu thị ô chứa công thức nguồn dữ liệu này. |
getDataSource() | DataSource | Lấy nguồn dữ liệu liên kết với đối tượng. |
getDisplayValue() | String | Trả về giá trị hiển thị của công thức nguồn dữ liệu. |
getFormula() | String | Trả về công thức cho công thức nguồn dữ liệu này. |
getStatus() | DataExecutionStatus | Xem trạng thái thực thi dữ liệu của đối tượng. |
refreshData() | DataSourceFormula | Làm mới dữ liệu của đối tượng. |
setFormula(formula) | DataSourceFormula | Cập nhật công thức. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | 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 đã cho. |
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 đối tượng hiện đang chạy.
Ví dụ này trình bày 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ửi một trường hợp 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()
để cho phép thực thi dữ liệu đối với nguồn dữ liệu cụ thể
loại.
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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
chi tiết hơn. Nếu bạn muốn huỷ quá trình làm mới hiện đang chạy của đối tượng này, hãy xem cancelDataRefresh()
.
Gửi một trường hợp 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()
để cho phép thực thi dữ liệu đối với nguồn dữ liệu cụ thể
loại.
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
getDataSource()
Lấy nguồn dữ liệu liên kết với đối tượng.
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Xem 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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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ửi một ngoại lệ nếu hiện đang ở trạng thái error
. Sử dụng DataSource#updateSpec()
để cập nhật thông số kỹ thuật. Phương thức là
được ưu tiên hơn forceRefreshData()
để ngăn các chỉnh sửa không mong muốn đối với nguồn dữ liệu.
Gửi một trường hợp 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()
để cho phép thực thi dữ liệu đối với nguồn dữ liệu cụ thể
loại.
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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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ên | Loại | Mô tả |
---|---|---|
formula | String | Cô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 ủy quyền với một hoặc nhiều phạm vi sau:
-
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 đã cho. Gửi 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ỷ thực thi dữ liệu.
Tham số
Tên | Loại | Mô tả |
---|---|---|
timeoutInSeconds | Integer | Thờ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 ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets