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 চার্ট ডকুমেন্টেশনে ডেটা টেবিলের ভূমিকা দেখুন।
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 — এই বিল্ডার, চেইনিংয়ের জন্য দরকারী।