أداة إنشاء Data
عنصر
في ما يلي مثال على استخدام أداة الإنشاء. يتم استيراد البيانات من جدول بيانات 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 | تُنشئ هذه الدالة عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام أداة الإنشاء هذه، وتُعيده. |
set | Data | لضبط فهارس الأعمدة المطلوب تضمينها في عرض البيانات، بالإضافة إلى تحديد معلومات عمود الدور |
مستندات تفصيلية
build()
تُنشئ هذه الدالة عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام أداة الإنشاء هذه، وتُعيده.
الإرجاع
Data
: عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام هذا المُنشئ
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
— هذا المُنشئ مفيد لإنشاء سلاسل.