يتم ربط النص البرمجي بملف "جداول بيانات 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" من خلال إضافة قوائم مخصّصة و مربّعات حوار أو أشرطة جانبية. تجدر الإشارة إلى أنّه لا يمكن للنص البرمجي التفاعل إلا مع واجهة المستخدم لملف الإصدار الحالي. بمعنى أن البرنامج النصي المرتبط بأحد المستندات لا يمكن أن يؤثر على واجهة المستخدم لمستند آخر.
الشبكات الإضافية
يتم تشغيل الإضافات داخل Gmail و"جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google". إذا كنت قد طوّرت برنامجًا نصيًا مرتبطًا أو مستقلًا وتريد مشاركته مع الجميع، تتيح لك خدمة Apps Script نشر البرنامج النصي كأحد الإضافات حتى يتمكّن المستخدمون الآخرون من تثبيته من متجر الإضافات.
العوامل التي تؤدي إلى الظهور
يمكن للنصوص البرمجية المرتبطة استخدام عوامل تشغيل بسيطة
مثل الدالة الخاصة onOpen() التي يتم تشغيلها تلقائيًا كلما فتح مستخدم لديه إذن بالوصول إلى التعديل ملفًا. وكما هو الحال مع جميع أنواع النصوص البرمجية، يمكنهم
أيضًا استخدام عوامل التشغيل القابلة للتثبيت.
الدوال المخصّصة
الدالة المخصّصة هي دالة في ملف برمجي مرتبط بخدمة "جداول بيانات Google" يتم استدعاؤها مباشرةً من خلية باستخدام بنية الجملة =myFunctionName(). وبالتالي، تتشابه الدوالّ المخصّصة مع المئات من
الدوالّ المضمّنة في "جداول بيانات Google"، مثل AVERAGE أو
SUM، باستثناء أنّك تحدِّد
سلوك الدالة المخصّصة.
الوصول إلى النصوص البرمجية المرتبطة
لا يمكن تشغيل النص البرمجي المرتبط إلا للمستخدمين الذين لديهم إذن بتعديل الحاوية. لا يمكن للمتعاونين الذين لديهم إذن بالاطّلاع فقط فتح محرِّر النص البرمجي، ولكن إذا أنشأوا نسخة من ملف الحاوية، سيصبحون مالكي النسخة ويمكنهم الاطّلاع على نسخة من النص البرمجي وتشغيلها.
للتعرّف على كيفية مشاركة ملف حاوية نص برمجي، يمكنك الاطّلاع على مشاركة الملفات من Google Drive.