מדריך למתחילים: פונקציות מותאמות אישית

אתם יכולים להשתמש ב-Google Apps Script כדי לכתוב פונקציה בהתאמה אישית, ואז להשתמש בה ב-Google Sheets בדיוק כמו פונקציה מובנית.

בדוגמה הבאה למדריך למתחילים נוצרת פונקציה מותאמת אישית שמחשבת את מחיר המכירה של פריטים בהנחה. הפורמט של מחיר המבצע הוא דולר ארה"ב.

מטרות

  • מגדירים את הסקריפט.
  • מריצים את הסקריפט.

דרישות מוקדמות

כדי להשתמש בדוגמה הזו, צריך לעמוד בדרישות המוקדמות הבאות:

  • חשבון Google (יכול להיות שחשבונות Google Workspace ידרשו אישור אדמין).
  • דפדפן אינטרנט עם גישה לאינטרנט.

הגדרת הסקריפט

  1. יוצרים גיליון אלקטרוני חדש.
  2. בגיליון האלקטרוני החדש, בוחרים באפשרות בתפריט תוספים > 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, כדאי לעיין במקורות המידע הבאים: