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

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

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

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

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

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

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

بنية الورقة

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

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

أسباب طلب المساعدة

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

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

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

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

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

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

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

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

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

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

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

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