Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

DataViewDefinition nesne için oluşturucu.

Oluşturucu kullanımına ilişkin bir örneği burada 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.
  var 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.
  var originalChart = Charts.newTableChart()
      .setDimensions(600, 500)
      .setDataSourceUrl(dataSourceUrl)
      .build();

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

  var htmlOutput = HtmlService.createHtmlOutput();
  var originalChartData = Utilities.base64Encode(originalChart.getAs('image/png').getBytes());
  var originalChartUrl = "data:image/png;base64," + encodeURI(originalChartData);
  var limitedChartData = Utilities.base64Encode(limitedChart.getAs('image/png').getBytes());
  var 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ütun dizinlerini ayarlamanın yanı sıra 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 derleyici kullanılarak oluşturulmuş bir veri görünümü tanımı nesnesi.

---

setColumns(columns)

Veri görünümüne dahil edilecek sütun dizinlerini ayarlamanın yanı sıra rol-sütun bilgilerini belirtir. Sütun dizinlerinin bu alt grubu, veri görünümünün türetildiği veri kaynağı sütunlarını ifade eder.

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

A1:C3 içinde aşağıdaki verilere sahip bir elektronik tablonun olduğunu varsayarsak:

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"

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

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

function roleColumnChart() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var viewSpec = Charts.newDataViewDefinition()
      .setColumns(COLUMN_SPEC)
      .build();
  var 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 eklenecek sütun dizinlerinden oluşan bir dizi veya sütun açıklamaları (nesne). Sütun açıklamaları bir sütun rolü tanımlar. Veri tablosu ve veri görünümü sütunlarının sıralaması sıfır tabanlıdır.

Return

DataViewDefinitionBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.