مستوى الترميز: مبتدئ
المدة: 5 دقائق
نوع المشروع: دالة مخصّصة
الأهداف
- فهم ما يفعله الحلّ.
- فهم ما تفعله خدمات برمجة التطبيقات ضمن الحلّ.
- قم بإعداد النص البرمجي.
- شغِّل النص البرمجي.
لمحة عن هذا الحلّ
إذا كانت لديك بيانات مهيكلة بشكل مشابه على أوراق متعددة في جدول بيانات، مثل مقاييس دعم العملاء لأعضاء الفريق، فيمكنك استخدام هذه الدالة المخصصة لإنشاء ملخص لكل ورقة. يركز هذا الحل على تذاكر دعم العملاء، ولكن يمكنك تخصيصه ليناسب احتياجاتك.
آلية العمل
الدالة المخصصة، المسماة getSheetsData()
، تلخص البيانات من كل ورقة
في جدول البيانات بناءً على عمود الحالة للورقة. يتجاهل النص البرمجي الأوراق التي يجب عدم تضمينها في التجميع، مثل ورقتَي ReadMe وSummary.
خدمات "برمجة تطبيقات Google"
يستخدم هذا الحلّ الخدمة التالية:
- خدمة جدول البيانات - تحصل على الأوراق التي يجب تلخيصها واحتساب عدد العناصر التي تطابق سلسلة محدّدة. بعد ذلك، يضيف النص البرمجي المعلومات المحسوبة إلى نطاق يتعلق بمكان استدعاء الدالة المخصصة في جدول البيانات.
المتطلبات الأساسية
لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:
- حساب على Google (قد تتطلب حسابات Google Workspace موافقة المشرف).
- متصفح ويب يمكنه الوصول إلى الإنترنت.
إعداد النص البرمجي
انقر على الزر أدناه لإنشاء نسخة من جدول البيانات تلخيص بيانات جدول البيانات المخصّصة. تم إرفاق مشروع برمجة التطبيقات لهذا الحل بجدول البيانات.
إنشاء نسخة
تشغيل النص البرمجي
- في جدول البيانات الذي نسخته، انتقِل إلى ورقة الملخّص.
- انقر على الخلية
A4
. الدالةgetSheetsData()
موجودة في هذه الخلية. - انتقِل إلى إحدى أوراق بيانات المالك وعدِّل ورقة البيانات أو أضِف بيانات إليها. إليك بعض
الإجراءات التي يمكنك تجربتها:
- أضِف صفًا جديدًا يحتوي على نموذج معلومات طلب الدعم.
- في عمود الحالة، غيِّر حالة تذكرة حالية.
- غيِّر موضع عمود الحالة. على سبيل المثال، في ورقة Owner1، انقل عمود الحالة من العمود C إلى العمود D.
- انتقِل إلى ورقة الملخّص وراجِع جدول الملخص المعدَّل الذي أنشأه
getSheetsData()
من الخليةA4
. قد تحتاج إلى وضع علامة في مربع الاختيار في الصف 10 من أجل تحديث النتائج المخزنة مؤقتًا للدالة المخصصة. تحتفظ Google مؤقتًا بالوظائف المخصّصة لتحسين الأداء.- إذا أضفت صفوفًا أو عدّلتها، سيحدّث النص البرمجي عدد التذاكر والحالة.
- إذا نقلت موضع عمود الحالة، سيظل النص البرمجي يعمل على النحو المطلوب مع فهرس العمود الجديد.
مراجعة الرمز
لمراجعة رمز برمجة التطبيقات لهذا الحلّ، انقر على عرض رمز المصدر أدناه:
عرض رمز المصدر
Code.gs
التعديلات
يمكنك تعديل الدالة المخصصة بقدر ما ترغب في أن تناسب احتياجاتك. فيما يلي إضافة اختيارية لإعادة تحميل نتائج الدوال المخصصة يدويًا.
إعادة تحميل النتائج المخزّنة مؤقتًا
على عكس الوظائف المضمّنة، تحتفظ Google مؤقتًا بالوظائف المخصّصة لتحسين الأداء. وهذا يعني أنّه في حال تغيير عنصر ضمن الدالة المخصّصة، مثل القيمة التي يتم احتسابها، قد لا يتم فرض تعديل على الفور. لإعادة تحميل نتيجة الدالة يدويًا، اتّبِع الخطوات التالية:
- أضِف مربّع اختيار إلى خلية فارغة بالنقر على إدراج > مربّع اختيار.
- أضِف الخلية التي تحتوي على مربّع الاختيار كمَعلمة للدالة المخصّصة،
على سبيل المثال،
getSheetsData(B11)
. - ضع علامة في مربّع الاختيار أو أزِل العلامة لإعادة تحميل نتائج الدوال المخصّصة.
المساهمون
تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.