يتم ربط النص البرمجي بملف "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" إذا تم إنشاؤه من ذلك المستند بدلاً من نص برمجي مستقل. يُعرف الملف الذي يرفِق به نص برمجي مرتبط باسم "الحاوية". تعمل النصوص البرمجية المرتبطة عمومًا مثل النصوص البرمجية المستقلة باستثناء أنها لا تظهر في Google Drive، ولا يمكن فصلها عن الملف المرتبط بها، وتكتسب بعض الامتيازات الخاصة على الملف الأصلي.
يُرجى العلم أنّه يمكن ربط النصوص البرمجية أيضًا بخدمة "مواقع Google"، إلا أنّ هذه النصوص البرمجية يتم نشرها دائمًا على أنّها تطبيقات ويب. ويمكن أن تصبح النصوص البرمجية المرتبطة بـ "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" تطبيقات ويب، على الرغم من أنّ هذا الأمر غير شائع.
إنشاء نص برمجي مرتبط
"مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"
لإنشاء نص برمجي مرتبط في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"، افتح مستندًا في "مستندات Google" أو جدول بيانات في "جداول بيانات Google" أو عرضًا تقديميًا في "العروض التقديمية من Google" وانقر على الإضافات > برمجة التطبيقات. لإعادة فتح النص البرمجي في المستقبل، نفِّذ الإجراء نفسه أو افتح النص البرمجي من لوحة بيانات "برمجة تطبيقات Google".
نماذج Google
لإنشاء نص برمجي مرتبط في "نماذج Google"، افتح نموذجًا وانقر على رمز المزيد > محرِّر النص البرمجي. لإعادة فتح النص البرمجي في المستقبل، نفِّذ الإجراء نفسه أو افتح النص البرمجي من لوحة بيانات "برمجة تطبيقات Google".
طرق خاصة
يمكن للنصوص البرمجية المرتبطة استدعاء بعض الطرق التي لا تستطيع النصوص البرمجية المستقلة استدعاءها:
- تتيح
getActiveSpreadsheet()وgetActiveDocument()وgetActivePresentation()وgetActiveForm()للنصوص البرمجية المرتبطة الإشارة إلى الملف الرئيسي بدون الإشارة إلى معرّف الملف. - يتيح
getUiللنصوص البرمجية المرتبطة الوصول إلى واجهة المستخدم لملفها الرئيسي لإضافة قوائم ومربّعات حوار وأشرطة جانبية مخصّصة. - في "جداول بيانات Google" و
getActiveSheet()وgetActiveRange()وgetActiveCell()يمكنك السماح للنص البرمجي بتحديد الورقة الحالية للمستخدم أو النطاق المحدد من الخلايا أو الخلية الفردية التي تم اختيارها.setActiveSheet(sheet)وsetActiveRange(range)دع النص البرمجي يغيّر هذه الاختيارات. - في "مستندات Google"،
getCursor()وgetSelection()دع النص البرمجي يحدّد موضع مؤشر المستخدم أو النص الذي اخترته.setCursor(position)وsetSelection(range)السماح للنص البرمجي بتغيير هذه المواقع
لمزيد من المعلومات، راجِع دليل تمديد "جداول بيانات Google" أو دليل تمديد "مستندات Google".
القوائم ومربعات الحوار والأشرطة الجانبية المخصصة
يمكن للنصوص البرمجية المرتبطة تخصيص "جداول بيانات Google" و"مستندات Google" و"نماذج Google" عن طريق إضافة قوائم مخصّصة ومربّعات حوار أو أشرطة جانبية. ضع في اعتبارك أن النص البرمجي لا يمكنه التفاعل إلا مع واجهة المستخدم في المثيل الحالي لملف مفتوح. بمعنى أن البرنامج النصي المرتبط بأحد المستندات لا يمكن أن يؤثر على واجهة المستخدم لمستند آخر.
الشبكات الإضافية
يتم تشغيل الإضافات في Gmail و"جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google". إذا كنت قد طورت نصًا برمجيًا مرتبطًا أو مستقلاً وأردت مشاركته مع الجميع، تتيح لك "برمجة تطبيقات Google" publish نصك البرمجي كإضافة ليتمكّن المستخدمون الآخرون من تثبيته من متجر الإضافات.
أسباب طلب المساعدة
يمكن للنصوص البرمجية المرتبطة استخدام عوامل تشغيل بسيطة، مثل دالة onOpen() الخاصة التي يتم تشغيلها تلقائيًا عندما يفتح مستخدم لديه الإذن بالتعديل. وكما هي الحال في جميع أنواع النصوص البرمجية، يمكنها أيضًا استخدام
المشغلات القابلة للتثبيت.
الدوال المخصصة
الدالة المخصصة هي دالة في نص برمجي مرتبط بـ "جداول بيانات Google" والتي تستدعيها مباشرةً من خلية باستخدام البنية =myFunctionName(). تشبه الدوال المخصّصة مئات الدوال المضمّنة في "جداول بيانات Google" مثل AVERAGE أو SUM، باستثناء أنّك تحدِّد سلوك الدالة المخصّصة.
الوصول إلى النصوص البرمجية المرتبطة
يمكن فقط للمستخدمين الذين لديهم إذن بتعديل الحاوية تشغيل النص البرمجي المرتبط بها. لا يمكن للمتعاونين الذين لديهم إذن الوصول للعرض فقط فتح محرِّر النصوص البرمجية، على الرغم من أنّهم إذا أنشأوا نسخة من ملف الحاوية، يصبحون مالكين للنسخة ويمكنهم الاطّلاع على نسخة من النص البرمجي وتشغيلها.
للتعرّف على كيفية مشاركة ملف حاوية نص برمجي، يمكنك الاطّلاع على مشاركة الملفات من Google Drive.