Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Builder per gli oggetti DataViewDefinition.

Ecco un esempio di utilizzo dello strumento di creazione. I dati sono 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.
  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;
}

Metodi

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

Documentazione dettagliata

build()

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

Indietro

DataViewDefinition: un oggetto di definizione della visualizzazione dei dati creato utilizzando questo strumento di creazione.

---

setColumns(columns)

Imposta gli indici delle colonne da includere nella visualizzazione dei dati e specifica le informazioni relative al ruolo e alla colonna. Questo sottoinsieme di indici di colonna si riferisce alle colonne dell'origine dati da cui deriva la visualizzazione dei 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 maggiori dettagli, consulta Ruoli DataTable nella documentazione di Grafici Google.

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

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

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

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

Parametri

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

Indietro

DataViewDefinitionBuilder: questo generatore è utile per il concatenamento.