محاسبه تخفیف قیمت پلکانی

سطح کدنویسی : مبتدی
مدت زمان : 10 دقیقه
نوع پروژه : تابع سفارشی

اهداف

  • درک کنید که راه حل چه کاری انجام می دهد.
  • آنچه را که سرویس های Apps Script در راه حل انجام می دهند، بدانید.
  • اسکریپت را تنظیم کنید
  • اسکریپت را اجرا کنید.

در مورد این راه حل

اگر شما یک سیستم قیمت گذاری طبقه بندی شده برای مشتریان خود ارائه می دهید، این تابع سفارشی محاسبه مقادیر تخفیف برای قیمت های شما را آسان تر می کند.

اگرچه می‌توانید از تابع داخلی SUMPRODUCT برای محاسبه قیمت‌های سطحی استفاده کنید، استفاده از SUMPRODUCT پیچیده‌تر و انعطاف‌پذیرتر از عملکرد سفارشی این راه‌حل است.

تصویری از نمونه قیمت گذاری ردیف

چگونه کار می کند

مدل قیمت گذاری سطحی به این معنی است که بهای تمام شده کالا یا خدمات بر اساس مقدار خریداری شده کاهش می یابد.

به عنوان مثال، تصور کنید دو طبقه دارید، یکی از 0 تا 500 دلار و با 10 درصد تخفیف و دیگری از 501 تا 1000 دلار و با 20 درصد تخفیف. اگر کل قیمتی که برای محاسبه تخفیف نیاز دارید 700 دلار باشد، اسکریپت 500 دلار اول را در 10 درصد و 200 دلار باقیمانده را در 20 درصد ضرب می کند تا در مجموع 90 دلار تخفیف داشته باشد.

برای یک قیمت کل معین، اسکریپت از طریق لایه های مشخص شده در جدول قیمت گذاری ردیف حلقه می زند. برای هر بخشی از قیمت کل که در یک ردیف قرار می گیرد، آن قسمت در مقدار درصد مربوط به ردیف ضرب می شود. نتیجه حاصل جمع محاسبه هر ردیف است.

خدمات اسکریپت برنامه ها

این راه حل از سرویس زیر استفاده می کند:

  • سرویس صفحه گسترده - مقدار داده شده را می گیرد و محاسبه می کند که چه بخشی از ارزش در درصد تخفیف هر ردیف ضرب شود.

پیش نیازها

برای استفاده از این نمونه به پیش نیازهای زیر نیاز دارید:

  • یک حساب Google (حساب‌های Google Workspace ممکن است به تأیید سرپرست نیاز داشته باشند).
  • یک مرورگر وب با دسترسی به اینترنت.

اسکریپت را تنظیم کنید

برای ایجاد یک کپی از صفحه گسترده عملکرد سفارشی Tier pricing روی دکمه زیر کلیک کنید. پروژه Apps Script برای این راه حل به صفحه گسترده پیوست شده است.
یک کپی تهیه کنید

اسکریپت را اجرا کنید

  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;
}

اصلاحات

شما می توانید تابع سفارشی را تا جایی که می خواهید متناسب با نیاز خود ویرایش کنید. در زیر یک افزونه اختیاری برای بازخوانی دستی نتایج عملکرد سفارشی وجود دارد.

نتایج ذخیره شده را بازخوانی کنید

برخلاف توابع داخلی، گوگل توابع سفارشی را برای بهینه سازی عملکرد در حافظه پنهان ذخیره می کند. بنابراین، اگر چیزی را در تابع سفارشی خود تغییر دهید، مانند مقداری که در حال محاسبه است، ممکن است فوراً مجبور به به روز رسانی نشود. برای بازخوانی دستی نتیجه عملکرد، مراحل زیر را انجام دهید:

  1. با کلیک کردن روی Insert > Checkbox یک کادر انتخاب را به یک سلول خالی اضافه کنید.
  2. سلولی را که دارای چک باکس است به عنوان پارامتر اضافی تابع سفارشی اضافه کنید. به عنوان مثال، اگر یک چک باکس به سلول D20 اضافه کنید، تابع tierPrice() در سلول C20 را به =tierPrice(C19,$B$3:$D$6,D20) به روز کنید.
  3. برای بازخوانی نتایج عملکرد سفارشی، کادر انتخاب را علامت بزنید یا علامت آن را بردارید.

مشارکت کنندگان

این نمونه توسط گوگل با کمک کارشناسان توسعه دهنده گوگل نگهداری می شود.

مراحل بعدی