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

חל על: אפליקציות Canvas Copilot Studio Desktop זורמות אפליקציות מונחות דגמים פונקציות Power Platform CLI Dataverse Power Pages

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

Description

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

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

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

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

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

First, Indexוהחזר Last רשומה בודדת. FirstN והחזר LastN טבלה, גם אם תציין רשומה בודדת בלבד.

הקצאה

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

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

תחביר

First( טבלה )
Last( טבלה )

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

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

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

Index( Table, RecordIndex )

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

דוגמאות

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

ניתן למקם את הטבלה הזו באוסף עם הנוסחה הזו (הזן את הנוסחה 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	תוצאה
First(קרח) היי, היי.	מחזירה את הרשומה הראשונה של גלידה.	{ Flavor: "Chocolate", Quantity: 100‎ }
Last(קרח) היי, היי.	מחזירה את הרשומה האחרונה של גלידה.	{ טעם: 'פיסטוק', כמות: 200 }
Index(גלידה, 3 )	מחזירה את הרשומה השלישית של גלידה.	{ טעם: 'תות', כמות: 300 }
FirstN( גלידה, 2 )	מחזירה טבלה שמכילה את שתי הרשומות הראשונות של גלידה.
LastN( גלידה, 2 )	מחזירה טבלה שמכילה את שתי הרשומות האחרונות של גלידה.
Index(IceCream, 4). כמות	מחזירה את הרשומה הרביעית של הטבלה, ומחלצת את העמודה Quantity.	60
Index( גלידה, 10 )	מחזירה שגיאה מכיוון שהרשומה המבוקשת נמצאת מעבר לגבולות הטבלה.	שְׁגִיאָה