Class DataSourcePivotTable

ডেটাসোর্সপিভটটেবিল

বিদ্যমান ডেটা সোর্স পিভট টেবিল অ্যাক্সেস এবং পরিবর্তন করুন। নতুন ডেটা সোর্স পিভট টেবিল তৈরি করতে, Range.createDataSourcePivotTable(dataSource) ব্যবহার করুন।

এই ক্লাসটি শুধুমাত্র ডাটাবেসের সাথে সংযুক্ত ডেটার ক্ষেত্রেই ব্যবহার করুন।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Column Group(columnName) Pivot Group নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট কলাম গ্রুপ যোগ করে।
add Filter(columnName, filterCriteria) Pivot Filter নির্দিষ্ট ডেটা সোর্স কলাম এবং নির্দিষ্ট ফিল্টার শর্তাবলির ওপর ভিত্তি করে একটি নতুন ফিল্টার যোগ করে।
add Pivot Value(columnName) Pivot Value কোনো সামারাইজ ফাংশন ছাড়াই নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট ভ্যালু যোগ করে।
add Pivot Value(columnName, summarizeFunction) Pivot Value নির্দিষ্ট সামারাইজ ফাংশন ব্যবহার করে নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট ভ্যালু যোগ করে।
add Row Group(columnName) Pivot Group নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট সারি গ্রুপ যোগ করে।
as Pivot Table() Pivot Table ডেটা সোর্স পিভট টেবিলটিকে একটি সাধারণ পিভট টেবিল অবজেক্ট হিসেবে ফেরত দেয়।
cancel Data Refresh() Data Source Pivot Table এই অবজেক্টের সাথে যুক্ত ডেটা রিফ্রেশটি বর্তমানে চালু থাকলে তা বাতিল করে।
force Refresh Data() Data Source Pivot Table বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে।
get Data Source() Data Source অবজেক্টটি যে ডেটা সোর্সের সাথে লিঙ্ক করা আছে, তা পাওয়া যায়।
get Status() Data Execution Status অবজেক্টটির ডেটা এক্সিকিউশন স্ট্যাটাস পাওয়া যায়।
refresh Data() Data Source Pivot Table অবজেক্টটির ডেটা রিফ্রেশ করে।
wait For Completion(timeoutInSeconds) Data Execution Status বর্তমান কার্য সম্পাদন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করে এবং নির্দিষ্ট সংখ্যক সেকেন্ড পর সময়সীমা শেষ হয়ে যায়।

বিস্তারিত ডকুমেন্টেশন

addColumnGroup(columnName)

নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট কলাম গ্রুপ যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String ডেটা সোর্সের কলামের নাম, যার উপর ভিত্তি করে পিভট গ্রুপটি তৈরি হয়।

ফেরত

PivotGroup — নতুন পিভট গ্রুপ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addFilter(columnName, filterCriteria)

নির্দিষ্ট ডেটা সোর্স কলাম এবং নির্দিষ্ট ফিল্টার শর্তাবলির ওপর ভিত্তি করে একটি নতুন ফিল্টার যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String ডেটা সোর্সের কলামের নাম, যার উপর ভিত্তি করে ফিল্টারটি করা হয়।
filter Criteria Filter Criteria ফিল্টারটি যে মানদণ্ড ব্যবহার করে।

ফেরত

PivotFilter — নতুন ফিল্টার।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(columnName)

কোনো সামারাইজ ফাংশন ছাড়াই নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট ভ্যালু যোগ করে। শুধুমাত্র লুকার মেজারের জন্য প্রযোজ্য।

নিম্নলিখিত কোডটি দেখায় কিভাবে আপনি একটি লুকার মেজারকে পিভট ভ্যালু হিসেবে যোগ করতে পারেন।

// TODO(developer): Replace with your spreadsheet ID which has a Looker data
// source.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

এই পদ্ধতিটি শুধুমাত্র লুকার ডেটা সোর্সের জন্য উপলব্ধ।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String ডেটা সোর্সের কলামের নাম, যার উপর ভিত্তি করে পিভট ভ্যালুটি তৈরি হয়।

ফেরত

PivotValue — নতুন পিভট মান।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(columnName, summarizeFunction)

নির্দিষ্ট সামারাইজ ফাংশন ব্যবহার করে নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট ভ্যালু যোগ করে।

Looker মেজারগুলিতে পিভট ভ্যালু যোগ করতে addPivotValue(columnName) ব্যবহার করুন।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String ডেটা সোর্সের কলামের নাম, যার উপর ভিত্তি করে পিভট ভ্যালুটি তৈরি হয়।
summarize Function Pivot Table Summarize Function পিভট মানটি যে সামারাইজ ফাংশনটি ব্যবহার করে।

ফেরত

PivotValue — নতুন পিভট মান।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addRowGroup(columnName)

নির্দিষ্ট ডেটা সোর্স কলামের উপর ভিত্তি করে একটি নতুন পিভট সারি গ্রুপ যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String ডেটা সোর্সের কলামের নাম, যার উপর ভিত্তি করে পিভট গ্রুপটি তৈরি হয়।

ফেরত

PivotGroup — নতুন পিভট গ্রুপ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

asPivotTable()

ডেটা সোর্স পিভট টেবিলটিকে একটি সাধারণ পিভট টেবিল অবজেক্ট হিসেবে ফেরত দেয়।

ফেরত

PivotTable — পিভট টেবিল।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

cancelDataRefresh()

এই অবজেক্টের সাথে যুক্ত ডেটা রিফ্রেশটি বর্তমানে চালু থাকলে তা বাতিল করে।

এই উদাহরণটি দেখায় কিভাবে একটি ফর্মুলা রিফ্রেশ বাতিল করতে হয়।

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourcePivotTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forceRefreshData()

বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে। আরও বিস্তারিত জানতে refreshData() দেখুন। আপনি যদি এই অবজেক্টের বর্তমানে চলমান কোনো রিফ্রেশ বাতিল করতে চান, তাহলে cancelDataRefresh() দেখুন।

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourcePivotTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSource()

অবজেক্টটি যে ডেটা সোর্সের সাথে লিঙ্ক করা আছে, তা পাওয়া যায়।

ফেরত

DataSource — তথ্যের উৎস।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getStatus()

অবজেক্টটির ডেটা এক্সিকিউশন স্ট্যাটাস পাওয়া যায়।

ফেরত

DataExecutionStatus — ডেটা সম্পাদনের অবস্থা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshData()

অবজেক্টটির ডেটা রিফ্রেশ করে।

বর্তমানে error অবস্থায় থাকলে একটি এক্সেপশন থ্রো করে। স্পেসিফিকেশন আপডেট করতে DataSource#updateSpec() ব্যবহার করুন। ডেটা সোর্সে অপ্রত্যাশিত পরিবর্তন রোধ করতে forceRefreshData() এর পরিবর্তে এই মেথডটি বেশি পছন্দনীয়।

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourcePivotTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

বর্তমান এক্সিকিউশন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করে এবং নির্দিষ্ট সংখ্যক সেকেন্ড পর টাইম আউট হয়ে যায়। টাইম আউট হওয়ার পরেও যদি এক্সিকিউশন সম্পূর্ণ না হয়, তবে একটি এক্সেপশন থ্রো করে, কিন্তু ডেটা এক্সিকিউশন বাতিল করে না।

প্যারামিটার

নাম প্রকার বর্ণনা
timeout In Seconds Integer ডেটা সম্পাদনের জন্য অপেক্ষার সময়, সেকেন্ডে। সর্বোচ্চ সীমা হলো ৩০০ সেকেন্ড।

ফেরত

DataExecutionStatus — ডেটা সম্পাদনের অবস্থা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets