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

يمكنك استخدام "برمجة تطبيقات 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.

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

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