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

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

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

الأهداف

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

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

لاستخدام هذا النموذج، ستحتاج إلى المتطلّبات الأساسية التالية:

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

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

  1. أنشئ جدول بيانات جديدًا.
  2. من داخل جدول البيانات الجديد، اختر عنصر القائمة الإضافات > برمجة التطبيقات.
  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.

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

لمواصلة تعلم كيفية توسيع نطاق جداول البيانات باستخدام برمجة التطبيقات، ألقِ نظرة على الموارد التالية: