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());
}

المعلمات

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

الإرجاع

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