Trình tạo cho các đối tượng DataViewDefinition
.
Dưới đây là ví dụ về cách sử dụng trình tạo. Dữ liệu được nhập trên một bảng tính 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; }
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | DataViewDefinition | Tạo và trả về đối tượng định nghĩa khung hiển thị dữ liệu được tạo bằng trình tạo này. |
setColumns(columns) | DataViewDefinitionBuilder | Đặt chỉ mục của các cột để đưa vào chế độ xem dữ liệu cũng như chỉ định cột vai trò của bạn. |
Tài liệu chi tiết
build()
Tạo và trả về đối tượng định nghĩa khung hiển thị dữ liệu được tạo bằng trình tạo này.
Cầu thủ trả bóng
DataViewDefinition
– Đối tượng định nghĩa khung hiển thị dữ liệu được tạo bằng trình tạo này.
setColumns(columns)
Đặt chỉ mục của các cột để đưa vào chế độ xem dữ liệu cũng như chỉ định cột vai trò của bạn. Tập hợp con gồm các chỉ mục cột này tham chiếu đến các cột của nguồn dữ liệu mà làm tương tự để tạo thành phần hiển thị dữ liệu.
Vai trò trong cột mô tả mục đích của dữ liệu trong cột đó, ví dụ: một cột có thể giữ dữ liệu mô tả văn bản chú thích, chú thích điểm dữ liệu hoặc chỉ báo về độ không chắc chắn. Để biết thêm chi tiết, hãy xem Vai trò của DataTable trong Google Biểu đồ tài liệu.
Giả sử một bảng tính có dữ liệu sau đây ở A1:C3:
"abc", 20, "blue" "def", 30, "red" "ghi", 40, "orange"Mã sau đây sẽ tạo một biểu đồ thanh, trong đó mỗi thanh có một màu khác nhau. Các màu này được gán thông qua một "cột vai trò" kiểu.
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()); };
Tham số
Tên | Loại | Mô tả |
---|---|---|
columns | Object[] | Một mảng các chỉ mục cột hoặc nội dung mô tả cột (một đối tượng) để đưa vào chế độ xem dữ liệu. Nội dung mô tả cột xác định vai trò trong cột. Bảng dữ liệu và giá trị liệt kê cho các cột khung hiển thị dữ liệu đều dựa trên giá trị 0. |
Cầu thủ trả bóng
DataViewDefinitionBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.