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