Xrm.WebApi.online.executeMultiple (مرجع واجهة برمجة تطبيقات العميل)

تنفيذ مجموعة من عمليات الإجراء أو الدالة أو CRUD.

إشعار

يتم اعتماد هذا الأسلوب فقط لوضع الاتصال (Xrm.WebApi.online).

إذا كنت ترغب في تنفيذ طلبات متعددة في معاملة، يجب تمرير مجموعة تغيير كمعلمة إلى هذا الأسلوب. تمثل مجموعات التغيير مجموعة من العمليات التي يتم تنفيذها في معاملة. يمكنك أيضا تمرير طلبات فردية وتغيير مجموعات معا كمعلمات إلى هذا الأسلوب.

إشعار

• لا يمكنك تضمين عمليات القراءة (استرداد دالات متعددة واستردادها وواجهة برمجة تطبيقات الويب) كجزء من مجموعة تغيير؛ هذا وفقا لمواصفات OData v4.
• يمكن أن تحتوي الطلبات على ما يصل إلى 1000 طلب فردي ولا يمكن أن تحتوي على دفعات أخرى. مزيد من المعلومات: تنفيذ عمليات الدفعة.

بناء الجملة

تنفيذ طلبات متعددة:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

تنفيذ طلبات متعددة في معاملة:

في هذه الحالة، req1req2يتم تنفيذ و و req3 في معاملة.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

تنفيذ مزيج من الطلبات الفردية والطلبات المتعددة في معاملة:

في هذه الحالة، req1req2يتم تنفيذ و و req3 في المعاملة، ولكن req4 يتم تنفيذ و req5 بشكل فردي.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

المعلمات

الاسم	نوع	مطلوبة	الوصف
requests	مصفوفة الكائنات	‏‏نعم‬	صفيف من أحد الأنواع التالية: الكائنات التي يكون فيها كل كائن عبارة عن إجراء أو دالة أو طلب CRUD تريد تنفيذه مقابل نقطة نهاية واجهة برمجة تطبيقات الويب. يعرض كل كائن أسلوب getMetadata الذي يتيح لك تحديد بيانات التعريف للإجراء أو الدالة أو طلب CRUD الذي تريد تنفيذه. يقبل أسلوب التنفيذ هذا النوع من المعلمات. مجموعة التغيير (صفيف من الكائنات)، حيث يكون كل كائن في مجموعة التغيير كما هو موضح سابقا. في هذه الحالة، يتم تنفيذ كافة كائنات الطلب المحددة في مجموعة التغيير في معاملة. ابحث عن أمثلة الطلب في قسم بناء الجملة.
successCallback	الوظيفة	لا	دالة لاستدعاء عند تنفيذ العملية بنجاح. يتم تمرير صفيف من كائنات الاستجابة إلى الدالة . راجع القيمة المرجعة
errorCallback	الوظيفة	لا	وظيفة للاتصال عند فشل العملية. يتم تمرير كائن بالخصائص التالية: - errorCode:رقم. رمز الخطأ كرقم عشري موجب. على سبيل المثال، رمز الخطأ الموثق كما 0x80040333 سيتم إرجاعه ك 2147746611. - message:خيط. رسالة خطأ تصف المشكلة.

قيمة الإرجاع

عند النجاح، ترجع وعدا يحتوي على صفيف من العناصر إلى successCallback. تحتوي الكائنات على هذه الخصائص:

الاسم	نوع	مطلوبة	الوصف
json	وعد	لا	نص الاستجابة بتنسيق JSON.
text	وعد	لا	نص الاستجابة بتنسيق نص عادي.
headers	كائن	‏‏نعم‬	رؤوس الاستجابة.
ok	قيمة منطقية	‏‏نعم‬	يشير إلى ما إذا كان الطلب ناجحا أم لا.
status	الرقم‬	‏‏نعم‬	قيمة رقمية في رمز حالة الاستجابة. على سبيل المثال: 200
statusText	سلسلة	‏‏نعم‬	وصف رمز حالة الاستجابة. على سبيل المثال: OK
type	سلسلة	‏‏نعم‬	نوع الاستجابة. القيم هي: السلسلة الفارغة (الافتراضية) arraybufferو blobوdocumentjson.text
url	سلسلة	‏‏نعم‬	طلب عنوان URL للإجراء أو الدالة أو طلب CRUD الذي تم إرساله إلى نقطة نهاية واجهة برمجة تطبيقات الويب.

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

Xrm.WebApi