يتم ربط النص البرمجي بملف "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" إذا كان تم إنشاؤه من هذا المستند بدلاً من نص برمجي مستقل. يُطلق على الملف الذي يرتبط به نص برمجي مرتبط اسم "الحاوية". تشبه النصوص البرمجية المرتبطة بشكل عام النصوص البرمجية المستقلة باستثناء أنها لا تظهر في Google Drive، ولا يمكن فصلها عن الملف المرتبطون بها، وسيحصلوا على بعض الامتيازات الخاصة على الملف الأصلي.
لاحظ أنه يمكن ربط النصوص البرمجية أيضًا بمواقع 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"،
getActiveTab()
،getCursor()
وgetSelection()
السماح للنص البرمجي بتحديد علامة التبويب الحالية للمستخدم، وموضع علامة التبويب الخاصة بالمستخدم أو المؤشر، أو النص المحدد.setActiveTab(tabId)
،setCursor(position)
وsetSelection(range)
ودع النص يغير تلك الاختيارات.
لمزيد من المعلومات، يُرجى الاطّلاع على دليل تمديد جداول بيانات Google أو دليل توسيع نطاق عمل "مستندات Google"
القوائم ومربعات الحوار والأشرطة الجانبية المخصصة
يمكن للنصوص البرمجية المرتبطة تخصيص "جداول بيانات Google" و"مستندات Google" و"نماذج Google" من خلال إضافة وقوائم مخصصة مربعات الحوار أو الأشرطة الجانبية ضع في اعتبارك: إلا أن النص البرمجي لا يمكنه التفاعل إلا مع واجهة المستخدم المثيل الحالي لملف مفتوح. أي أن البرنامج النصي مرتبط بمستند واحد لا يمكن أن تؤثر في واجهة المستخدم لمستند آخر.
الشبكات الإضافية
الإضافات التي يتم تشغيلها داخل Gmail و"جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google". إذا كنت قد وضعت حدودًا أو مستقل كتابة النص البرمجي، وترغب في مشاركته مع الآخرين عبر العالم، فإن "برمجة تطبيقات Google" تتيح لك انشر النص البرمجي كـ حتى يتمكن المستخدمون الآخرون من تثبيتها من متجر الإضافات.
أسباب طلب المساعدة
يمكن أن تستخدم النصوص البرمجية المرتبطة عوامل تشغيل بسيطة
مثل دالة onOpen()
الخاصة، التي تعمل تلقائيًا كلما تم تحميل
يتم فتحه من قِبل مستخدم لديه الإذن بتعديل المحتوى. وكما هو الحال مع جميع أنواع النصوص البرمجية، يمكنها
استخدِم أيضًا المشغّلات القابلة للتثبيت.
الدوال المخصصة
الدالة المخصصة هي دالة في
مرتبط بجداول بيانات Google التي تستدعيها مباشرة من خلية باستخدام
البنية =myFunctionName()
. ولذلك تتشابه الدوال المخصصة مع مئات الدوال
الدوال المدمجة في "جداول بيانات Google"
مثل AVERAGE
أو
SUM
باستثناء أنك تحدد
سلوك الدالة المخصصة.
الوصول إلى النصوص البرمجية المرتبطة
يمكن فقط للمستخدمين الذين لديهم إذن بتعديل الحاوية تشغيل النص البرمجي المرتبط بها. لا يمكن للمتعاونين الذين لديهم الإذن بالاطّلاع فقط فتح النص البرمجي. محرِّر، على الرغم من أنّه في حال اصنع نسخة من ملف الحاوية، فإنّه سيصبح مالك النسخة ويتمكن من الاطلاع على نسخة من النص البرمجي وتشغيلها.
للتعرّف على كيفية مشاركة ملف حاوية نص برمجي، يمكنك الاطّلاع على مقالة مشاركة الملفات من Google Drive