Mengakses dan mengubah tabel pivot sumber data yang ada. Untuk membuat tabel pivot sumber data baru, gunakan
Range.createDataSourcePivotTable(dataSource)
.
Hanya gunakan class ini dengan data yang terhubung ke database.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addColumnGroup(columnName) | PivotGroup | Menambahkan grup kolom pivot baru berdasarkan kolom sumber data yang ditentukan. |
addFilter(columnName, filterCriteria) | PivotFilter | Menambahkan filter baru berdasarkan kolom sumber data yang ditentukan dengan kriteria filter yang ditentukan. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan dengan fungsi summarize yang ditentukan. |
addRowGroup(columnName) | PivotGroup | Menambahkan grup baris pivot baru berdasarkan kolom sumber data yang ditentukan. |
asPivotTable() | PivotTable | Menampilkan tabel pivot sumber data sebagai objek tabel pivot reguler. |
cancelDataRefresh() | DataSourcePivotTable | Membatalkan refresh data yang terkait dengan objek ini jika sedang berjalan. |
forceRefreshData() | DataSourcePivotTable | Memuat ulang data objek ini, terlepas dari statusnya saat ini. |
getDataSource() | DataSource | Mendapatkan sumber data yang ditautkan ke objek. |
getStatus() | DataExecutionStatus | Mendapatkan status eksekusi data objek. |
refreshData() | DataSourcePivotTable | Memuat ulang data objek. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Menunggu hingga eksekusi saat ini selesai, akan kehabisan waktu setelah jumlah detik yang diberikan. |
Dokumentasi mendetail
addColumnGroup(columnName)
Menambahkan grup kolom pivot baru berdasarkan kolom sumber data yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnName | String | Nama kolom sumber data yang menjadi dasar grup pivot. |
Return
PivotGroup
— Grup pivot baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
Menambahkan filter baru berdasarkan kolom sumber data yang ditentukan dengan kriteria filter yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnName | String | Nama kolom sumber data yang menjadi dasar filter. |
filterCriteria | FilterCriteria | Kriteria yang digunakan filter. |
Return
PivotFilter
— Filter baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan dengan fungsi summarize yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnName | String | Nama kolom sumber data yang menjadi dasar nilai pivot. |
summarizeFunction | PivotTableSummarizeFunction | Fungsi summarize yang digunakan nilai pivot. |
Return
PivotValue
— Nilai pivot baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
Menambahkan grup baris pivot baru berdasarkan kolom sumber data yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnName | String | Nama kolom sumber data yang menjadi dasar grup pivot. |
Return
PivotGroup
— Grup pivot baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asPivotTable()
Menampilkan tabel pivot sumber data sebagai objek tabel pivot reguler.
Return
PivotTable
— Tabel pivot.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancelDataRefresh()
Membatalkan refresh data yang terkait dengan objek ini jika sedang berjalan.
Contoh ini menunjukkan cara membatalkan pemuatan ulang formula.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode
SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Return
DataSourcePivotTable
— Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Memuat ulang data objek ini, terlepas dari statusnya saat ini. Lihat refreshData()
untuk
detail selengkapnya. Jika Anda ingin membatalkan refresh objek yang sedang berjalan ini, lihat cancelDataRefresh()
.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Return
DataSourcePivotTable
— Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Mendapatkan sumber data yang ditautkan ke objek.
Return
DataSource
— Sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Mendapatkan status eksekusi data objek.
Return
DataExecutionStatus
— Status eksekusi data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Memuat ulang data objek.
Menampilkan pengecualian jika saat ini dalam status error
. Gunakan DataSource#updateSpec()
untuk memperbarui spesifikasi. Metode ini
lebih disarankan daripada forceRefreshData()
untuk mencegah pengeditan yang tidak terduga pada sumber data.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Return
DataSourcePivotTable
— Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Menunggu hingga eksekusi saat ini selesai, akan kehabisan waktu setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan eksekusi data.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
timeoutInSeconds | Integer | Waktu tunggu eksekusi data, dalam detik. Durasi maksimumnya adalah 300 detik. |
Return
DataExecutionStatus
— Status eksekusi data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets