Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Builder per DataViewDefinition oggetti.

Ecco un esempio di utilizzo dello strumento per la creazione. I dati vengono importati da un foglio di lavoro 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;
}

Metodi

Metodo	Tipo restituito	Breve descrizione
build()	DataViewDefinition	Crea e restituisce l'oggetto di definizione della visualizzazione dati creato utilizzando questo builder.
setColumns(columns)	DataViewDefinitionBuilder	Imposta gli indici delle colonne da includere nella visualizzazione dati e specifica le informazioni sulla colonna ruolo.

Documentazione dettagliata

build()

Crea e restituisce l'oggetto di definizione della visualizzazione dati creato utilizzando questo builder.

Ritorni

DataViewDefinition: un oggetto di definizione della visualizzazione dati creato utilizzando questo builder.

---

setColumns(columns)

Imposta gli indici delle colonne da includere nella visualizzazione dati e specifica le informazioni sulla colonna ruolo. Questo sottoinsieme di indici di colonna fa riferimento alle colonne dell'origine dati da cui deriva la visualizzazione dati.

Un ruolo della colonna descrive lo scopo dei dati in quella colonna: ad esempio, una colonna potrebbe contenere dati che descrivono il testo della descrizione comando, le annotazioni dei punti dati o gli indicatori di incertezza. Per ulteriori dettagli, consulta Ruoli DataTable nella documentazione dei grafici Google.

Supponendo un foglio di lavoro con i seguenti dati in A1:C3:

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"

Il codice seguente crea un grafico a barre in cui ogni barra è di un colore diverso. I colori vengono assegnati tramite una "colonna del ruolo" di stile.

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());
};

Parametri

Nome	Tipo	Descrizione
columns	Object[]	Un array di indici di colonne o descrizioni di colonne (un oggetto) da includere nella visualizzazione dati. Le descrizioni delle colonne definiscono un ruolo della colonna. La tabella di dati e l'enumerazione delle colonne della visualizzazione dati sono in base zero.

Ritorni

DataViewDefinitionBuilder: questo builder, utile per il concatenamento.