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

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

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

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

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

في ما يلي بعض الإجراءات التي يمكنك تنفيذها باستخدام الإضافات التي توسّع نطاق "جداول بيانات Google":

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

بنية ورقة البيانات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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