احتساب خصم على السعر المتعدد المستويات

مستوى الترميز: مبتدئ
المدة: 10 دقائق
نوع المشروع: دالة مخصّصة

الأهداف

  • فهم ما يفعله الحلّ
  • فهم وظائف خدمات "برمجة تطبيقات Google" ضمن الحل
  • إعداد النص البرمجي
  • شغِّل النص البرمجي.

لمحة عن هذا الحل

إذا كنت تقدّم نظام أسعار متدرّجة لعملائك، تسهّل هذه الدالة المخصّصة احتساب مبالغ الخصم على أسعارك.

على الرغم من إمكانية استخدام الدالة المضمّنة SUMPRODUCT لإجراء عملية حسابية لتسعير متدرّج، إلا أنّ استخدام SUMPRODUCT أكثر تعقيدًا وأقل مرونة من الدالة المخصّصة في هذا الحل.

لقطة شاشة لنموذج الأسعار المتدرّجة

آلية العمل

يعني نموذج الأسعار المتدرّجة أنّ تكلفة السلع أو الخدمات تنخفض استنادًا إلى الكمية التي تم شراؤها.

على سبيل المثال، لنفترض أنّ لديك فئتَين، إحداهما تتراوح بين 0 و500 دولار أمريكي مع خصم بنسبة% 10، والأخرى تتراوح بين 501 و1,000 دولار أمريكي مع خصم بنسبة %20. إذا كان السعر الإجمالي الذي تريد احتساب الخصم له هو 700 دولار أمريكي، يضرب النص البرمجي أول 500 دولار أمريكي في% 10 ويضرب الـ 200 دولار أمريكي المتبقية في %20، ليصبح إجمالي الخصم 90 دولارًا أمريكيًا.

بالنسبة إلى سعر إجمالي معيّن، تتكرّر العملية في النص البرمجي خلال الفئات المحدّدة في جدول أسعار الفئات. بالنسبة إلى كل جزء من السعر الإجمالي يندرج ضمن مستوى معيّن، يتم ضرب هذا الجزء في قيمة النسبة المئوية المرتبطة بالمستوى. والنتيجة هي مجموع العمليات الحسابية لكل فئة.

خدمات "برمجة تطبيقات Google"

يستخدم هذا الحل الخدمة التالية:

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

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

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

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

انقر على الزر أدناه لإنشاء نسخة من جدول بيانات الدالة المخصّصة لتسعير الفئات. مشروع "برمجة تطبيقات Google" الخاص بهذا الحلّ مرفق بجدول البيانات.
إنشاء نسخة

تشغيل النص البرمجي

  1. في جدول البيانات الذي نسخته، يعرض الجدول في الصف 16 مثالاً على عملية حساب السعر لمنتج "البرامج كخدمة" (SaaS).
  2. لحساب مبلغ الخصم، أدخِل في الخلية C20 الصيغة =tierPrice(C19,$B$3:$D$6). يتم تعديل السعر النهائي في الخلية C21. إذا كنت مقيمًا في منطقة تستخدم الفواصل العشرية، قد تحتاج إلى إدخال =tierPrice(C19;$B$3:$D$6) بدلاً من ذلك.

مراجعة الرمز البرمجي

لمراجعة رمز Apps Script الخاص بهذا الحلّ، انقر على عرض رمز المصدر أدناه:

عرض رمز المصدر

Code.gs

solutions/custom-functions/tier-pricing/Code.js
// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/custom-functions/tier-pricing

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Calculates the tiered pricing discount.  
 *  
 * You must provide a value to calculate its discount. The value can be a string or a reference
 * to a cell that contains a string.
 * You must provide a data table range, for example, $B$4:$D$7, that includes the 
 * tier start, end, and percent columns. If your table has headers, don't include
 * the headers in the range.
 * 
 * @param {string} value The value to calculate the discount for, which can be a string or a 
 * reference to a cell that contains a string.
 * @param {string} table The tier table data range using A1 notation.
 * @return number The total discount amount for the value.
 * @customfunction
 *  
 */
function tierPrice(value, table) {
  let total = 0;
  // Creates an array for each row of the table and loops through each array.
  for (let [start, end, percent] of table) {
  // Checks if the value is less than the starting value of the tier. If it is less, the loop stops.
    if (value < start) {
      break;
    }
  // Calculates the portion of the value to be multiplied by the tier's percent value.
    let amount = Math.min(value, end) - start;
  // Multiplies the amount by the tier's percent value and adds the product to the total.
    total += amount * percent;
  }
  return total;
}

التعديلات

يمكنك تعديل الدالة المخصّصة بالقدر الذي تريده لتناسب احتياجاتك. في ما يلي إضافة اختيارية لإعادة تحميل نتائج الدالة المخصّصة يدويًا.

إعادة تحميل النتائج المخزَّنة مؤقتًا

على عكس الدوال المدمَجة، تخزّن Google الدوال المخصّصة مؤقتًا لتحسين الأداء. لذلك، إذا غيّرت شيئًا في دالتك المخصّصة، مثل قيمة يتم احتسابها، قد لا يؤدي ذلك إلى فرض تعديل على الفور. لتحديث نتيجة الدالة يدويًا، اتّبِع الخطوات التالية:

  1. أضِف مربّع اختيار إلى خلية فارغة من خلال النقر على إدراج > مربّع اختيار.
  2. أضِف الخلية التي تحتوي على مربّع الاختيار كمَعلمة إضافية للدالة المخصّصة. على سبيل المثال، إذا أضفت مربّع اختيار إلى الخلية D20، عدِّل الدالة tierPrice() في الخلية C20 إلى =tierPrice(C19,$B$3:$D$6,D20).
  3. ضَع علامة في مربّع الاختيار أو أزِلها لتعديل نتائج الدالة المخصّصة.

المساهمون

تحتفظ Google بهذا النموذج بمساعدة خبراء Google المطوّرين.

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