Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Compilador para objetos DataViewDefinition.

Este es un ejemplo de uso del compilador. Los datos se importan desde una hoja de cálculo de 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;
}

Métodos

MétodoTipo de datos que se muestraDescripción breve
build()DataViewDefinitionCompila y muestra el objeto de definición de la vista de datos que se compiló con este compilador.
setColumns(columns)DataViewDefinitionBuilderEstablece los índices de las columnas que se incluirán en la vista de datos y especifica la columna de roles información.

Documentación detallada

build()

Compila y muestra el objeto de definición de la vista de datos que se compiló con este compilador.

Volver

DataViewDefinition: Es un objeto de definición de la vista de datos que se compiló mediante este compilador.

setColumns(columns)

Establece los índices de las columnas que se incluirán en la vista de datos y especifica la columna de roles información. Este subconjunto de índices de columna se refiere a las columnas de la fuente de datos a la que de dónde se deriva la vista de datos.

Un rol de columna describe el propósito de los datos en esa columna: por ejemplo, una columna podría contiene datos que describen texto de información, anotaciones de puntos de datos o indicadores de incertidumbre. Para ver más consulta Roles de DataTable en Gráficos de Google en la documentación de Google Cloud.

Suponiendo una hoja de cálculo con los siguientes datos en A1:C3: 

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"
 El siguiente código crea un gráfico de barras en el que cada barra es de un color diferente. Los colores son se asignan con un estilo “columna de rol”. 
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());
};

Parámetros

NombreTipoDescripción
columnsObject[]Un array de índices de columna, o descripciones de columna (un objeto), para incluir en la vista de datos. Las descripciones de las columnas definen un rol de columna. La tabla de datos y la enumeración para las columnas de la vista de datos se basan en cero.

Volver

DataViewDefinitionBuilder: Este compilador es útil para el encadenamiento.