ה-builder של אובייקטים מסוג Data
.
דוגמה לשימוש ב-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() | Data | ה-builder הזה יוצר ומחזיר את אובייקט ההגדרה של תצוגת הנתונים שנוצר באמצעות ה-builder הזה. |
set | Data | הגדרת האינדקסים של העמודות שרוצים לכלול בתצוגת הנתונים, וכן ציון פרטי העמודות של התפקידים. |
מסמכים מפורטים
build()
ה-builder הזה יוצר ומחזיר את אובייקט ההגדרה של תצוגת הנתונים שנוצר באמצעות ה-builder הזה.
חזרה
Data
– אובייקט של הגדרת תצוגת נתונים שנוצר באמצעות ה-builder הזה.
set Columns(columns)
הגדרת האינדקסים של העמודות שרוצים לכלול בתצוגת הנתונים, וכן ציון פרטי העמודות של התפקידים. קבוצת המשנה הזו של אינדקסי עמודות מתייחסת לעמודות של מקור הנתונים שממנו נגזרת תצוגת הנתונים.
תפקיד העמודה מתאר את מטרת הנתונים בעמודה הזו: לדוגמה, עמודה עשויה להכיל נתונים שמתארים טקסט של הסבר קצר, הערות לגבי נקודות נתונים או אינדיקטורים של אי-ודאות. למידע נוסף, ראו תפקידים של טבלת נתונים
נניח שיש גיליון אלקטרוני עם הנתונים הבאים ב-A1:C3:
'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';
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[] | מערך של אינדקסים של עמודות או תיאורי עמודות (אובייקט) שרוצים לכלול בתצוגת הנתונים. תיאורי העמודות מגדירים את תפקיד העמודה. טבלת הנתונים והמספרה של העמודות בתצוגת הנתונים מבוססות על אפס. |
חזרה
Data
— ה-builder הזה שימושי לשרשור.