เครื่องมือสร้างสำหรับวัตถุ 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()); };
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columns | Object[] | อาร์เรย์ของดัชนีคอลัมน์หรือคำอธิบายคอลัมน์ (ออบเจ็กต์) ที่จะรวม มุมมองข้อมูล คำอธิบายคอลัมน์จะกำหนดบทบาทของคอลัมน์ ตารางข้อมูลและองค์ประกอบ การแจกแจงสำหรับคอลัมน์มุมมองข้อมูลจะเป็นแบบฐานศูนย์ |
รีเทิร์น
DataViewDefinitionBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่