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)

شاخص‌های ستون‌ها را برای درج در نمای داده و همچنین مشخص کردن اطلاعات ستون‌های نقش تنظیم می‌کند. این زیر مجموعه از نمایه های ستونی به ستون های منبع داده ای اشاره دارد که نمای داده از آن مشتق شده است.

نقش ستون هدف داده‌ها را در آن ستون توصیف می‌کند: برای مثال، یک ستون ممکن است داده‌هایی را در خود نگه دارد که متن راهنمای ابزار، حاشیه‌نویسی‌های نقطه داده یا شاخص‌های عدم قطعیت را توصیف می‌کند. برای جزئیات بیشتر، نقش های DataTable را در اسناد Google Charts ببینید.

با فرض یک صفحه گسترده با داده های زیر در 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());
};

پارامترها

نام تایپ کنید توضیحات
columns Object[] آرایه‌ای از نمایه‌های ستون، یا توصیف ستون‌ها (یک شی)، برای گنجاندن در نمای داده. توضیحات ستون نقش ستون را تعریف می کند. جدول داده ها و شمارش ستون های مشاهده داده ها بر اساس صفر است.

بازگشت

DataViewDefinitionBuilder - این سازنده، برای زنجیره‌سازی مفید است.