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

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

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

الوصف

تقوم دالة 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( الجدول، 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 } ) )

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