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

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