توسيع نطاق تطبيق "جداول بيانات Google" باستخدام الإضافات

‫جداول بيانات Google هي حلّ لخدمة جداول البيانات المستندة إلى السحابة الإلكترونية، ويتيح التعاون في الوقت الفعلي وأدوات فعّالة لعرض البيانات ومعالجتها ونشرها.

يمكنك توسيع نطاق "جداول بيانات Google" باستخدام إضافات تُحسِّن سير العمل المخصّص، وتُنشئ اتصالاً بالأنظمة التابعة لجهات خارجية، وتدمج بيانات "جداول بيانات Google" مع تطبيقات Google Workspace الأخرى (مثل "العروض التقديمية من Google").

يمكنك الاطّلاع على إضافات "جداول بيانات Google" التي أنشأها الآخرون على Google Workspace Marketplace.

الإجراءات التي يمكنك اتّخاذها

في ما يلي بعض الإجراءات التي يمكنك تنفيذها باستخدام إضافة تُضيف ميزات جديدة إلى "جداول بيانات Google":

يتم إنشاء إضافات "جداول بيانات Google" باستخدام Apps Script. لمزيد من المعلومات حول كيفية الوصول إلى "جداول بيانات Google" وإدارتها باستخدام Apps Script، يُرجى الاطّلاع على مقالة توسيع نطاق "جداول بيانات Google".

بنية الورقة

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

توفّر خدمة جداول البيانات في Apps Script عدة فئات لتمثيل الهياكل التنظيمية في "جداول بيانات Google" (مثل Sheet و Range). يمكنك استخدام هذه الفئات لقراءة بيانات "جداول بيانات Google" وسلوكها وتعديلها.

العوامل التي تؤدي إلى الظهور

تتيح عوامل التشغيل في Apps Script لمشروع نص برمجي تنفيذ دالة محدّدة عند استيفاء شروط معيّنة، مثل عند فتح جدول بيانات أو عند تثبيت إضافة.

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

الدوال المخصّصة

تتضمّن "جداول بيانات Google" عددًا من الدوالّ المضمّنة مثل SUM وAVERAGE التي يمكن استدعاؤها من داخل خلية في "جداول بيانات Google". يمكن أن تحدِّد إضافات "جداول بيانات Google" وظائف مخصّصة إضافية لتكملة هذه الوظائف المضمّنة. عندما يُثبِّت مستخدم الإضافة، تصبح أيّ دوال مخصّصة محدّدة مضمّنة في الإضافة متاحة على الفور. من الممكن أن تتألف الإضافة من تعريفات الدوال المخصّصة فقط. تتم مشاركة تعريفات الدوال المخصّصة مع الآخرين في المقام الأول عن طريق نشر إضافة تحتوي على التعريفات.

إنشاء دوال مخصّصة إضافية

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

عند إنشاء دوال مخصّصة في إحدى الإضافات، يجب اتّباع الإرشادات العامة للدوالّ المخصّصة:

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

  • عند تسمية الدالة، حاوِل إنشاء اسم فريد، ربما يكون مرتبطًا باسم الإضافة. إذا كانت اثنتان أو أكثر من الإضافات المثبّتة تحدّد دالات مخصّصة بالاسم نفسه، يمكن للمستخدمين استخدام واحدة منها فقط.
  • يجب أن توضّح الإضافة بوضوح الوظائف المخصّصة التي تقدّمها. احرص على تقديم تعليقات JSDoc دقيقة لدوالّك المخصّصة حتى تتمكّن برمجة Apps Script من عرض معلومات الإكمال التلقائي للمستخدم. بالإضافة إلى ذلك، ننصحك بتقديم مستندات إضافية عن الدوالّ المخصّصة في الإضافة نفسها أو في صفحة ويب مخصّصة لدعم الإضافة.
  • تؤدي الدوالّ المخصّصة التي لا تكتمل في أقل من 30 ثانية إلى حدوث خطأ Internal error executing the custom function. يمكنك تقديم تجربة جيدة للمستخدمين من خلال الحد من مقدار المعالجة التي تجريها في دالة مخصّصة. حسِّن الدالة حيثما أمكن.
  • لا يمكن للدوالّ المخصّصة استخدام خدمات Apps Script التي تتطلّب تفويضًا، ويحدث خطأ You do not have permission to call X service في حال محاولة استخدامها. استخدِم فقط الخدمات المسموح بها في الدالة المخصّصة.
  • تؤدي كل دالة مخصّصة في ورقة بيانات إلى طلب منفصل لخوادم Apps Script. إذا حاول أحد المستخدمين استخدام دوالّ مخصّصة في عدد كبير جدًا من الخلايا، قد يتم تنفيذ الدوالّ ببطء. للحدّ من ذلك، احرص على إبقاء وظائفك المخصّصة بسيطة قدر الإمكان. إذا كنت بحاجة إلى الدالة لإجراء معالجة معقدة أو ممتدة، لا تستخدِم دالة مخصّصة، بل قدِّم هذه الوظيفة من خلال تفاعل في أحد عناصر القائمة أو مربّع الحوار أو الشريط الجانبي بدلاً من ذلك.

وحدات الماكرو في "جداول بيانات Google"

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

لا يمكن توزيع وحدات الماكرو في "جداول بيانات Google" مع الإضافات. في حال تضمين تعريف macro في ملف بيان إضافة، لن يكون متاحًا لمستخدمي تلك الإضافة.