Class DataViewDefinitionBuilder

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

سازنده برای اشیاء Data View Definition .

در اینجا مثالی از استفاده از سازنده آورده شده است. داده‌ها از صفحه‌گسترده 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.
  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()

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

بازگشت

Data View Definition - یک شیء تعریف نمای داده که با استفاده از این سازنده ساخته شده است.

---

set Columns(columns)

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

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

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

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

کد زیر یک نمودار میله ای ایجاد می کند که در آن هر نوار رنگ متفاوتی دارد. رنگ ها از طریق یک سبک "ستون نقش" اختصاص داده می شوند.

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[]	آرایه‌ای از نمایه‌های ستون، یا توصیف ستون‌ها (یک شی)، برای گنجاندن در نمای داده. توضیحات ستون نقش ستون را تعریف می کند. جدول داده ها و شمارش ستون های مشاهده داده ها بر اساس صفر است.

بازگشت

Data View Definition Builder - این سازنده، برای زنجیره‌بندی مفید است.