الدالات First، وFirstN، وLast، وLastN

ينطبق على: تطبيقات اللوحة تدفقات سطح المكتب التطبيقات المستندة إلى النموذج Power Pages Power Platform CLI

لإرجاع السجل الأول أو الأخير أو المعين، أو مجموعة من السجلات الأولى أو الأخيرة من جدول.

الوصف

تقوم دالة First بإرجاع السجل الأول في الجدول.

تقوم وظيفة FirstN بإرجاع أول مجموعة من السجلات لجدول؛ تحدد الوسيطة الثانية عدد السجلات المراد إرجاعها.

تقوم وظيفة Last بإرجاع السجل الأخير في الجدول.

تقوم الدالة LastN بإرجاع آخر مجموعة من السجلات لجدول؛ تحدد الوسيطة الثانية عدد السجلات المراد إرجاعها.

تقوم الدالة Index بإرجاع سجل من الجدول بناءً على الوضع المرتب في الجدول. يبدأ رقم السجل من 1 حتى يقوم First( table ) بإرجاع السجل نفسه الذي في Index( table, 1 ). ترجع الدالة الفهرس خطأ إذا كان فهرس السجل المطلوب أقل من 1، أو أكبر من عدد السجلات في الجدول، أو إذا كان الجدول فارغا.

الأول والفهرس والأخير إرجاع سجل واحد. يقوم FirstN وLastN بإرجاع جدول، حتى إذا قمت بتحديد سجل واحد فقط.

تفويض

عند استخدام هذه الوظائف مع مصدر بيانات، لا يمكن تفويضها. سيتم استرداد الجزء الأول من مصدر البيانات وعندئذٍ يتم تطبيق الوظيفة. قد لا تمثل النتيجة القصة الكاملة. ربما يظهر تحذير في وقت التأليف لتذكيرك بهذا التقييد وكذلك لاقتراح التبديل إلى بدائل قابلة للتفاوض، إن أمكن. لمزيد من المعلومات، راجع نظرة عامة على التفويض.

على سبيل المثال، عند الاستخدام مع مصدر بيانات يحتوي على جدول كبير يضم مليون سجلاً، فستكون الدالة Last خاضعة إلى حد عدم التفويض ولن يتم إرجاع السجل الأخير لمصدر البيانات بالكامل. وبالمثل، سينتج عن استخدام الدالة Index لطلب سجل من بين مليون سجل خطأ لأن الفهرس خارج النطاق بناءً على حد عدم التفويض.

بناء الجملة

الأول ( الجدول )
الأخير ( الجدول )

• الجدول - مطلوب. الجدول المُراد العمل عليه.

FirstN ( الجدول [، عدد السجلات ])
LastN ( الجدول [، عدد السجلات ])

• الجدول - مطلوب. الجدول المُراد العمل عليه.
• عدد السجلات - اختياري. عدد السجلات المُراد إرجاعها. إذا لم تحدد هذه الوسيطة، تقوم الوظيفة بإرجاع سجل واحد.

الفهرس ( الجدول ، مؤشر السجلات )

• الجدول - مطلوب. الجدول المُراد العمل عليه.
• سجل الفهرس - مطلوب. فهرس السجل للإرجاع. ويبدأ ترقيم السجل بـ 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 } ) )

الصيغة	الوصف	النتيجة
أولا (آيس كريم)	لإرجاع السجل الأول من آيس كريم.	{ Flavor: "Chocolate", Quantity: 100 }
آخر (آيس كريم)	لإرجاع السجل الأخير من آيس كريم.	{ الطعم: "فستق"، الكمية: 200 }
مؤشر ( آيس كريم ، 3 )	لإرجاع السجل الثالث من آيس كريم.	{ الطعم: "الفراولة"، الكمية: 300 }
فيرست إن (آيس كريم، 2)	لإرجاع جدول يحتوي على أول سجلين من الآيس كريم.
لاست إن (آيس كريم، 2)	لإرجاع جدول يحتوي على آخر سجلين من الآيس كريم.
مؤشر (آيس كريم ، 4). كم	لإرجاع السجل الرابع من الجدول واستخراج عمود "الكمية".	60
مؤشر ( آيس كريم ، 10 )	لإرجاع خطأ نظرًا لأن السجل المطلوب يتجاوز حدود الجدول.	خطأ