Class DataViewDefinitionBuilder

سازنده‌ی تعریف نمایش داده

سازنده برای اشیاء DataViewDefinition .

در اینجا مثالی از استفاده از سازنده آورده شده است. داده‌ها از یک صفحه گسترده گوگل وارد شده‌اند .

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()	Data View Definition	شیء تعریف نمای داده را که با استفاده از این سازنده ساخته شده است، می‌سازد و برمی‌گرداند.
set Columns(columns)	Data View Definition Builder	ایندکس ستون‌ها را برای نمایش در نمای داده و همچنین اطلاعات نقش ستون تعیین می‌کند.

مستندات دقیق

build()

شیء تعریف نمای داده را که با استفاده از این سازنده ساخته شده است، می‌سازد و برمی‌گرداند.

بازگشت

DataViewDefinition — یک شیء تعریف نمای داده که با استفاده از این سازنده ساخته شده است.

---

setColumns(columns)

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

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

با فرض یک صفحه گسترده با داده‌های زیر در A1:C3:

'abc', 20, 'blue';
'def', 30, 'red';
'ghi', 40, 'orange';

کد زیر یک نمودار میله‌ای ایجاد می‌کند که در آن هر میله رنگ متفاوتی دارد. رنگ‌ها از طریق استایل "role column" تعیین می‌شوند.

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

پارامترها

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

بازگشت

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