Class DataViewDefinitionBuilder

VeriGörünümüTanımOluşturucu

DataViewDefinition nesneleri için oluşturucu.

Oluşturucuyu kullanma örneğini aşağıda bulabilirsiniz. Veriler bir Google e-tablosundan içe aktarılır.

function doGet() {
  // This example creates two table charts side by side. One uses a data view
  // definition to restrict the number of displayed columns.

  // Get sample data from a spreadsheet.
  const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

  // Create a chart to display all of the data.
  const originalChart = Charts.newTableChart()
                            .setDimensions(600, 500)
                            .setDataSourceUrl(dataSourceUrl)
                            .build();

  // Create another chart to display a subset of the data (only columns 1 and
  // 4).
  const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]);
  const limitedChart = Charts.newTableChart()
                           .setDimensions(200, 500)
                           .setDataSourceUrl(dataSourceUrl)
                           .setDataViewDefinition(dataViewDefinition)
                           .build();

  const htmlOutput = HtmlService.createHtmlOutput();
  const originalChartData = Utilities.base64Encode(
      originalChart.getAs('image/png').getBytes(),
  );
  const originalChartUrl =
      `data:image/png;base64,${encodeURI(originalChartData)}`;
  const limitedChartData = Utilities.base64Encode(
      limitedChart.getAs('image/png').getBytes(),
  );
  const limitedChartUrl =
      `data:image/png;base64,${encodeURI(limitedChartData)}`;
  htmlOutput.append('<table><tr><td>');
  htmlOutput.append(`<img border="1" src="${originalChartUrl}">`);
  htmlOutput.append('</td><td>');
  htmlOutput.append(`<img border="1" src="${limitedChartUrl}">`);
  htmlOutput.append('</td></tr></table>');
  return htmlOutput;
}

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
build()	DataViewDefinition	Bu oluşturucu kullanılarak oluşturulan veri görünümü tanımı nesnesini oluşturur ve döndürür.
setColumns(columns)	DataViewDefinitionBuilder	Veri görünümüne dahil edilecek sütunların dizinlerini ayarlar ve rol sütunu bilgilerini belirtir.

Ayrıntılı dokümanlar

build()

Bu oluşturucu kullanılarak oluşturulan veri görünümü tanımı nesnesini oluşturur ve döndürür.

Return

DataViewDefinition: Bu oluşturucu kullanılarak oluşturulan bir veri görünümü tanımı nesnesi.

---

setColumns(columns)

Veri görünümüne dahil edilecek sütunların dizinlerini ayarlar ve rol sütunu bilgilerini belirtir. Bu sütun dizini alt kümesi, veri görünümünün türetildiği veri kaynağının sütunlarını ifade eder.

Sütun rolü, ilgili sütundaki verilerin amacını açıklar. Örneğin, bir sütunda ipucu metnini, veri noktası ek açıklamalarını veya belirsizlik göstergelerini açıklayan veriler bulunabilir. Daha fazla bilgi için Google Grafikler belgelerindeki VeriTablo Rolleri bölümüne bakın.

A1:C3 alanında aşağıdaki verileri içeren bir e-tablo olduğunu varsayalım:

'abc', 20, 'blue';
'def', 30, 'red';
'ghi', 40, 'orange';

Aşağıdaki kod, her çubuğun farklı renkte olduğu bir çubuk grafik oluşturur. Renkler, stil "rol sütunu" aracılığıyla atanır.

const COLUMN_SPEC = [
  0,  // categories
  1,  // counts
  {sourceColumn: 2, role: 'style'},
];

function roleColumnChart() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getActiveSheet();
  const viewSpec =
      Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build();
  const chartBuilder = sheet.newChart()
                           .setChartType(Charts.ChartType.BAR)
                           .setDataViewDefinition(viewSpec)
                           .setOption('useFirstColumnAsDomain', true)
                           .setPosition(5, 1, 0, 0)
                           .setOption('hAxis', {title: 'Counts'})
                           .setOption('vAxis', {title: 'Categories'})
                           .addRange(sheet.getRange('A1:C3'));
  sheet.insertChart(chartBuilder.build());
}

Parametreler

Ad	Tür	Açıklama
columns	Object[]	Veri görünümüne dahil edilecek bir sütun dizini veya sütun açıklaması (nesne) dizisi. Sütun açıklamaları, sütun rolünü tanımlar. Veri tablosu ve veri görünümü sütunlarının dizilişi sıfır tabanlı olmalıdır.

Return

DataViewDefinitionBuilder: Zincirleme için yararlı olan bu oluşturucu.