Builder של אובייקטים מסוג 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. 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 | יוצר ומחזיר את אובייקט ההגדרה של תצוגת הנתונים שנבנה באמצעות כלי הבנייה הזה. |
set | Data | הגדרת האינדקסים של העמודות שייכללו בתצוגת הנתונים, וגם ציון מידע על עמודות של תפקידים. |
תיעוד מפורט
build()
יוצר ומחזיר את אובייקט ההגדרה של תצוגת הנתונים שנבנה באמצעות כלי הבנייה הזה.
חזרה
DataViewDefinition — אובייקט הגדרה של תצוגת נתונים שנבנה באמצעות הכלי הזה.
setColumns(columns)
הגדרת האינדקסים של העמודות שייכללו בתצוגת הנתונים, וגם ציון מידע על עמודות של תפקידים. קבוצת המשנה הזו של אינדקסים של עמודות מתייחסת לעמודות של מקור הנתונים שממנו נגזרת תצוגת הנתונים.
תפקיד העמודה מתאר את מטרת הנתונים בעמודה הזו: לדוגמה, עמודה יכולה להכיל נתונים שמתארים טקסט בהסבר קצר, הערות על נקודות על הגרף או אינדיקטורים של חוסר ודאות. פרטים נוספים זמינים במאמר תפקידים בטבלת נתונים במאמרי העזרה של Google Charts.
נניח שיש גיליון אלקטרוני עם הנתונים הבאים בתאים 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[] | מערך של אינדקסים של עמודות או תיאורים של עמודות (אובייקט) שרוצים לכלול בתצוגת הנתונים. תיאורי העמודות מגדירים את התפקיד של העמודה. הספירה בטבלת הנתונים ובמספור של עמודות תצוגת הנתונים מתחילה מאפס. |
חזרה
DataViewDefinitionBuilder – ה-builder הזה שימושי לשרשור.