שתף באמצעות

הפונקציות First,‏ FirstN,‏ Index,‏ Last ו- LastN

  • מאמר

חל על: אפליקציות קנבס זרימות שולחן עבודה אפליקציות מונחות דגמים Power Pages Power Platform CLI

מחזירות את הרשומה הראשונה, האחרונה או ספציפית, או קבוצה של רשומות ראשונות או אחרונות, מטבלה.

Description

הפונקציה First מחזירה את הרשומה הראשונה בטבלה.

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

הפונקציה Last‎ מחזירה את הרשומה האחרונה בטבלה.

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

הפונקציה Index מחזירה רשומה של טבלה בהתבסס על המיקום הסידורי שלה בטבלה. מספור הרשומות מתחיל ב- 1 כך ש- First( table ) מחזיר את אותה רשומה כמו Index( table, 1 ). אינדקס מחזיר שגיאה אם ​​אינדקס הרשומות המבוקש קטן מ-1, גדול ממספר הרשומות בטבלה, או שהטבלה ריקה.

ראשית, אינדקס ו אחרונה החזר רשומה בודדת. FirstN ו LastN מחזירים טבלה, גם אם אתה מציין רק רשומה בודדת.

הקצאה

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

לדוגמה, בעת שימוש עם מקור נתונים המכיל טבלה גדולה עם מיליון רשומות, הפונקציה ‎Last תהיה כפופה למגבלת אי-הקצאה ולא תחזיר את הרשומה האחרונה של מקור הנתונים כולו. באופן דומה, שימוש בפונקציה ‎Index כדי לבקש רשומה באמצע מיליון רשומות תגרום לשגיאה מכיוון שהאינדקס נמצא מחוץ לטווח בהתבסס על מגבלת אי-ההקצאה.

תחביר

ראשית( טבלה )
אחרון( טבלה )

  • טבלה - חובה. טבלה שיש לפעול בה.

FirstN( טבלה [, NumberOfRecords ] )
LastN( טבלה [, NumberOfRecords ] )

  • טבלה - חובה. טבלה שיש לפעול בה.
  • NumberOfRecords - אופציונלי. מספר הרשומות שיש להחזיר. אם אינך מציין ארגומנט זה, הפונקציה מחזירה רשומה אחת.

אינדקס( טבלה, RecordIndex )

  • טבלה - חובה. טבלה שיש לפעול בה.
  • RecordIndex - נדרש. האינדקס של הרשומה שיש להחזיר. מספור הרשומות מתחיל ב- 1.

דוגמאות

עבור הדוגמאות הבאות, נשתמש במקור הנתונים גלידה, שמכיל את הנתונים בטבלה זו:

דוגמה 'גלידה'.

ניתן למקם את הטבלה הזו באוסף עם הנוסחה הזו (הזן את הנוסחה OnStart עבור פקד לחצן ולחץ על הלחצן):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
נוסחה Description תוצאה
ראשית ( IceCream ) מחזירה את הרשומה הראשונה של גלידה. { Flavor: "Chocolate", Quantity: 100‎ }
אחרון ( IceCream ) מחזירה את הרשומה האחרונה של גלידה. { טעם: 'פיסטוק', כמות: 200 }
אינדקס ( IceCream, 3 ) מחזירה את הרשומה השלישית של גלידה. { טעם: 'תות', כמות: 300 }
FirstN( IceCream, 2) מחזירה טבלה שמכילה את שתי הרשומות הראשונות של גלידה. טבלה שמכילה את הרשומות של 'שוקולד' ו'וניל'
LastN( IceCream, 2) מחזירה טבלה שמכילה את שתי הרשומות האחרונות של גלידה. טבלה שמכילה את הרשומות של 'מנטה', 'שוקולד' ו'פיסטוק'
אינדקס( IceCream, 4 ).כמות מחזירה את הרשומה הרביעית של הטבלה, ומחלצת את העמודה Quantity. 60
אינדקס ( IceCream, 10 ) מחזירה שגיאה מכיוון שהרשומה המבוקשת נמצאת מעבר לגבולות הטבלה. שְׁגִיאָה