Class DataSourceFormula

ডেটা উৎস সূত্র

বিদ্যমান ডেটা সোর্স ফর্মুলাগুলো অ্যাক্সেস ও পরিবর্তন করুন। নতুন ডেটা সোর্স ফর্মুলা তৈরি করতে Range.setFormula(formula) ব্যবহার করুন।

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

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
cancel Data Refresh() Data Source Formula এই অবজেক্টের সাথে যুক্ত ডেটা রিফ্রেশটি বর্তমানে চালু থাকলে তা বাতিল করে।
force Refresh Data() Data Source Formula বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে।
get Anchor Cell() Range যে সেলে এই ডেটা সোর্স ফর্মুলাটি অ্যাঙ্কর করা আছে, সেই Range ফেরত দেয়।
get Data Source() Data Source অবজেক্টটি যে ডেটা সোর্সের সাথে লিঙ্ক করা আছে, তা পাওয়া যায়।
get Display Value() String ডেটা সোর্স ফর্মুলার প্রদর্শিত মান ফেরত দেয়।
get Formula() String এই ডেটা সোর্স ফর্মুলার জন্য সূত্রটি ফেরত দেয়।
get Status() Data Execution Status অবজেক্টটির ডেটা এক্সিকিউশন স্ট্যাটাস পাওয়া যায়।
refresh Data() Data Source Formula অবজেক্টটির ডেটা রিফ্রেশ করে।
set Formula(formula) Data Source Formula ফর্মুলাটি আপডেট করে।
wait For Completion(timeoutInSeconds) Data Execution Status বর্তমান কার্য সম্পাদন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করে এবং নির্দিষ্ট সংখ্যক সেকেন্ড পর সময়সীমা শেষ হয়ে যায়।

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

cancelDataRefresh()

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

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

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

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

ফেরত

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

অনুমোদন

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

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

forceRefreshData()

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

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

ফেরত

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

অনুমোদন

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

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

getAnchorCell()

যে সেলে এই ডেটা সোর্স ফর্মুলাটি অ্যাঙ্কর করা আছে, সেই Range ফেরত দেয়।

ফেরত

Range — নোঙর কোষ।

অনুমোদন

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

  • 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

getDisplayValue()

ডেটা সোর্স ফর্মুলার প্রদর্শিত মান ফেরত দেয়।

ফেরত

String — প্রদর্শিত মান।

অনুমোদন

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

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

getFormula()

এই ডেটা সোর্স ফর্মুলার জন্য সূত্রটি ফেরত দেয়।

ফেরত

String — সূত্রটি।

অনুমোদন

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

  • 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() মেথড ব্যবহার করুন।

ফেরত

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

অনুমোদন

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

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

setFormula(formula)

ফর্মুলাটি আপডেট করে।

প্যারামিটার

নাম প্রকার বর্ণনা
formula String নতুন ফর্মুলা।

ফেরত

DataSourceFormula — ডেটা সোর্স ফর্মুলা, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।

অনুমোদন

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

  • 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