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

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

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

الأهداف

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

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

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

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

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

  1. أنشئ جدول بيانات جديدًا.
  2. من جدول البيانات الجديد، اختَر الإضافات > Apps Script.

  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" باستخدام برمجة التطبيقات، يمكنك الاطّلاع على المراجع التالية: