Class 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.
  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;
}

Methods

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

מסמכים מפורטים

build()

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

חזרה

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

---

setColumns(columns)

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

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

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

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

הקוד הבא יוצר תרשים עמודות שבו כל עמודה היא בצבע שונה. הצבעים מוקצים באמצעות סגנון 'role column'.

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

פרמטרים

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

חזרה

DataViewDefinitionBuilder — ה-builder הזה שימושי לשרשור.