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 - این سازنده، برای زنجیره‌سازی مفید است.