مشاركة عبر


استرداد التسجيل

استرداد سجل جدول.

متوفر ل

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

بناء الجملة

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

المعلمات

الاسم نوع مطلوبة الوصف
entityLogicalName سلسلة ‏‏نعم‬ الاسم المنطقي للجدول للسجل الذي تريد استرداده. على سبيل المثال: "الحساب".
المعرف سلسلة ‏‏نعم‬ GUID لسجل الجدول الذي تريد استرداده.
خيارات سلسلة لا

خيارات استعلام نظام OData ، $select و $expand ، لاسترداد بياناتك.

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

يمكنك تحديد خيارات الاستعلام بدءا من ?. يمكنك أيضا تحديد خيارات استعلام متعددة باستخدام & لفصل خيارات الاستعلام. على سبيل المثال:

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback الوظيفة لا

دالة للاتصال عند استرداد سجل. سيتم تمرير كائن JSON مع الخصائص والقيم المستردة إلى الدالة .

errorCallback الوظيفة لا وظيفة للاتصال عند فشل العملية.

قيمة الإرجاع

النوع: كيان الوعد<>

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