Class DataViewDefinitionBuilder

أداةإنشاءتعريفاتالبيانات

أداة إنشاء 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;
}

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()DataViewDefinitionتُنشئ هذه الدالة عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام أداة الإنشاء هذه، وتُعيده.
setColumns(columns)DataViewDefinitionBuilderلضبط فهارس الأعمدة المطلوب تضمينها في عرض البيانات، بالإضافة إلى تحديد معلومات عمود الدور

مستندات تفصيلية

build()

تُنشئ هذه الدالة عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام أداة الإنشاء هذه، وتُعيده.

الإرجاع

DataViewDefinition: عنصر تعريف عرض البيانات الذي تم إنشاؤه باستخدام هذا المُنشئ


setColumns(columns)

لضبط فهارس الأعمدة المطلوب تضمينها في عرض البيانات، بالإضافة إلى تحديد معلومات عمود الدور تشير هذه المجموعة الفرعية من فهارس الأعمدة إلى أعمدة مصدر البيانات الذي يتم اشتقاق عرض البيانات منه.

يصف دور العمود الغرض من البيانات في ذلك العمود: على سبيل المثال، قد يحتوي العمود على بيانات تصف نص التلميح أو التعليقات التوضيحية لنقاط البيانات أو مؤشرات عدم اليقين. لمزيد من التفاصيل، يُرجى الاطّلاع على أدوارجدول البيانات في مستندات "رسومات Google".

لنفترض أنّ لديك جدول بيانات يتضمّن البيانات التالية في 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());
}

المعلَمات

الاسمالنوعالوصف
columnsObject[]مصفوفة من فهارس الأعمدة أو أوصاف الأعمدة (كائن) لتضمينها في عرض البيانات تحدِّد أوصاف الأعمدة دور العمود. يستند كلّ من جدول البيانات وجدول التعداد لأعمدة عرض البيانات إلى القيمة صفر.

الإرجاع

DataViewDefinitionBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.