Class DataSourcePivotTable

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ứcLoại dữ liệu trả vềMô tả ngắn
addColumnGroup(columnName)PivotGroupThêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.
addFilter(columnName, filterCriteria)PivotFilterThêm bộ lọc mới dựa trên cột nguồn dữ liệu đã chỉ định với tiêu chí bộ lọc đã chỉ định.
addPivotValue(columnName)PivotValueThê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 mà không có bản tóm tắt .
addPivotValue(columnName, summarizeFunction)PivotValueThê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 cùng với nội dung tóm tắt được chỉ định .
addRowGroup(columnName)PivotGroupThêm một nhóm hàng tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.
asPivotTable()PivotTableTrả về bảng tổng hợp 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()DataSourcePivotTableHuỷ 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()DataSourcePivotTableLà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()DataSourceLấy nguồn dữ liệu liên kết với đối tượng.
getStatus()DataExecutionStatusXem trạng thái thực thi dữ liệu của đối tượng.
refreshData()DataSourcePivotTableLàm mới dữ liệu của đối tượng.
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 đã cho.

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 được chỉ định.

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà nhóm bảng tổng hợp sẽ dựa vào.

Cầu thủ trả bóng

PivotGroup – Nhóm tổng hợp mớ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

addFilter(columnName, filterCriteria)

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

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà bộ lọc sẽ dựa vào.
filterCriteriaFilterCriteriaTiêu chí mà bộ lọc sử dụng.

Cầu thủ trả bóng

PivotFilter – Bộ lọc mớ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

addPivotValue(columnName)

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 mà không có bản tóm tắt . Chỉ dành cho các chỉ số Looker.

Mã sau đây cho biết cách bạn có thể thêm một chỉ số Looker làm giá trị tổng hợp. 

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

Phương thức này chỉ áp dụng cho nguồn dữ liệu Looker.

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà giá trị tổng hợp sẽ dựa vào.

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 đượ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

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 cùng với nội dung tóm tắt được chỉ định .

Để thêm giá trị tổng hợp cho các chỉ số đo lường của Looker, hãy sử dụng addPivotValue(columnName).

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà giá trị tổng hợp sẽ dựa vào.
summarizeFunctionPivotTableSummarizeFunctionHà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

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

addRowGroup(columnName)

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

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà nhóm bảng tổng hợp sẽ dựa vào.

Cầu thủ trả bóng

PivotGroup — Nhóm bảng tổng hợp mớ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

asPivotTable()

Trả về bảng tổng hợp 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

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

cancelDataRefresh()

Huỷ làm mới dữ liệu liên kết với đối tượng này nếu đối tượng đó đ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

DataSourcePivotTable – Đố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 đối tượng này đang chạ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

DataSourcePivotTable – Đố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

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

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.

Trả về ngoại lệ nếu đ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

DataSourcePivotTable – Đố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

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ỷ thực thi dữ liệu.

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