Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

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

הנה דוגמה לשימוש ב-builder. הנתונים מיובאים מגיליון אלקטרוני של 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יוצר ומחזיר את אובייקט ההגדרה של תצוגת הנתונים שנוצר באמצעות ה-builder הזה.
setColumns(columns)DataViewDefinitionBuilderמגדיר את האינדקסים של העמודות שייכללו בתצוגת הנתונים, וכן את הגדרת העמודה תפקיד מידע.

מסמכי תיעוד מפורטים

build()

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

חזרה

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

setColumns(columns)

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

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

נניח שיש לכם גיליון אלקטרוני שמכיל את הנתונים הבאים ב-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 – ה-builder הזה, שימושי ליצירת שרשורים.