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.
  var 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.
  var originalChart = Charts.newTableChart()
      .setDimensions(600, 500)
      .setDataSourceUrl(dataSourceUrl)
      .build();

  // Create another chart to display a subset of the data (only columns 1 and 4).
  var dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]);
  var limitedChart = Charts.newTableChart()
      .setDimensions(200, 500)
      .setDataSourceUrl(dataSourceUrl)
      .setDataViewDefinition(dataViewDefinition)
      .build();

  var htmlOutput = HtmlService.createHtmlOutput();
  var originalChartData = Utilities.base64Encode(originalChart.getAs('image/png').getBytes());
  var originalChartUrl = "data:image/png;base64," + encodeURI(originalChartData);
  var limitedChartData = Utilities.base64Encode(limitedChart.getAs('image/png').getBytes());
  var 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"
تنشئ التعليمة البرمجية التالية مخططًا شريطيًا يكون فيه كل شريط بلون مختلف. الألوان هي يتم تعيينه عبر النمط "عمود الدور".
var COLUMN_SPEC = [
  0, // categories
  1, // counts
  {sourceColumn: 2, role: 'style'}
];

function roleColumnChart() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var viewSpec = Charts.newDataViewDefinition()
      .setColumns(COLUMN_SPEC)
      .build();
  var 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 — أداة الإنشاء هذه مفيدة للسلاسل.