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

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

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

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