سازنده برای اشیاء Data View Definition
.
در اینجا مثالی از استفاده از سازنده آورده شده است. دادهها از صفحهگسترده 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; }
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
build() | Data View Definition | شیء تعریف نمای داده را که با استفاده از این سازنده ساخته شده است، می سازد و برمی گرداند. |
set Columns(columns) | Data View Definition Builder | شاخصهای ستونها را برای درج در نمای داده و همچنین مشخص کردن اطلاعات ستونهای نقش تنظیم میکند. |
مستندات دقیق
build()
شیء تعریف نمای داده را که با استفاده از این سازنده ساخته شده است، می سازد و برمی گرداند.
بازگشت
Data View Definition
- یک شیء تعریف نمای داده که با استفاده از این سازنده ساخته شده است.
set Columns(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[] | آرایهای از نمایههای ستون، یا توصیف ستونها (یک شی)، برای گنجاندن در نمای داده. توضیحات ستون نقش ستون را تعریف می کند. جدول داده ها و شمارش ستون های مشاهده داده ها بر اساس صفر است. |
بازگشت
Data View Definition Builder
- این سازنده، برای زنجیرهبندی مفید است.