Xrm.WebApi.online.executeMultiple (क्लाइंट एपीआई संदर्भ)

क्रिया, फ़ंक्शन या CRUD संचालन का एक संग्रह निष्पादित करें।

नोट

यह विधि केवल ऑनलाइन मोड (Xrm.WebApi.online) के लिए समर्थित है।

यदि आप किसी लेन-देन में एक से अधिक अनुरोध निष्पादित करना चाहते हैं, तो आपको इस विधि के पैरामीटर के रूप में सेट किए गए परिवर्तन को पास करना होगा। परिवर्तन सेट उन कार्यों के संग्रह का प्रतिनिधित्व करते हैं जो किसी लेनदेन में निष्पादित होते हैं। आप इस विधि के पैरामीटर के रूप में अलग-अलग अनुरोधों और परिवर्तन सेट को एक साथ पास भी कर सकते हैं।

नोट

  • आप परिवर्तन सेट के भाग के रूप में पठन कार्रवाई (पुनर्प्राप्त करना, एकाधिक पुनर्प्राप्त करना और वेब API फ़ंक्शन) शामिल नहीं कर सकते; यह OData v4 विनिर्देशों के अनुसार है।
  • अनुरोधों में अधिकतम 1,000 व्यक्तिगत अनुरोध हो सकते हैं और इसमें अन्य बैच शामिल नहीं हो सकते हैं। अधिक जानकारी: बैच कार्रवाई निष्पादित करें

सिंटैक्स

एकाधिक अनुरोध निष्पादित करें:

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

लेन-देन में कई अनुरोध निष्पादित करें:

इस मामले में, req1, , req2और req3 एक लेनदेन में निष्पादित किया जाता है।

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

लेन-देन में व्यक्तिगत अनुरोधों और कई अनुरोधों का मिश्रण निष्पादित करें:

इस मामले में, req1, , req2और req3 लेन-देन में निष्पादित किया जाता है, लेकिन req4 और व्यक्तिगत req5 रूप से निष्पादित किया जाता है।

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

पैरामीटर्स

नाम प्रकार आवश्य विवरण
requests वस्तुओं की सरणी हाँ निम्न प्रकारों में से एक की एक सरणी:

ऑब्जेक्ट जहाँ प्रत्येक ऑब्जेक्ट एक क्रिया, फ़ंक्शन या CRUD अनुरोध है जिसे आप वेब API समापन बिंदु के विरुद्ध निष्पादित करना चाहते हैं। प्रत्येक ऑब्जेक्ट एक getMetadata विधि को उजागर करता है जो आपको उस क्रिया, फ़ंक्शन या CRUD अनुरोध के लिए मेटाडेटा निर्धारित करने देता है जिसे आप निष्पादित करना चाहते हैं। निष्पादन विधि इस प्रकार के पैरामीटर को स्वीकार करती है।

परिवर्तन सेट (वस्तुओं की एक सरणी), जहां परिवर्तन सेट में प्रत्येक ऑब्जेक्ट पहले बताए गए अनुसार है। इस स्थिति में, परिवर्तन सेट में निर्दिष्ट सभी अनुरोध ऑब्जेक्ट एक लेनदेन में निष्पादित होते हैं।

सिंटैक्स अनुभाग में अनुरोध उदाहरण खोजें।
successCallback फ़ंक्शन नहीं ऑपरेशन सफलतापूर्वक निष्पादित होने पर कॉल करने के लिए एक फ़ंक्शन. प्रतिक्रिया वस्तुओं की एक सरणी फ़ंक्शन को पारित की जाती है। रिटर्न वैल्यू देखें
errorCallback फ़ंक्शन नहीं ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन। निम्न गुणों के साथ एक ऑब्जेक्ट पास किया जाता है:
- errorCode:संख्या। त्रुटि कोड एक धनात्मक दशमलव संख्या के रूप में। उदाहरण के लिए, के रूप में 0x80040333 प्रलेखित त्रुटि कोड के रूप में 2147746611लौटाया जाएगा।
- message:तार। समस्या का वर्णन करने वाला एक त्रुटि संदेश.

वापसी मान

सफलता पर, वस्तुओं की एक सरणी वाला एक वादा लौटाता है successCallback। वस्तुओं में ये गुण होते हैं:

नाम प्रकार आवश्य विवरण
json प्रतिज्ञा नहीं JSON प्रारूप में प्रतिक्रिया निकाय।
text प्रतिज्ञा नहीं सादे पाठ प्रारूप में प्रतिक्रिया निकाय।
headers वस्तु हाँ प्रतिक्रिया हेडर।
ok बूलियन हाँ इंगित करता है कि अनुरोध सफल रहा या नहीं.
status नंबर हाँ प्रतिसाद स्थिति कोड में संख्यात्मक मान। उदाहरण के लिए: 200
statusText तार हाँ प्रतिक्रिया स्थिति कोड का विवरण। उदाहरण के लिए: OK
type तार हाँ प्रतिक्रिया प्रकार। मान हैं: खाली स्ट्रिंग (डिफ़ॉल्ट), arraybuffer, jsonblobdocumentऔर .text
url तार हाँ वेब API समापन बिंदु पर भेजे गए क्रिया, फ़ंक्शन या CRUD अनुरोध का URL का अनुरोध करें।

एक्सआरएम.वेबएपीआई