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)
ভূমিকা-কলাম তথ্য নির্দিষ্ট করার পাশাপাশি ডেটা ভিউতে অন্তর্ভুক্ত করার জন্য কলামগুলির সূচী সেট করে। কলাম সূচীগুলির এই উপসেটটি ডেটা উৎসের কলামগুলিকে নির্দেশ করে যেগুলি থেকে ডেটা ভিউ নেওয়া হয়েছে।
একটি কলামের ভূমিকা সেই কলামের ডেটার উদ্দেশ্য বর্ণনা করে: উদাহরণস্বরূপ, একটি কলামে টুলটিপ পাঠ্য, ডেটা পয়েন্ট টীকা, বা অনিশ্চয়তা নির্দেশক বর্ণনাকারী ডেটা থাকতে পারে। আরও বিশদ বিবরণের জন্য, Google চার্ট ডকুমেন্টেশনে ডেটা টেবিলের ভূমিকা দেখুন।
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 — এই নির্মাতা, চেইন করার জন্য উপযোগী।