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

المَعلمات

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

استرجاع الكرة

DataViewDefinitionBuilder: أداة الإنشاء هذه مفيدة للسلاسل