Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

Compilateur pour les objets DataViewDefinition.

Voici un exemple d'utilisation du compilateur. Les données sont importées à partir d'une feuille de calcul 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éthodes

MéthodeType renvoyéBrève description
build()DataViewDefinitionCrée et affiche l'objet de définition de vue de données qui a été créé à l'aide de ce compilateur.
setColumns(columns)DataViewDefinitionBuilderDéfinit les index des colonnes à inclure dans la vue de données et spécifie "role-column". des informations.

Documentation détaillée

build()

Crée et affiche l'objet de définition de vue de données qui a été créé à l'aide de ce compilateur.

Renvois

DataViewDefinition : objet de définition de vue de données créé à l'aide de ce compilateur.

setColumns(columns)

Définit les index des colonnes à inclure dans la vue de données et spécifie "role-column". des informations. Ce sous-ensemble d'index de colonnes fait référence aux colonnes de la source de données dont est issue la vue de données.

Un rôle de colonne décrit l'objectif des données de cette colonne: par exemple, une colonne peut contiennent des données décrivant le texte des info-bulles, des annotations de points de données ou des indicateurs d'incertitude. Pour plus consultez la section Rôles DataTable dans Google Charts dans la documentation Google Cloud.

Prenons l'exemple d'une feuille de calcul avec les données suivantes dans A1:C3: 

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"
 Le code suivant crée un graphique à barres dans lequel chaque barre est d'une couleur différente. Les couleurs sont attribuées via une "colonne de rôle" de style. 
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());
};

Paramètres

NomTypeDescription
columnsObject[]Tableau d'index de colonne, ou de descriptions de colonne (un objet), à inclure dans la vue des données. Les descriptions de colonne définissent un rôle de colonne. Le tableau de données et les pour les colonnes de l'affichage de données sont basées sur zéro.

Renvois

DataViewDefinitionBuilder : compilateur, utile pour les enchaînements.