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 — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่