Se usó la API de Cloud Translation para traducir esta página.

Class DataViewDefinitionBuilder

Es el 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 la vista de datos que se compiló mediante este compilador.
`setColumns(columns)`	`DataViewDefinitionBuilder`	Establece los índices de las columnas que se incluirán en la vista de datos y especifica la información de la columna de función.

Documentación detallada

`build()`

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

Volver

DataViewDefinition: Es un objeto de definición de 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 información de la columna de función. Este subconjunto de índices de columnas se refiere a las columnas de la fuente de datos de la que 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, las anotaciones de datos o los indicadores de incertidumbre. Para obtener más detalles, consulta Funciones de DataTable en la documentación de los gráficos de Google.

Suponiendo que existe 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 estilo &role;

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 columnas (un objeto) para incluir en la vista de datos. Las descripciones de las columnas definen una función de esta. La tabla de datos y la enumeración de las columnas de vista de datos se basan en cero.

Volver

DataViewDefinitionBuilder: Este compilador, útil para encadenar.