Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

DataViewDefinition nesneleri için derleyici.

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ütun bilgilerini belirtir.

Ayrıntılı belgeler

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ütun bilgilerini belirtir. Sütun dizinlerinin bu 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ü, söz konusu sütundaki verilerin amacını açıklar. Örneğin, bir sütunda ipucu metnini, veri noktası açıklamalarını veya belirsizlik göstergelerini açıklayan veriler bulunabilir. Daha fazla bilgi için Google Charts belgelerindeki DataTable Rolleri bölümüne bakın.

A1:C3 hücrelerinde aşağıdaki verilerin bulunduğu 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 sütun dizinleri veya sütun açıklamaları (bir nesne) dizisi. Sütun açıklamaları, sütun rolünü tanımlar. Veri tablosu ve veri görünümü sütunları için numaralandırma sıfır tabanlıdır.

Return

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