Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

בנאי ל-DataViewDefinition אובייקטים.

הנה דוגמה לשימוש בכלי. הנתונים מיובאים מגיליון אלקטרוני של 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;
}

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
build()DataViewDefinitionבונה ומחזיר את אובייקט ההגדרה של תצוגת הנתונים, שנוצר באמצעות הכלי הזה.
setColumns(columns)DataViewDefinitionBuilderמגדירה את האינדקסים של העמודות שייכללו בתצוגת הנתונים, וכן ציון פרטים על עמודות תפקידים.

תיעוד מפורט

build()

בונה ומחזיר את אובייקט ההגדרה של תצוגת הנתונים, שנוצר באמצעות הכלי הזה.

החזרות

DataViewDefinition - אובייקט של הגדרת תצוגת נתונים, שנוצר באמצעות הכלי הזה.

setColumns(columns)

מגדירה את האינדקסים של העמודות שייכללו בתצוגת הנתונים, וכן ציון פרטים על עמודות תפקידים. קבוצת המשנה הזו של האינדקסים של העמודות מתייחסת לעמודות של מקור הנתונים שממנו נגזרת תצוגת הנתונים.

תפקיד העמודה מתאר את מטרת הנתונים בעמודה הזו: לדוגמה, בעמודה יכולה להופיע נתונים שמתארים בהסבר קצר טקסט, בהערות של נקודות נתונים או במדדי אי-ודאות. לפרטים נוספים, ראו תפקידים ב-DataTable במסמכי התיעוד של Google Graphs.

בהנחה שגיליון אלקטרוני מכיל את הנתונים הבאים ב-A1:C3: 

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"
הקוד הבא יוצר תרשים עמודות שבו כל עמודה היא בצבע שונה. הצבעים מוקצים באמצעות "עמודת תפקיד" בסגנון. 
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());
};

פרמטרים

שםתיאורהתיאור
columnsObject[]מערך של אינדקסים של עמודות או תיאורי עמודות (אובייקט), שצריך לכלול בתצוגת הנתונים. תיאורי העמודות מגדירים את התפקיד של העמודות. טבלת הנתונים והמספור של העמודות של תצוגת הנתונים מבוססים על אפסים.

החזרות

DataViewDefinitionBuilder – הכלי הזה – שימושי ליצירת שרשורים.