تلخيص البيانات من أوراق متعددة

مستوى الترميز: مبتدئ
المدة: 5 دقائق
نوع المشروع: دالة مخصّصة

الأهداف

• فهم دور الحلّ
• فهم ما تفعله خدمات Apps Script ضمن الحلّ
• إعداد النص البرمجي
• شغِّل النص البرمجي.

لمحة عن هذا الحل

إذا كانت لديك بيانات منظَّمة بالطريقة نفسها في أوراق بيانات متعددة في جدول بيانات، مثل مقاييس دعم العملاء لأعضاء الفريق، يمكنك استخدام هذه الدالة المخصّصة لإنشاء ملخّص لكل ورقة بيانات. يركز هذا الحلّ على طلبات العميل المتعلّقة بالدعم، ولكن يمكنك تخصيصه لتلبية احتياجاتك.

آلية العمل

تلخِّص الدالة المخصّصة، التي تُسمى getSheetsData()، البيانات من كل ورقة بيانات في جدول البيانات استنادًا إلى عمود الحالة في ورقة البيانات. يتجاهل النص البرمجي جداول بيانات التي لا يجب تضمينها في التجميع، مثل جدولَي بيانات ReadMe و الملخّص.

خدمات "برمجة تطبيقات Google"

يستخدم هذا الحلّ الخدمة التالية:

• خدمة جداول البيانات: تحصل على الأوراق التي تحتاج إلى التجميع وتحسب عدد العناصر التي تتطابق مع سلسلة محدّدة. بعد ذلك، يضيف النص البرمجي المعلومات المحسوبة إلى نطاق نسبيًا إلى مكان استدعاء الدالة المخصّصة في جدول البيانات.

المتطلبات الأساسية

لاستخدام هذا العيّنة، يجب استيفاء المتطلبات الأساسية التالية:

• حساب Google (قد تحتاج حسابات Google Workspace إلى موافقة المشرف).
• متصفح ويب يمكنه الوصول إلى الإنترنت

إعداد النص البرمجي

انقر على الزرّ أدناه لإنشاء نسخة من جدول بيانات دالة التلخيص المخصّصة لبيانات جدول البيانات. تم إرفاق مشروع "برمجة تطبيقات Google" لهذا الحلّ بجدول البيانات.
إنشاء نسخة

تشغيل النص البرمجي

1. في جدول البيانات المنسوخ، انتقِل إلى ورقة البيانات الملخّص.
2. انقر على الخلية A4. دالة getSheetsData() متوفّرة في هذه الخلية.
3. انتقِل إلى إحدى أوراق بيانات المالك وعدِّل البيانات أو أضِفها إلى الورقة. تشمل بعض الإجراءات التي يمكنك تجربتها ما يلي:
   • أضِف صفًا جديدًا يتضمّن نموذجًا لمعلومات التذاكر.
   • في عمود الحالة، غيِّر حالة طلب دعم حالي.
   • غيِّر موضع عمود الحالة. على سبيل المثال، في جدول المالك1، انقل عمود الحالة من العمود C إلى العمود D.
4. انتقِل إلى ورقة البيانات الملخّص وراجِع جدول الملخّص المعدَّل الذي أنشأه getSheetsData() من الخلية A4. قد تحتاج إلى وضع علامة في مربّع الاختيار في الصف 10 من أجل تحديث النتائج المخزّنة مؤقتًا للوظيفة المخصّصة. تخزِّن Google الدوال المخصّصة لتحسين الأداء.
   • في حال إضافة صفوف أو تعديلها، يعدّل النص البرمجي أعداد الطلبات وحالات العميل.
   • في حال نقل موضع عمود الحالة، سيظل النص البرمجي يعمل على النحو المطلوب باستخدام فهرس العمود الجديد.

مراجعة الرمز

لمراجعة رمز Apps Script لهذا الحلّ، انقر على عرض رمز المصدر أدناه:

عرض رمز المصدر

Code.gs

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

العرض على GitHub

// 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() {
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheets = ss.getSheets();
  let outputArr = [];

  // For each sheet, summarizes the data and pushes to a temporary array.
  for (let s in sheets) {
    // Gets sheet name.
    let sheetNm = sheets[s].getName();
    // Skips ReadMe and Summary sheets.
    if (sheetNm === READ_ME_SHEET_NAME || sheetNm === PM_SHEET_NAME) { continue; }
    // Gets sheets data.
    let values = sheets[s].getDataRange().getValues();
    // Gets the first row of the sheet which is the header row.
    let 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.
    let columnOwner = headerRowValues.indexOf("Owner Name");
    let 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.
    let owner = values[0][columnOwner];
    // Counts the total number of tasks.
    let 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.
    let completeCnt = filterByPosition(values,'Complete', columnStatus).length;
    // Counts the number of tasks that have the 'In-Progress' status.
    let inProgressCnt = filterByPosition(values,'In-Progress', columnStatus).length;
    // Counts the number of tasks that have the 'Scheduled' status.
    let scheduledCnt = filterByPosition(values,'Scheduled', columnStatus).length;
    // Counts the number of tasks that have the 'Overdue' status.
    let 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);
}

التعديلات

يمكنك تعديل الدالة المخصّصة بقدر ما تريد لتلبية احتياجاتك. في ما يلي إضافة اختيارية لإعادة تحميل نتائج الدالة المخصّصة يدويًا.

إعادة تحميل النتائج المخزّنة مؤقتًا

على عكس الدوال المدمَجة، تخزِّن Google الدوال المخصّصة مؤقتًا لتحسين الأداء. وهذا يعني أنّه في حال تغيير أيّ شيء في دالة المخصّصة، مثل قيمة يتم احتسابها، قد لا يؤدي ذلك على الفور إلى فرض إجراء تعديل. لإعادة تحميل نتيجة الدالة يدويًا، اتّبِع الخطوات التالية:

1. أضِف مربّع اختيار إلى خلية فارغة بالنقر على إدراج > مربّع اختيار.
2. أضِف الخلية التي تحتوي على مربّع الاختيار كمَعلمة للدالة المخصّصة، على سبيل المثال، getSheetsData(B11).
3. ضَع علامة في مربّع الاختيار أو أزِلها لإعادة تحميل نتائج الدالة المخصّصة.

المساهمون

تُعدّ Google هذه العينة بمساعدة خبراء Google Developers.

الخطوات التالية

• الدوال المخصّصة في "جداول بيانات Google"
• توسيع نطاق "جداول بيانات Google"