Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Compilador para objetos DataViewDefinition.

Este es un ejemplo de cómo usar el 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étodo	Tipo de datos que se muestra	Descripción breve
build()	DataViewDefinition	Compila y muestra el objeto de definición de vista de datos que se compiló con este compilador.
setColumns(columns)	DataViewDefinitionBuilder	Configura los índices de las columnas que se incluirán en la vista de datos y especifica la información de la columna de la función.

Documentación detallada

build()

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

Devolvedor

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

---

setColumns(columns)

Configura los índices de las columnas que se incluirán en la vista de datos y especifica la información de la columna de la función. Este subconjunto de índices de columnas hace referencia a las columnas de la fuente de datos de la que se deriva la vista de datos.

Una función de columna describe el propósito de los datos en esa columna: por ejemplo, una columna puede contener datos que describen el texto de la información sobre la herramienta, anotaciones de puntos de datos o indicadores de incertidumbre. Para obtener más detalles, consulta Funciones de DataTable en la documentación de Google Charts.

Suponer 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 tiene un color diferente. Los colores se asignan a través de una columna de "función" de estilo.

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

Nombre	Tipo	Descripción
columns	Object[]	Un arreglo de índices de columna o descripciones de columna (un objeto) para incluir en la vista de datos. Las descripciones de columna definen un rol de columna. La tabla de datos y la enumeración para las columnas de vista de datos se basan en cero.

Devolvedor

DataViewDefinitionBuilder: Este compilador es útil para el encadenamiento.