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éthode	Type renvoyé	Brève description
build()	DataViewDefinition	Crée et affiche l'objet de définition de vue des données créé à l'aide de ce compilateur.
setColumns(columns)	DataViewDefinitionBuilder	Définit les index des colonnes à inclure dans la vue des données et à spécifier des informations sur les colonnes de rôles.

Documentation détaillée

build()

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

Renvois

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

---

setColumns(columns)

Définit les index des colonnes à inclure dans la vue des données et à spécifier des informations sur les colonnes de rôles. Ce sous-ensemble d'index de colonne fait référence aux colonnes de la source de données dont est dérivée la vue de données.

Un rôle de colonne décrit l'objectif des données qu'elle contient. Par exemple, une colonne peut contenir des données décrivant le texte des info-bulles, les annotations de points de données ou les indicateurs d'incertitude. Pour en savoir plus, consultez la section Rôles DataTable dans la documentation sur les charts Google.

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 a 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

Nom	Type	Description
columns	Object[]	Tableau d'index de colonnes, ou de descriptions de colonnes (un objet), à inclure dans la vue des données. Les descriptions des colonnes définissent un rôle pour la colonne. La table de données et l'énumération des colonnes de la vue de données sont basées sur zéro.

Renvois

DataViewDefinitionBuilder : compilateur utile pour les chaînes.