Class DataSourceFormula

DataSourceFormula

Mengakses dan mengubah formula sumber data yang ada. Untuk membuat formula sumber data baru, gunakan Range.setFormula(formula).

Hanya gunakan class ini dengan data yang terhubung ke database BigQuery.

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
cancelDataRefresh()DataSourceFormulaMembatalkan refresh data yang terkait dengan objek ini jika saat ini sedang berjalan.
forceRefreshData()DataSourceFormulaMemuat ulang data objek ini, terlepas dari status saat ini.
getAnchorCell()RangeMenampilkan Range yang mewakili sel tempat formula sumber data ini ditambatkan.
getDataSource()DataSourceMendapatkan sumber data yang ditautkan ke objek.
getDisplayValue()StringMenampilkan nilai tampilan formula sumber data.
getFormula()StringMenampilkan formula untuk formula sumber data ini.
getStatus()DataExecutionStatusMendapatkan status eksekusi data objek.
refreshData()DataSourceFormulaMemperbarui data objek.
setFormula(formula)DataSourceFormulaMemperbarui formula.
waitForCompletion(timeoutInSeconds)DataExecutionStatusMenunggu hingga eksekusi saat ini selesai, dengan waktu tunggu habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

cancelDataRefresh()

Membatalkan refresh data yang terkait dengan objek ini jika saat ini sedang berjalan.

Contoh ini menunjukkan cara membatalkan refresh 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 bagi jenis sumber data tertentu.

Pulang pergi

DataSourceFormula — 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 status saat ini. Lihat refreshData() untuk detail selengkapnya. Jika Anda ingin membatalkan penyegaran objek ini yang sedang berjalan, lihat cancelDataRefresh().

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi jenis sumber data tertentu.

Pulang pergi

DataSourceFormula — 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

getAnchorCell()

Menampilkan Range yang mewakili sel tempat formula sumber data ini ditambatkan.

Pulang pergi

Range — Sel penahan.

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.

Pulang pergi

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

getDisplayValue()

Menampilkan nilai tampilan formula sumber data.

Pulang pergi

String — Nilai tampilan.

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

getFormula()

Menampilkan formula untuk formula sumber data ini.

Pulang pergi

String — Formula.

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.

Pulang pergi

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()

Memperbarui data objek.

Menampilkan pengecualian jika saat ini dalam status error. Gunakan DataSource#updateSpec() untuk memperbarui spesifikasi. Metode ini lebih disukai 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 bagi jenis sumber data tertentu.

Pulang pergi

DataSourceFormula — 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

setFormula(formula)

Memperbarui formula.

Parameter

NamaJenisDeskripsi
formulaStringRumus baru.

Pulang pergi

DataSourceFormula — Formula sumber data, untuk penggabungan.

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, dengan waktu tunggu habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan eksekusi data.

Parameter

NamaJenisDeskripsi
timeoutInSecondsIntegerWaktu untuk menunggu eksekusi data, dalam detik. Maksimum 300 detik.

Pulang pergi

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