একাধিক পত্রক থেকে ডেটা সংক্ষিপ্ত করুন

কোডিং স্তর : শিক্ষানবিস
সময়কাল : ৫ মিনিট
প্রকল্পের ধরণ : কাস্টম ফাংশন

উদ্দেশ্য

• সমাধানটি কী কাজ করে তা বুঝুন।
• সলিউশনের মধ্যে অ্যাপস স্ক্রিপ্ট সার্ভিসগুলো কী কাজ করে তা বুঝুন।
• স্ক্রিপ্টটি সেট আপ করুন।
• স্ক্রিপ্টটি চালান।

এই সমাধান সম্পর্কে

যদি আপনার একটি স্প্রেডশিটের একাধিক শীটে একই ধরনের কাঠামোযুক্ত ডেটা থাকে, যেমন দলের সদস্যদের জন্য গ্রাহক সহায়তা মেট্রিক্স, তাহলে আপনি প্রতিটি শীটের একটি সারাংশ তৈরি করতে এই কাস্টম ফাংশনটি ব্যবহার করতে পারেন। এই সমাধানটি মূলত গ্রাহক সহায়তা টিকেটের উপর আলোকপাত করে, কিন্তু আপনি আপনার প্রয়োজন অনুযায়ী এটিকে কাস্টমাইজ করতে পারেন।

এটি কীভাবে কাজ করে

getSheetsData() নামক কাস্টম ফাংশনটি একটি শীটের Status কলামের উপর ভিত্তি করে স্প্রেডশীটের প্রতিটি শীটের ডেটার সারসংক্ষেপ তৈরি করে। স্ক্রিপ্টটি সেইসব শীটকে উপেক্ষা করে যেগুলো এই সমষ্টিগত বিশ্লেষণে অন্তর্ভুক্ত হওয়া উচিত নয়, যেমন ReadMe এবং Summary শীট।

অ্যাপস স্ক্রিপ্ট পরিষেবা

এই সমাধানটি নিম্নলিখিত পরিষেবাটি ব্যবহার করে:

• স্প্রেডশিট পরিষেবা – যে শীটগুলোর সারসংক্ষেপ করা প্রয়োজন, সেগুলো খুঁজে বের করে এবং একটি নির্দিষ্ট স্ট্রিংয়ের সাথে মেলে এমন আইটেমের সংখ্যা গণনা করে। তারপর, স্ক্রিপ্টটি স্প্রেডশিটে কাস্টম ফাংশনটি যেখান থেকে কল করা হয়েছিল, তার সাপেক্ষে একটি রেঞ্জে গণনা করা তথ্যগুলো যোগ করে।

পূর্বশর্ত

এই নমুনাটি ব্যবহার করার জন্য আপনার নিম্নলিখিত পূর্বশর্তগুলো প্রয়োজন:

• একটি গুগল অ্যাকাউন্ট (গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য প্রশাসকের অনুমোদনের প্রয়োজন হতে পারে)।
• ইন্টারনেট সংযোগসহ একটি ওয়েব ব্রাউজার।

স্ক্রিপ্ট সেট আপ করুন

Summarize spreadsheet data কাস্টম ফাংশন স্প্রেডশিটটির একটি অনুলিপি তৈরি করতে, নিম্নলিখিত বোতামটিতে ক্লিক করুন:

একটি অনুলিপি তৈরি করুন

এই সলিউশনের অ্যাপস স্ক্রিপ্ট প্রজেক্টটি স্প্রেডশিটের সাথে সংযুক্ত করা হয়েছে।

স্ক্রিপ্টটি চালান

1. আপনার কপি করা স্প্রেডশীটে, সামারি শীটে যান।
2. A4 সেলে ক্লিক করুন। getSheetsData() ফাংশনটি এই সেলে রয়েছে।
3. মালিকের যেকোনো একটি শীটে যান এবং শীটটিতে ডেটা আপডেট বা যোগ করুন। আপনি নিম্নলিখিত পদক্ষেপগুলো চেষ্টা করতে পারেন:
   • নমুনা টিকিটের তথ্যসহ একটি নতুন সারি যোগ করুন।
   • স্ট্যাটাস কলামে, বিদ্যমান টিকিটের স্ট্যাটাস পরিবর্তন করুন।
   • Status কলামটির অবস্থান পরিবর্তন করুন। উদাহরণস্বরূপ, Owner1 শীটে, Status কলামটি C কলাম থেকে D কলামে সরান।
4. সামারি শীটে যান এবং getSheetsData() ফাংশন দ্বারা A4 সেল থেকে তৈরি হওয়া আপডেট করা সামারি টেবিলটি পর্যালোচনা করুন। কাস্টম ফাংশনের ক্যাশ করা ফলাফল রিফ্রেশ করার জন্য আপনাকে ১০ নম্বর সারির চেকবক্সটি চেক করতে হতে পারে। পারফরম্যান্স অপ্টিমাইজ করার জন্য গুগল কাস্টম ফাংশন ক্যাশ করে রাখে।
   • আপনি সারি যোগ বা আপডেট করলে, স্ক্রিপ্টটি টিকেট এবং স্ট্যাটাস সংখ্যা আপডেট করে।
   • আপনি যদি স্ট্যাটাস কলামটির অবস্থান পরিবর্তন করেন, তাহলেও স্ক্রিপ্টটি নতুন কলাম ইনডেক্স অনুযায়ী সঠিকভাবে কাজ করবে।

কোডটি পর্যালোচনা করুন

এই সলিউশনের অ্যাপস স্ক্রিপ্ট কোড পর্যালোচনা করতে, 'ভিউ সোর্স কোড'- এ ক্লিক করুন:

সোর্স কোড দেখুন

কোড.জিএস

solutions/custom-functions/summarize-sheets-data/Code.js

গিটহাবে দেখুন

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/custom-functions/summarize-sheets-data

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Gets summary data from other sheets. The sheets you want to summarize must have columns with headers that match the names of the columns this function summarizes data from.
 *
 * @return {string} Summary data from other sheets.
 * @customfunction
 */

// The following sheets are ignored. Add additional constants for other sheets that should be ignored.
const READ_ME_SHEET_NAME = "ReadMe";
const PM_SHEET_NAME = "Summary";

/**
 * Reads data ranges for each sheet. Filters and counts based on 'Status' columns. To improve performance, the script uses arrays
 * until all summary data is gathered. Then the script writes the summary array starting at the cell of the custom function.
 */
function getSheetsData() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = ss.getSheets();
  const outputArr = [];

  // For each sheet, summarizes the data and pushes to a temporary array.
  for (const s in sheets) {
    // Gets sheet name.
    const sheetNm = sheets[s].getName();
    // Skips ReadMe and Summary sheets.
    if (sheetNm === READ_ME_SHEET_NAME || sheetNm === PM_SHEET_NAME) {
      continue;
    }
    // Gets sheets data.
    const values = sheets[s].getDataRange().getValues();
    // Gets the first row of the sheet which is the header row.
    const headerRowValues = values[0];
    // Finds the columns with the heading names 'Owner Name' and 'Status' and gets the index value of each.
    // Using 'indexOf()' to get the position of each column prevents the script from breaking if the columns change positions in a sheet.
    const columnOwner = headerRowValues.indexOf("Owner Name");
    const columnStatus = headerRowValues.indexOf("Status");
    // Removes header row.
    values.splice(0, 1);
    // Gets the 'Owner Name' column value by retrieving the first data row in the array.
    const owner = values[0][columnOwner];
    // Counts the total number of tasks.
    const taskCnt = values.length;
    // Counts the number of tasks that have the 'Complete' status.
    // If the options you want to count in your spreadsheet differ, update the strings below to match the text of each option.
    // To add more options, copy the line below and update the string to the new text.
    const completeCnt = filterByPosition(
      values,
      "Complete",
      columnStatus,
    ).length;
    // Counts the number of tasks that have the 'In-Progress' status.
    const inProgressCnt = filterByPosition(
      values,
      "In-Progress",
      columnStatus,
    ).length;
    // Counts the number of tasks that have the 'Scheduled' status.
    const scheduledCnt = filterByPosition(
      values,
      "Scheduled",
      columnStatus,
    ).length;
    // Counts the number of tasks that have the 'Overdue' status.
    const overdueCnt = filterByPosition(values, "Overdue", columnStatus).length;
    // Builds the output array.
    outputArr.push([
      owner,
      taskCnt,
      completeCnt,
      inProgressCnt,
      scheduledCnt,
      overdueCnt,
      sheetNm,
    ]);
  }
  // Writes the output array.
  return outputArr;
}

/**
 * Below is a helper function that filters a 2-dimenstional array.
 */
function filterByPosition(array, find, position) {
  return array.filter((innerArray) => innerArray[position] === find);
}

পরিবর্তন

আপনার প্রয়োজন অনুসারে কাস্টম ফাংশনটি আপনি যত খুশি সম্পাদনা করতে পারেন। কাস্টম ফাংশনের ফলাফল ম্যানুয়ালি রিফ্রেশ করার ঐচ্ছিক সুবিধাটি দেখতে, 'রিফ্রেশ ক্যাশড রেজাল্টস'- এ ক্লিক করুন।

ক্যাশ করা ফলাফল রিফ্রেশ করুন

বিল্ট-ইন ফাংশনগুলোর মতো নয়, গুগল পারফরম্যান্স অপ্টিমাইজ করার জন্য কাস্টম ফাংশন ক্যাশ করে রাখে। এর মানে হলো, আপনি যদি আপনার কাস্টম ফাংশনের মধ্যে কোনো কিছু পরিবর্তন করেন, যেমন গণনা করা হচ্ছে এমন কোনো মান, তবে এটি হয়তো সঙ্গে সঙ্গে আপডেটটি কার্যকর করবে না। ফাংশনের ফলাফল ম্যানুয়ালি রিফ্রেশ করতে, নিম্নলিখিত পদক্ষেপগুলো অনুসরণ করুন:

1. Insert > Checkbox-এ ক্লিক করে একটি খালি সেলে চেকবক্স যোগ করুন।
2. কাস্টম ফাংশনের প্যারামিটার হিসেবে চেকবক্সযুক্ত সেলটি যোগ করুন, যেমন, getSheetsData(B11) ।
3. কাস্টম ফাংশনের ফলাফল রিফ্রেশ করতে চেকবক্সটি চেক বা আনচেক করুন।

অবদানকারীরা

এই নমুনাটি গুগল ডেভেলপার বিশেষজ্ঞদের সহায়তায় গুগল দ্বারা রক্ষণাবেক্ষণ করা হয়।

পরবর্তী পদক্ষেপ

• শীটগুলিতে কাস্টম ফাংশন
• বর্ধিত শীট