البدء السريع للدالة المخصّصة

يمكنك استخدام "برمجة تطبيقات Google" لكتابة دالة مخصّصة، ثم استخدامها في "جداول بيانات Google" تمامًا مثل دالة مضمّنة.

ينشئ نموذج التشغيل السريع التالي دالة مخصّصة تحسب سعر البيع للعناصر المخفَّضة. يتم تنسيق السعر المخفَّض بالدولار الأمريكي.

الأهداف

  • إعداد النص البرمجي
  • شغِّل النص البرمجي.

المتطلبات الأساسية

لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:

  • حساب Google (قد تتطلّب حسابات Google Workspace موافقة المشرف).
  • متصفّح ويب يمكنه الوصول إلى الإنترنت

إعداد النص البرمجي

  1. أنشئ جدول بيانات جديدًا.
  2. من داخل جدول البيانات الجديد، انقر على عنصر القائمة الإضافات > برمجة تطبيقات Google.

  3. احذف أي رمز في أداة تعديل النصوص البرمجية وألصِق الرمز أدناه. بعد ذلك، انقر على "حفظ" رمز الحفظ.

    /**  * Calculates the sale price of a value at a given discount.  * The sale price is formatted as US dollars.  *  * @param {number} input The value to discount.  * @param {number} discount The discount to apply, such as .5 or 50%.  * @return The sale price formatted as USD.  * @customfunction  */ function salePrice(input, discount) {   let price = input - (input * discount);   let dollarUS = Intl.NumberFormat("en-US", {     style: "currency",     currency: "USD", });   return dollarUS.format(price); }

تشغيل النص البرمجي

  1. ارجع إلى جدول البيانات.
  2. في خلية، أدخِل =salePrice(100,.2). تمثّل المَعلمة الأولى السعر الأصلي، وتمثّل المَعلمة الثانية النسبة المئوية للخصم. إذا كنت في موقع جغرافي يستخدم الفواصل العشرية، قد تحتاج إلى إدخال =salePrice(100;0,2) بدلاً من ذلك.

تعرض الصيغة التي تُدخلها في الخلية الدالة في البرنامج النصي الذي أنشأته في القسم السابق. تؤدي الدالة إلى تحديد سعر التخفيض بقيمة $80.00.

الخطوات التالية

لمواصلة التعرّف على كيفية توسيع نطاق "جداول بيانات Google" باستخدام Apps Script، يمكنك الاطّلاع على المراجع التالية: