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

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

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

الأهداف

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

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

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

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

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

  1. إنشاء عنوان جديد جدول بيانات Google.
  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.

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

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