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

Class DataSourcePivotTable

Truy cập và sửa đổi bảng tổng hợp nguồn dữ liệu hiện có. Để tạo bảng tổng hợp nguồn dữ liệu mới, hãy sử dụng Range.createDataSourcePivotTable(dataSource).

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
`addColumnGroup(columnName)`	`PivotGroup`	Thêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu đã chỉ định.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Thêm một bộ lọc mới dựa trên cột nguồn dữ liệu được chỉ định với tiêu chí lọc được chỉ định.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Thêm một giá trị tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định bằng hàm tóm tắt đã chỉ định.
`addRowGroup(columnName)`	`PivotGroup`	Thêm một nhóm hàng tổng hợp dựa trên cột nguồn dữ liệu đã chỉ định.
`asPivotTable()`	`PivotTable`	Trả về bảng tổng hợp của nguồn dữ liệu dưới dạng một đối tượng bảng tổng hợp thông thường.
`cancelDataRefresh()`	`DataSourcePivotTable`	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()`	`DataSourcePivotTable`	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.
`getDataSource()`	`DataSource`	Lấy nguồn dữ liệu mà đối tượng được liên kết.
`getStatus()`	`DataExecutionStatus`	Lấy trạng thái thực thi dữ liệu của đối tượng.
`refreshData()`	`DataSourcePivotTable`	Làm mới dữ liệu của đối tượng.
`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 đã cung cấp.

Tài liệu chi tiết

`addColumnGroup(columnName)`

Thêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu đã chỉ định.

Thông số

Tên	Loại	Nội dung mô tả
`columnName`	`String`	Tên cột nguồn dữ liệu cho nhóm tổng hợp.

Cầu thủ trả bóng

PivotGroup — Nhóm tổng hợp mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`addFilter(columnName, filterCriteria)`

Thêm một bộ lọc mới dựa trên cột nguồn dữ liệu được chỉ định với tiêu chí lọc được chỉ định.

Thông số

Tên	Loại	Nội dung mô tả
`columnName`	`String`	Tên cột nguồn dữ liệu mà bộ lọc sử dụng.
`filterCriteria`	`FilterCriteria`	Tiêu chí mà bộ lọc sử dụng.

Cầu thủ trả bóng

PivotFilter — Bộ lọc mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`addPivotValue(columnName, summarizeFunction)`

Thêm một giá trị tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định bằng hàm tóm tắt đã chỉ định.

Thông số

Tên	Loại	Nội dung mô tả
`columnName`	`String`	Tên cột nguồn dữ liệu làm cơ sở cho giá trị tổng hợp.
`summarizeFunction`	`PivotTableSummarizeFunction`	Hàm tóm tắt mà giá trị tổng hợp sử dụng.

Cầu thủ trả bóng

PivotValue – Giá trị tổng hợp mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`addRowGroup(columnName)`

Thêm một nhóm hàng tổng hợp dựa trên cột nguồn dữ liệu đã chỉ định.

Thông số

Tên	Loại	Nội dung mô tả
`columnName`	`String`	Tên cột nguồn dữ liệu cho nhóm tổng hợp.

Cầu thủ trả bóng

PivotGroup — Nhóm tổng hợp mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`asPivotTable()`

Trả về bảng tổng hợp của nguồn dữ liệu dưới dạng một đối tượng bảng tổng hợp thông thường.

Cầu thủ trả bóng

PivotTable — Bảng tổng hợp.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`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 cho thấy cách huỷ 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 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

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

`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 chi tiết. Nếu bạn muốn huỷ quá trình làm mới hiện đang chạy đối tượng này, hãy xem cancelDataRefresh().

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 mà đối tượng được liên kết.

Cầu thủ trả bóng

DataSource — Nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

Các tập lệnh sử dụng phương thức này yêu cầu 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 quy cách. Phương thức này được ưu tiên hơn forceRefreshData() để ngăn chặn các nội dung chỉnh sửa không mong muốn đối với nguồn dữ liệu.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cung cấp. 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ỷ quá trình thực thi dữ liệu.

Thông 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

Các tập lệnh sử dụng phương thức này yêu cầu 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