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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()DataViewDefinitionสร้างและแสดงผลออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้
setColumns(columns)DataViewDefinitionBuilderกำหนดดัชนีของคอลัมน์ที่จะรวมไว้ในมุมมองข้อมูล รวมถึงระบุข้อมูลคอลัมน์บทบาท

เอกสารประกอบโดยละเอียด

build()

สร้างและแสดงผลออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้

รีเทิร์น

DataViewDefinition — ออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้


setColumns(columns)

กำหนดดัชนีของคอลัมน์ที่จะรวมไว้ในมุมมองข้อมูล รวมถึงระบุข้อมูลคอลัมน์บทบาท ชุดย่อยของดัชนีคอลัมน์นี้หมายถึงคอลัมน์ของแหล่งข้อมูลที่มุมมองข้อมูลมาจาก

บทบาทของคอลัมน์จะอธิบายวัตถุประสงค์ของข้อมูลในคอลัมน์นั้น เช่น คอลัมน์หนึ่งๆ อาจเก็บข้อมูลซึ่งอธิบายข้อความเคล็ดลับเครื่องมือ คําอธิบายประกอบจุดข้อมูล หรือตัวบ่งชี้ความไม่แน่นอน โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อบทบาทตารางข้อมูลในเอกสารประกอบของ Google Charts

สมมติว่าสเปรดชีตมีข้อมูลต่อไปนี้ใน A1:C3

'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';
โค้ดต่อไปนี้สร้างแผนภูมิแท่งที่แต่ละแท่งมีสีต่างกัน ระบบจะกำหนดสีผ่าน "คอลัมน์บทบาท" ของสไตล์
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()); }

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnsObject[]อาร์เรย์ของดัชนีคอลัมน์หรือคําอธิบายคอลัมน์ (ออบเจ็กต์) เพื่อรวมไว้ในมุมมองข้อมูล คำอธิบายคอลัมน์จะกำหนดบทบาทของคอลัมน์ ตารางข้อมูลและการแจกแจงสำหรับคอลัมน์มุมมองข้อมูลจะนับจาก 0

รีเทิร์น

DataViewDefinitionBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม