Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

DataViewDefinition ऑब्जेक्ट के लिए बिल्डर.

यहां बिल्डर का इस्तेमाल करने का एक उदाहरण दिया गया है. डेटा को Google स्प्रेडशीट से इंपोर्ट किया जाता है.

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;
}

माटिंग में इस्तेमाल हुए तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
build()DataViewDefinitionइस बिल्डर का इस्तेमाल करके बनाया गया, डेटा व्यू की परिभाषा का ऑब्जेक्ट बनाता और दिखाता है.
setColumns(columns)DataViewDefinitionBuilderडेटा व्यू में शामिल करने के साथ-साथ भूमिका-कॉलम की जानकारी देने के लिए, कॉलम के इंडेक्स सेट करता है.

ज़्यादा जानकारी वाले दस्तावेज़

build()

इस बिल्डर का इस्तेमाल करके बनाया गया, डेटा व्यू की परिभाषा का ऑब्जेक्ट बनाता और दिखाता है.

रिटर्न टिकट

DataViewDefinition — डेटा व्यू की जानकारी देने वाला ऑब्जेक्ट, जिसे इस बिल्डर का इस्तेमाल करके बनाया गया था.


setColumns(columns)

डेटा व्यू में शामिल करने के साथ-साथ भूमिका-कॉलम की जानकारी देने के लिए, कॉलम के इंडेक्स सेट करता है. कॉलम के इंडेक्स का यह सबसेट, उस डेटा सोर्स के कॉलम के बारे में बताता है जो डेटा व्यू से लिया गया है.

कॉलम की भूमिका से उस कॉलम में मौजूद डेटा के मकसद का पता चलता है: उदाहरण के लिए, हो सकता है कि एक कॉलम में टूलटिप टेक्स्ट, डेटा पॉइंट एनोटेशन या अनिश्चितता से जुड़े डेटा की जानकारी देने वाला डेटा हो. ज़्यादा जानकारी के लिए, Google चार्ट दस्तावेज़ में डेटाटेबल की भूमिकाएं देखें.

A1:C3 में, नीचे दिए गए डेटा वाली स्प्रेडशीट मानकर:

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"
नीचे दिया गया कोड एक बार चार्ट बनाता है जहां हर बार एक अलग रंग होता है. रंग, स्टाइल और कोट कॉलम के ज़रिए असाइन किए जाते हैं.
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());
};

पैरामीटर

नामटाइपब्यौरा
columnsObject[]डेटा व्यू में शामिल करने के लिए, कॉलम इंडेक्स की कैटगरी या कॉलम की जानकारी (ऑब्जेक्ट). कॉलम की जानकारी से कॉलम की भूमिका का पता चलता है. डेटा टेबल और डेटा व्यू के कॉलम की गिनती शून्य-आधारित होती है.

रिटर्न टिकट

DataViewDefinitionBuilder — यह बिल्डर, चेन बनाने के लिए काम का है.