Class DataViewDefinitionBuilder

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)

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

يصف دور العمود الغرض من البيانات في هذا العمود: على سبيل المثال، قد يحتوي العمود على بيانات تصف تلميحًا أو تعليقات توضيحية لنقاط البيانات أو مؤشرات عدم اليقين. لمزيد من التفاصيل، يُرجى الاطّلاع على أدوار DataTable في مستندات أدوات الرسم البياني من 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: أداة إنشاء مفيدة للتسلسل