יצירה והפעלה של פונקציה מותאמת אישית

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

1. כדי ליצור שאילתה ריקה:
   
   בחירת    נתונים ב > Excel לקבלת > ממקורות אחרים >ריקה.
   
   Power Query    לחץ באמצעות לחצן העכבר הימני על מקום ריק בחלונית שאילתות מימין ולאחר מכן בחר שאילתה חדשה >מקורות >שאילתה ריקה.

2. בחלונית שאילתות מימין, לחץ פעמיים על השם ולאחר מכן שנה את שם השאילתה הריקה החדשה ל- HelloWorld.

3. בחר את השאילתה החדשה ולאחר מכן בחר בית > מתקדם עורך.

4. החלף את קוד ההתחלה של התבנית בקוד הבא:

   let
        HelloWorld = () => ("Hello World")
   in
        HelloWorld

5. בחר בצע.

6. שינית את השאילתה HelloWorld לפונקציה מותאמת אישית. שים לב הסמל של הפונקציה מימין.

7. כדי להפעיל את הפונקציה, בחר אותה ולאחר מכן בחר הפעל בתצוגה מקדימה של נתונים.
   
   

8. תוצאות הפונקציה מוצגות בתצוגה מקדימה של נתונים והן מתווספות לחלונית שאילתות כשאילתה עם שם ברירת המחדל , הפונקציה Invoked. ייתכן שתרצה לשנות את השם לשם בעל משמעות רבה יותר, כגון HelloWorldResult.

9. בחר שאילתה זו ולאחר מכן בחר בית> סגור & טען כדי לראות את התוצאות בגליון עבודה.

תוצאות 

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

1. כדי ליצור שאילתה ריקה:
   
   בחירת    נתונים ב > Excel לקבלת > ממקורות אחרים >ריקה.
   
   Power Query    לחץ באמצעות לחצן העכבר הימני על מקום ריק בחלונית שאילתות מימין ולאחר מכן בחר שאילתה חדשה >מקורות >שאילתה ריקה.

2. בחלונית שאילתות מימין, שנה את שם השאילתה הריקה החדשה ל- "MyHex".

3. בחר את השאילתה החדשה ולאחר מכן בחר בית > מתקדם עורך.

4. החלף את קוד ההתחלה של התבנית בקוד הבא:

   let
        MyHex = (parameter1) => Number.ToText(parameter1,"X")
   in
        MyHex

5. בחר בצע.

6. שינית את השאילתה, "MyHex", לפונקציה מותאמת אישית. שים לב הסמל של הפונקציה מימין.

7. כדי להפעיל את הפונקציה, בחר אותה ולאחר מכן, בתצוגה מקדימה של נתונים, הזן מספר בתיבה פרמטר1 ובחר הפעל.

   

8. תוצאות הפונקציה מוצגות בתצוגה מקדימה של נתונים והן מתווספות לחלונית שאילתות כשאילתה עם שם ברירת המחדל, הפונקציה Invoked. ייתכן שתרצה לשנות את השם לשם בעל משמעות רבה יותר, כגון "MyHexResult".

9. בחר שאילתה זו ולאחר מכן בחר בית> סגור & טען כדי לראות את התוצאות בגליון עבודה.

תוצאות 

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

1. כדי לפתוח שאילתה, אתר שאילתה שנטען בעבר עורך Power Query, בחר תא בנתונים ולאחר מכן בחר שאילתה > ערוך. לקבלת מידע נוסף, ראה יצירה, עריכה וטעינה של שאילתה ב- Excel (Power Query).
   
   הערה    עבור דוגמה זו, לשאילתה שלך דרושה לפחות עמודה אחת מסוג הנתונים 'מספר שלם'.

2. צור את הפונקציה המותאמת אישית "MyHex" כפי שמוסבר בסעיף, צור והפעל פונקציה מותאמת אישית הכוללת פרמטר עם ההגדרה מתקדם עורך.

3. בשאילתה, בחר הוסף עמודה >פונקציה מותאמת אישית. תיבת הדו-שיח הפעלת פונקציה מותאמת אישית מופיעה.

4. הזן את שם העמודה החדשה, כגון "HexConvert", בתיבה שם עמודה חדשה.

5. בחר את השם של פונקציה מותאמת אישית מוגדרת מראש מהרשימה הנפתחת שאילתת פונקציה. בדוגמה זו, בחר "MyHex".

6. מאחר שהפונקציה המותאמת אישית מפנה לפרמטר, הפרמטר מוצג כעת.

7. בחר עמודה מסוג הנתונים 'מספר שלם ' כפרמטר עבור הפונקציה.
   
   

8. בחר אישור.

Result

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