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

אפשר להשתמש ב-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, מתחילים מומלץ לעיין במקורות המידע הבאים: