Esta página foi traduzida pela API Cloud Translation.

Class DataViewDefinitionBuilder

Builder para objetos DataViewDefinition.

Veja um exemplo de como usar o builder. Os dados são importados usando uma planilha do 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 retorno	Breve descrição
`build()`	`DataViewDefinition`	Cria e retorna o objeto de definição da visualização de dados que foi criado usando este criador.
`setColumns(columns)`	`DataViewDefinitionBuilder`	Define os índices das colunas a serem incluídos na visualização de dados, bem como especificar a coluna de função informações imprecisas ou inadequadas.

Documentação detalhada

`build()`

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

Retornar

DataViewDefinition: um objeto de definição de visualização de dados que foi criado usando esse builder.

`setColumns(columns)`

Define os índices das colunas a serem incluídos na visualização de dados, bem como especificar a coluna de função informações imprecisas ou inadequadas. Esse subconjunto de índices de colunas se refere às colunas da fonte de dados às quais o de origem da visualização de dados.

Um papel de coluna descreve a finalidade dos dados nessa coluna: por exemplo, uma coluna pode manter dados que descrevem textos de dicas, anotações de pontos de dados ou indicadores de incerteza. Para mais detalhes, consulte Funções do DataTable no Google Charts na documentação do Google Cloud.

Supondo 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.

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

Nome	Tipo	Descrição
`columns`	`Object[]`	Uma matriz de índices de coluna ou descrições de coluna (um objeto) para incluir em a visualização de dados. As descrições de coluna definem um papel da coluna. A tabela de dados e o para colunas de visualização de dados se baseia em zero.

Retornar

DataViewDefinitionBuilder: esse builder, útil para encadeamentos.