التشغيل السريع للدالة المخصّصة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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