Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Builder para objetos DataViewDefinition.

Confira um exemplo de uso do builder. Os dados são importados de uma planilha 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.
  const 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.
  const originalChart = Charts.newTableChart()
                            .setDimensions(600, 500)
                            .setDataSourceUrl(dataSourceUrl)
                            .build();

  // Create another chart to display a subset of the data (only columns 1 and
  // 4).
  const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]);
  const limitedChart = Charts.newTableChart()
                           .setDimensions(200, 500)
                           .setDataSourceUrl(dataSourceUrl)
                           .setDataViewDefinition(dataViewDefinition)
                           .build();

  const htmlOutput = HtmlService.createHtmlOutput();
  const originalChartData = Utilities.base64Encode(
      originalChart.getAs('image/png').getBytes(),
  );
  const originalChartUrl =
      `data:image/png;base64,${encodeURI(originalChartData)}`;
  const limitedChartData = Utilities.base64Encode(
      limitedChart.getAs('image/png').getBytes(),
  );
  const 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 retorno	Breve descrição
build()	DataViewDefinition	Cria e retorna o objeto de definição da visualização de dados criado usando este builder.
setColumns(columns)	DataViewDefinitionBuilder	Define os índices das colunas a serem incluídas na visualização de dados e especifica informações de função-coluna.

Documentação detalhada

build()

Cria e retorna o objeto de definição da visualização de dados criado usando este builder.

Retornar

DataViewDefinition: um objeto de definição de visualização de dados criado usando este builder.

---

setColumns(columns)

Define os índices das colunas a serem incluídas na visualização de dados e especifica informações de função-coluna. Esse subconjunto de índices de coluna se refere às colunas da fonte de dados de que a visualização de dados é derivada.

Uma função de coluna descreve a finalidade dos dados nela. Por exemplo, uma coluna pode conter dados que descrevem texto de dica, anotações de ponto de dados ou indicadores de incerteza. Para mais detalhes, consulte Funções do DataTable na documentação do Gráficos Google.

Suponha uma planilha com os seguintes dados em A1:C3:

'abc', 20, 'blue';
'def', 30, 'red';
'ghi', 40, 'orange';

O código a seguir cria um gráfico de barras em que cada barra tem uma cor diferente. As cores são atribuídas por uma "coluna de função" de estilo.

const COLUMN_SPEC = [
  0,  // categories
  1,  // counts
  {sourceColumn: 2, role: 'style'},
];

function roleColumnChart() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getActiveSheet();
  const viewSpec =
      Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build();
  const 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

Nome	Tipo	Descrição
columns	Object[]	Uma matriz de índices de coluna ou descrições de coluna (um objeto) a serem incluídas na visualização de dados. As descrições de coluna definem um papel de coluna. A tabela de dados e a enumeração para colunas de visualização de dados são baseadas em zero.

Retornar

DataViewDefinitionBuilder: esse builder, útil para encadeamento.