استرداد سجلات Multiple

استرداد مجموعة من سجلات الجدول.

متوفر ل

التطبيقات المستندة إلى النموذج والمداخل.

بناء الجملة

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

المعلمات

Name	نوع	مطلوبة	‏‏الوصف
entityLogicalName	سلسلة	‏‏نعم‬	الاسم المنطقي للجدول للسجلات التي تريد استردادها. على سبيل المثال: "الحساب".
خيارات	سلسلة	لا.	خيارات استعلام نظام OData أو استعلام FetchXML لاسترداد بياناتك. يتم دعم خيارات استعلام النظام التالية: $select$top$filter$expand$orderby. لتحديد استعلام FetchXML، استخدم fetchXml العمود لتحديد الاستعلام. ملاحظة: يجب عليك دائما استخدام خيار استعلام النظام $select للحد من الخصائص التي تم إرجاعها لسجل جدول عن طريق تضمين قائمة مفصولة بفواصل بأسماء الخصائص. يعد تقييد الأعمدة التي تستردها من أفضل الممارسات المهمة في الأداء. إذا لم يتم تحديد الخصائص باستخدام $select، إرجاع جميع الخصائص. يمكنك تحديد خيارات الاستعلام بدءا من ?. يمكنك أيضا تحديد خيارات استعلام نظام متعددة باستخدام & لفصل خيارات الاستعلام.
maxPageSize	الرقم	لا.	حدد رقما موجبا يشير إلى عدد سجلات الجدول التي سيتم إرجاعها لكل صفحة. إذا لم تحدد هذه المعلمة، يتم تمرير القيمة الافتراضية ك 5000. إذا كان عدد السجلات التي يتم استردادها أكثر من القيمة المحددة maxPageSize ، nextLink فسيحتوي العمود في كائن الوعد الذي تم إرجاعه على ارتباط لاسترداد المجموعة التالية من الجداول.
successCallback	الدالة	لا.	دالة لاستدعاء عند استرداد سجلات الجدول. يتم تمرير كائن بالأعمدة التالية إلى الدالة : الكيانات: صفيف من كائنات JSON، حيث يمثل كل كائن سجل الجدول المسترد الذي يحتوي على أعمدة وقيمها كأزواج key: value . يتم استرداد معرف سجل الجدول بشكل افتراضي. nextLink: سلسلة. إذا كان عدد السجلات التي يتم استردادها أكثر من القيمة المحددة في المعلمة maxPageSize في الطلب، يقوم هذا العمود بإرجاع عنوان URL لإرجاع المجموعة التالية من السجلات.
errorCallback	الدالة	لا.	وظيفة للاتصال عند فشل العملية.

قيمة الإرجاع

النوع: وعد<باسترداد MultipleResponse>

الوصف: إرجاع RetrieveMultipleResponse وعد يحتوي على صفيف من كائنات JSON التي تحتوي على سجلات الجدول المستردة والمعلمة nextLink مع عنوان URL الذي يشير إلى المجموعة التالية من السجلات في حالة تحديد ترحيل الصفحات (maxPageSize) في الطلب، ويتجاوز عدد السجلات التي تم إرجاعها قيمة الترحيل. يحتوي على المعلمات التالية:

البارامتر	قيمة الإرجاع	‏‏الوصف
الكيانات	Entity[]	صفيف من كائنات JSON، حيث يمثل كل كائن سجل الجدول المسترد الذي يحتوي على أعمدة وقيمها.
NextLink	string	إذا كان عدد السجلات التي يتم استردادها أكثر من القيمة المحددة في المعلمة "maxPageSize" في الطلب، فترجع هذه المعلمة عنوان URL لإرجاع المجموعة التالية من السجلات.

المقالات ذات الصلة

واجهة برمجة تطبيقات الويب
مرجع واجهة برمجة تطبيقات إطار عمل مكون Power Apps
نظرة عامة على إطار عمل مكون Power Apps