عملکرد سفارشی شروع سریع

شما می‌توانید از اسکریپت Google Apps برای نوشتن یک تابع سفارشی استفاده کنید، سپس آن را درست مانند یک تابع داخلی در Google Sheets استفاده کنید.

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

اهداف

  • اسکریپت را تنظیم کنید.
  • اسکریپت را اجرا کنید.

پیش‌نیازها

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

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

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

  1. یک صفحه گسترده جدید ایجاد کنید.
  2. از درون صفحه‌گسترده جدید خود، گزینه منو Extensions > Apps Script را انتخاب کنید.

  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 را نتیجه می‌دهد.

مراحل بعدی

برای ادامه یادگیری نحوه گسترش Sheets با Apps Script، به منابع زیر نگاهی بیندازید: