Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

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 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	Kiểu dữ liệu trả về	Mô tả ngắn
build()	DataViewDefinition	Tạo và trả về đối tượng định nghĩa chế độ xem 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 cần đưa vào chế độ xem dữ liệu cũng như chỉ định thông tin cột-vai trò.

Tài liệu chi tiết

build()

Tạo và trả về đối tượng định nghĩa chế độ xem 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 chế độ xem 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 cần đưa vào chế độ xem dữ liệu cũng như chỉ định thông tin cột-vai trò. Tập hợp con chỉ mục cột này tham chiếu đến các cột của nguồn dữ liệu mà khung hiển thị dữ liệu bắt nguồn từ đó.

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ể lưu giữ dữ liệu mô tả văn bản trong chú giải công cụ, chú thích điểm dữ liệu hoặc các chỉ báo về mức độ không chắc chắn. Để biết thêm chi tiết, hãy xem Vai trò của DataTable trong tài liệu về Google Biểu đồ.

Giả sử một bảng tính với dữ liệu sau trong A1:C3:

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"

Mã sau đây tạo một biểu đồ thanh, trong đó, mỗi thanh có một màu riêng biệt. Màu sắc được chỉ định thông qua "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());
};

Các tham số

Tên	Loại	Nội dung mô tả
columns	Object[]	Một mảng gồm 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ò của cột. Bảng dữ liệu và bảng liệt kê các cột chế độ xem dữ liệu có giá trị là 0.

Cầu thủ trả bóng

DataViewDefinitionBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.