إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تعمل تطبيقات Canvas Copilot Studio Desktop على تدفقات التطبيقات المستندة إلى نموذج Power Platform CLI Dataverse لوظائف Power Pages
لإرجاع السجل الأول أو الأخير أو المعين، أو مجموعة من السجلات الأولى أو الأخيرة من جدول.
الوصف
ترجع 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 ] )
- الجدول - مطلوب. الجدول المُراد العمل عليه.
- عدد السجلات - اختياري. عدد السجلات المُراد إرجاعها. إذا لم تحدد هذه الوسيطة، تقوم الوظيفة بإرجاع سجل واحد.
Index( جدول، 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 ) | لإرجاع السجل الأول من آيس كريم. | { نكهة: "الشوكولاتة"، الكمية: 100 } |
| Last( IceCream ) | لإرجاع السجل الأخير من آيس كريم. | { الطعم: "فستق"، الكمية: 200 } |
| Index( IceCream, 3 ) | لإرجاع السجل الثالث من آيس كريم. | { الطعم: "الفراولة"، الكمية: 300 } |
| FirstN( IceCream, 2 ) | لإرجاع جدول يحتوي على أول سجلين من الآيس كريم. |
|
| LastN( IceCream, 2 ) | لإرجاع جدول يحتوي على آخر سجلين من الآيس كريم. |
|
| Index( IceCream، 4 ). كم | لإرجاع السجل الرابع من الجدول واستخراج عمود "الكمية". | 60 |
| Index( IceCream، 10 ) | لإرجاع خطأ نظرًا لأن السجل المطلوب يتجاوز حدود الجدول. | خطأ |