Trang này được dịch bởi Cloud Translation API.

Class DataSourceFormula

Truy cập và sửa đổi các công thức hiện có của nguồn dữ liệu. Để 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	Kiểu dữ liệu trả về	Mô tả ngắn
`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` đại diện cho ô nơi công thức nguồn dữ liệu này được neo vào.
`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`	Lấy 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 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

`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. Hãy xem refreshData() để biết thêm thông tin chi tiết.

Gửi một trường hợp ngoại lệ nếu loại nguồn dữ liệu chưa được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution() để cho phép thực thi dữ liệu cho 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 cần được uỷ 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()`

Trả về Range đại diện cho ô nơi công thức nguồn dữ liệu này được neo vào.

Cầu thủ trả bóng

Range – Ô liên kết.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ 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

`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 cần được uỷ 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 cần được uỷ 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 cần được uỷ 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()`

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 cần được uỷ 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 ở trạng thái error. Sử dụng DataSource#updateSpec() để cập nhật thông số kỹ thuật. Phương thức này được ưu tiên hơn forceRefreshData() để tránh các nội dung chỉnh sửa không mong muốn trên nguồn dữ liệu.

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 cần được uỷ 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.

Các tham số

Tên	Loại	Nội dung 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 cần được uỷ 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 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 trường hợp 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.

Các tham số

Tên	Loại	Nội dung mô tả
`timeoutInSeconds`	`Integer`	Thời gian chờ thực thi dữ liệu, tính bằng giây. Thời lượng 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 cần được uỷ 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